summaryrefslogtreecommitdiff
path: root/man
Commit message (Collapse)AuthorAgeFilesLines
...
* man: add missing _iorig suffixZdenek Kabelac2021-04-231-0/+1
|
* man: document fsadm -l optionZdenek Kabelac2021-04-231-2/+9
| | | | | | | Missed -l option in man page, although users should prefer lvresize -r when the also want to do a volume management, as there they can specify i.e. extents for allocation. Also mention dm-crypt support in command description.
* make: generateZdenek Kabelac2021-04-1945-12063/+4733
|
* man: replace empty linesZdenek Kabelac2021-04-1954-223/+256
|
* man: typography for raid and reportZdenek Kabelac2021-04-192-1259/+1252
| | | | Some enhancements for better man page rendering.
* man: typography fixesZdenek Kabelac2021-04-1921-264/+314
| | | | | | | | Correcting some usage of Bold and Italics (files). Adding some missing SEE ALSO. Fixing missed replaceable paths that are configurable. Be careful about .P in .TP sections - need to use .sp for space line. Use .UR/.UE for URL references.
* man: with internal build install cache, thin, vdoZdenek Kabelac2021-04-191-2/+20
| | | | | Do not install .7 man pages when building --without internal segtype support for types: cache, thin, vdo.
* man: use editline referenceZdenek Kabelac2021-04-192-6/+16
| | | | | When compiled with editline, refer this in man page as well instead of readline.
* makefiles: generate only needed textZdenek Kabelac2021-04-191-6/+8
| | | | | Avoid storing see_also & _end parts in generated doc, since these we can easily 'cat' while making man pages.
* makefiles: improved hyphenation replacementZdenek Kabelac2021-04-191-32/+48
| | | | | | | | Sed replacements script missed to properly replace several '-' to '\-'. Replace it with simpler set of regexes. Also add new target 'make checksed' for testing with examples, where the replacement should or should not occure for easier testing.
* man: typographyZdenek Kabelac2021-04-1422-2063/+1972
| | | | | | | | | | | | | | | | | | | | | | | | | | | With to use .TP where it's easy and doesn't change layout (since .HP is marked as deprecated) - but .TP is not always perfetc match. Avoid submitting empty lines to troff and replace them mostly with .P and use '.' at line start to preserve 'visual' presence of empty line while editing man page manually when there is no extra space needed. Fix some markup. Add some missing SEE ALSO section. Drop some white-space at end-of-lines. Improve hyphenation logic so we do not split options. Use '.IP numbers' only with first one the row (others in row automatically derive this value) Use automatic enumeration for .SH titles. Guidelines in-use: https://man7.org/linux/man-pages/man7/groff.7.html https://www.gnu.org/software/groff/manual/html_node/Man-usage.html https://www.gnu.org/software/groff/manual/html_node/Lists-in-ms.html
* makefiles: fix replacing path for LVM_PATHZdenek Kabelac2021-04-141-1/+1
| | | | Man pages were generated with incorrect LVM_PATH.
* make: generateZdenek Kabelac2021-04-1245-1468/+1468
| | | | Oops, previous generate was not correct.
* make: generateZdenek Kabelac2021-04-1245-5644/+5823
|
* man: hyphenation improvementsZdenek Kabelac2021-04-122-17/+43
|
* man: use commas in SEE ALSOZdenek Kabelac2021-04-123-121/+123
| | | | | Add ',' between each ref. Use left alignment and no hyphenation.
* makefiles: no need for double QZdenek Kabelac2021-04-121-2/+2
| | | | We already use $(Q) while calling macros
* all: fix typosSamanta Navarro2021-03-3018-33/+33
|
* man: show config options with commentsZdenek Kabelac2021-03-301-2/+2
|
* man: describe profile support lvmcache.7Zdenek Kabelac2021-03-301-48/+112
| | | | | | Add missing description for profile usage with cache pool. List cache-pools as first option for dm-cache as it provides better performance and more functionality over cachevols.
* man: writecache missed for --typeZdenek Kabelac2021-03-304-10/+10
| | | | Add missing writecache type into man pages.
* make: generateZdenek Kabelac2021-03-193-3/+939
| | | | Add new lvmdevices.8_pregen and vgimportdevices.8_pregen.
* man: lvmlockd use of lvmlockctl_kill_commandDavid Teigland2021-03-171-24/+65
|
* man: Fix wording in lvmthin(7)Marian Csontos2021-03-051-2/+2
|
* lvmlockctl: use lvm.conf lvmlockctl_kill_commandDavid Teigland2021-03-031-5/+9
| | | | which specifies a command to run by lvmlockctl --kill.
* make: generateZdenek Kabelac2021-03-0243-0/+1286
|
* makefiles: better loggingZdenek Kabelac2021-03-021-2/+4
| | | | | Show only filename instead of full path name when building in builddir != srcdir
* makefiles: simplify and cleanupZdenek Kabelac2021-03-021-31/+15
| | | | | Print all installed man pages with INSTALL Simplify distclean handling.
* device usage based on devices fileDavid Teigland2021-02-237-1/+82
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The LVM devices file lists devices that lvm can use. The default file is /etc/lvm/devices/system.devices, and the lvmdevices(8) command is used to add or remove device entries. If the file does not exist, or if lvm.conf includes use_devicesfile=0, then lvm will not use a devices file. When the devices file is in use, the regex filter is not used, and the filter settings in lvm.conf or on the command line are ignored. LVM records devices in the devices file using hardware-specific IDs, such as the WWID, and attempts to use subsystem-specific IDs for virtual device types. These device IDs are also written in the VG metadata. When no hardware or virtual ID is available, lvm falls back using the unstable device name as the device ID. When devnames are used, lvm performs extra scanning to find devices if their devname changes, e.g. after reboot. When proper device IDs are used, an lvm command will not look at devices outside the devices file, but when devnames are used as a fallback, lvm will scan devices outside the devices file to locate PVs on renamed devices. A config setting search_for_devnames can be used to control the scanning for renamed devname entries. Related to the devices file, the new command option --devices <devnames> allows a list of devices to be specified for the command to use, overriding the devices file. The listed devices act as a sort of devices file in terms of limiting which devices lvm will see and use. Devices that are not listed will appear to be missing to the lvm command. Multiple devices files can be kept in /etc/lvm/devices, which allows lvm to be used with different sets of devices, e.g. system devices do not need to be exposed to a specific application, and the application can use lvm on its own set of devices that are not exposed to the system. The option --devicesfile <filename> is used to select the devices file to use with the command. Without the option set, the default system devices file is used. Setting --devicesfile "" causes lvm to not use a devices file. An existing, empty devices file means lvm will see no devices. The new command vgimportdevices adds PVs from a VG to the devices file and updates the VG metadata to include the device IDs. vgimportdevices -a will import all VGs into the system devices file. LVM commands run by dmeventd not use a devices file by default, and will look at all devices on the system. A devices file can be created for dmeventd (/etc/lvm/devices/dmeventd.devices) If this file exists, lvm commands run by dmeventd will use it. Internal implementaion: - device_ids_read - read the devices file . add struct dev_use (du) to cmd->use_devices for each devices file entry - dev_cache_scan - get /dev entries . add struct device (dev) to dev_cache for each device on the system - device_ids_match - match devices file entries to /dev entries . match each du on cmd->use_devices to a dev in dev_cache, using device ID . on match, set du->dev, dev->id, dev->flags MATCHED_USE_ID - label_scan - read lvm headers and metadata from devices . filters are applied, those that do not need data from the device . filter-deviceid skips devs without MATCHED_USE_ID, i.e. skips /dev entries that are not listed in the devices file . read lvm label from dev . filters are applied, those that use data from the device . read lvm metadata from dev . add info/vginfo structs for PVs/VGs (info is "lvmcache") - device_ids_find_renamed_devs - handle devices with unstable devname ID where devname changed . this step only needed when devs do not have proper device IDs, and their dev names change, e.g. after reboot sdb becomes sdc. . detect incorrect match because PVID in the devices file entry does not match the PVID found when the device was read above . undo incorrect match between du and dev above . search system devices for new location of PVID . update devices file with new devnames for PVIDs on renamed devices . label_scan the renamed devs - continue with command processing
* make: generateZdenek Kabelac2021-02-171-0/+45
|
* man: vdo drop resize restriction commentZdenek Kabelac2021-02-171-5/+0
| | | | lvm2 supports resize of cached vdo pool volumes.
* thin: improve 16g support for thin pool metadataZdenek Kabelac2021-02-011-1/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Initial support for thin-pool used slightly smaller max size 15.81GiB for thin-pool metadata. However the real limit later settled at 15.88GiB (difference is ~64MiB - 16448 4K blocks). lvm2 could not simply increase the size as it has been using hard cropping of the loaded metadata device to avoid warnings printing warning of kernel when the size was bigger (i.e. due to bigger extent_size). This patch adds the new lvm.conf configurable setting: allocation/thin_pool_crop_metadata which defaults to 0 -> no crop of metadata beyond 15.81GiB. Only user with these sizes of metadata will be affected. Without cropping lvm2 now limits metadata allocation size to 15.88GiB. Any space beyond is currently not used by thin-pool target. Even if i.e. bigger LV is used for metadata via lvconvert, or allocated bigger because of to large extent size. With cropping enabled (=1) lvm2 preserves the old limitation 15.81GiB and should allow to work in the evironement with older lvm2 tools (i.e. older distribution). Thin-pool metadata with size bigger then 15.81G is now using CROP_METADATA flag within lvm2 metadata, so older lvm2 recognizes an incompatible thin-pool and cannot activate such pool! Users should use uncropped version as it is not suffering from various issues between thin_repair results and allocated metadata LV as thin_repair limit is 15.88GiB Users should use cropping only when really needed! Patch also better handles resize of thin-pool metadata and prevents resize beoyond usable size 15.88GiB. Resize beyond 15.81GiB automatically switches pool to no-crop version. Even with existing bigger thin-pool metadata command 'lvextend -l+1 vg/pool_tmeta' does the change. Patch gives better controls 'coverted' metadata LV and reports less confusing message during conversion. Patch set also moves the code for updating min/max into pool_manip.c for better sharing with cache_pool code.
* man: update lvmthinZdenek Kabelac2021-02-011-12/+25
| | | | | Add few more notes about thin-pool repair. Fix couple typos.
* make: generateMarian Csontos2021-01-181-0/+4
|
* man: update lvmvdoZdenek Kabelac2020-12-081-11/+12
| | | | | Fix vdo example. Update some sentences.
* man lvmcache: add writecache cleaner infoDavid Teigland2020-12-021-0/+10
|
* man: update writing style of the lvmvdo man pageMarek Suchánek2020-12-021-103/+102
| | | | | | | This patch improves the clarity, writing style, and language of the lvmvdo(7) man page. See https://bugzilla.redhat.com/show_bug.cgi?id=1855804.
* build: make generateMarian Csontos2020-11-261-3/+4
|
* man: vgsplit source and destination VGsDavid Teigland2020-11-171-3/+4
| | | | make clearer which is source and which is destination
* man: update vdoZdenek Kabelac2020-11-031-87/+88
| | | | | | | | | | | Enhance VDO man page with description of memory usage and space requirements chapter. Remove some unneeded blank lines in man page. Use more precise terminology. Correct examples since cpool and vpool are protected names.
* man: regenerateZdenek Kabelac2020-10-2443-129/+86
|
* make: generateMarian Csontos2020-10-151-0/+8
|
* man: correcting vdo issuesZdenek Kabelac2020-09-091-5/+6
| | | | | Fixing reported bugs within provided examples - so examples can be used via cut&paste.
* man: correctly use configured directoriesZdenek Kabelac2020-09-093-6/+6
|
* man: vdo improvalsZdenek Kabelac2020-08-191-15/+39
| | | | | Add some more notes about discard. Correct enumeration.
* build: make generateMarian Csontos2020-08-091-2/+2
|
* make: make generateZdenek Kabelac2020-06-244-19/+298
| | | | update
* man: update cache pageZdenek Kabelac2020-06-241-4/+51
| | | | Few more sentences around migration threshold.
* man: lvmcache info about cachedevice usageDavid Teigland2020-06-221-2/+28
|
* writecache: show error in lv_health_status and lv_attrDavid Teigland2020-06-101-0/+4
| | | | | lv_attr is 'E' and lv_health_status is 'error' when dm-writecache status reports error.