diff options
Diffstat (limited to 'misc-utils/lsblk.8')
-rw-r--r-- | misc-utils/lsblk.8 | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/misc-utils/lsblk.8 b/misc-utils/lsblk.8 index 708381448..2787569fe 100644 --- a/misc-utils/lsblk.8 +++ b/misc-utils/lsblk.8 @@ -51,17 +51,23 @@ Print the SIZE column in bytes rather than in a human-readable format. .BR \-D , " \-\-discard" Print information about the discarding capabilities (TRIM, UNMAP) for each device. .TP -.BR \-z , " \-\-zoned" -Print the zone model for each device. -.TP .BR \-d , " \-\-nodeps" Do not print holder devices or slaves. For example, \fBlsblk --nodeps /dev/sda\fR prints information about the sda device only. .TP +.BR \-E , " \-\-dedup " \fIcolumn\fP +Use \fIcolumn\fP as a de-duplication key to de-duplicate output tree. If the +key is not available for the device, or the device is a partition and parental +whole-disk device provides the same key than the device is always printed. + +The usual use case is to de-duplicate output on system multi-path devices, for +example by \fB\-E WWN\fR. +.TP .BR \-e , " \-\-exclude " \fIlist\fP Exclude the devices specified by the comma-separated \fIlist\fR of major device numbers. Note that RAM disks (major=1) are excluded by default if \fB\-\-all\fR is no specified. -The filter is applied to the top-level devices only. +The filter is applied to the top-level devices only. This maybe be confusing for +\fB\-\-list\fR output format where hierarchy of the devices is not obvious. .TP .BR \-f , " \-\-fs" Output info about filesystems. This option is equivalent to @@ -75,7 +81,8 @@ Display help text and exit. .TP .BR \-I , " \-\-include " \fIlist\fP Include devices specified by the comma-separated \fIlist\fR of major device numbers. -The filter is applied to the top-level devices only. +The filter is applied to the top-level devices only. This maybe be confusing for +\fB\-\-list\fR output format where hierarchy of the devices is not obvious. .TP .BR \-i , " \-\-ascii" Use ASCII characters for tree formatting. @@ -84,7 +91,13 @@ Use ASCII characters for tree formatting. Use JSON output format. .TP .BR \-l , " \-\-list" -Produce output in the form of a list. +Produce output in the form of a list. The output does not provide information +about relationships between devices and since version 2.34 every device is +printed only once. +.TP +.BR \-M , " \-\-merge" +Group parents of sub-trees to provide more readable output for RAIDs and +Multi-path devices. The tree-like output is required. .TP .BR \-m , " \-\-perms" Output info about device owner, group and mode. This option is equivalent to @@ -134,6 +147,15 @@ Display version information and exit. Sort output lines by \fIcolumn\fP. This option enables \fB\-\-list\fR output format by default. It is possible to use the option \fI\-\-tree\fP to force tree-like output and than the tree branches are sorted by the \fIcolumn\fP. +.TP +.BR \-z , " \-\-zoned" +Print the zone model for each device. +.TP +.BR " \-\-sysroot " \fIdirectory\fP +Gather data for a Linux instance other than the instance from which the lsblk +command is issued. The specified directory is the system root of the Linux +instance to be inspected. This option is designed for the testing purpose. + .SH NOTES For partitions, some information (e.g. queue attributes) is inherited from the parent device. |