+++ /dev/null
-.\" -*- nroff -*-
-.TH LSBLK 8 "April 2010" "util-linux" "System Administration"
-.SH NAME
-lsblk \- list block devices
-.SH SYNOPSIS
-.B lsblk
-.RB [ options ]
-.sp
-.B lsblk
-.RB [ options ]
-.IR device...
-.SH DESCRIPTION
-.B lsblk
-lists information about all or the specified block devices. The
-.B lsblk
-command reads the
-.I sysfs
-filesystem to gather information.
-.PP
-The command prints all block devices (except RAM disks) in a tree-like format
-by default. Use
-.B "lsblk --help"
-to get a list of all available columns.
-.PP
-The default output as well as default output from options like --topology and
---fs is subject to change, so whenever possible you should avoid using default
-outputs in your scripts. Always explicitly define expected columns by
-.B \-\-output
-.IR columns
-in environment where a stable output is required.
-.SH OPTIONS
-.IP "\fB\-a, \-\-all\fP"
-.B lsblk
-does not list empty devices by default. This option disables this restriction.
-.IP "\fB\-b, \-\-bytes\fP"
-Print the SIZE column in bytes rather than in human-readable format.
-.IP "\fB\-d, \-\-nodeps\fP"
-Don't print device holders or slaves. For example "lsblk --nodeps /dev/sda" prints
-information about the sda device only.
-.IP "\fB\-D, \-\-discard\fP"
-Print information about the discard (TRIM, UNMAP) capabilities for each device.
-.IP "\fB\-e, \-\-exclude \fIlist\fP
-Exclude the devices specified by a comma-separated \fIlist\fR of major device numbers.
-Note that RAM disks (major=1) are excluded by default. The filter is applied to the top-level
-devices only.
-.IP "\fB\-I, \-\-include \fIlist\fP
-Include devices specified by a comma-separated \fIlist\fR of major device numbers only.
-The filter is applied to the top-level devices.
-.IP "\fB\-f, \-\-fs\fP
-Output info about filesystems. This option is equivalent to "-o NAME,FSTYPE,LABEL,MOUNTPOINT".
-The authoritative information about filesystems and raids is provided by the
-.BR blkid (8)
-command.
-.IP "\fB\-h, \-\-help\fP"
-Print a help text and exit.
-.IP "\fB\-i, \-\-ascii\fP"
-Use ASCII characters for tree formatting.
-.IP "\fB\-m, \-\-perms\fP
-Output info about device owner, group and mode. This option is equivalent to "-o NAME,SIZE,OWNER,GROUP,MODE".
-.IP "\fB\-l, \-\-list\fP"
-Use the list output format.
-.IP "\fB\-n, \-\-noheadings\fP"
-Do not print a header line.
-.IP "\fB\-o, \-\-output \fIlist\fP"
-Specify which output columns to print. Use
-.B "--help"
-to get a list of all supported columns.
-.IP "\fB\-P, \-\-pairs\fP"
-Use key="value" output format. All potentially unsafe characters are hex-escaped (\\x<code>).
-.IP "\fB\-r, \-\-raw\fP"
-Use the raw output format. All potentially unsafe characters are hex-escaped
-(\\x<code>) in NAME, KNAME, LABEL, PARTLABEL and MOUNTPOINT columns.
-.IP "\fB\-s, \-\-inverse\fP"
-Print dependencies in inverse order.
-.IP "\fB\-t, \-\-topology\fP"
-Output info about block device topology.
-This option is equivalent to "-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,WSAME".
-.IP "\fB\-S, \-\-scsi\fP"
-Output info about SCSI devices only. All partitions, slaves and holders devices are ignored.
-.IP "\fB\-V, \-\-version\fP"
-Output version information and exit.
-.SH NOTES
-For partitions, some information (e.g. queue attributes) is inherited from the
-parent device.
-
-.PP
-The
-.B lsblk
-needs to be able to lookup sysfs path by major:minor, which is done
-done by using
-.BR /sys/dev/block .
-The block sysfs appeared in kernel 2.6.27 (October 2008). In case of
-problem with new enough kernel check that CONFIG_SYSFS was enabled at
-the time of kernel build.
-.SH AUTHORS
-.nf
-Milan Broz <mbroz@redhat.com>
-Karel Zak <kzak@redhat.com>
-.fi
-.SH ENVIRONMENT
-.IP LIBMOUNT_DEBUG=0xffff
-enables debug output.
-.SH SEE ALSO
-.BR findmnt (8),
-.BR blkid (8),
-.BR ls (1)
-.SH AVAILABILITY
-The lsblk command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
projects / thirdparty / util-linux.git / blobdiff