misc-utils/lsblk.8

   1 .\" -*- nroff -*-
   2 .TH LSBLK 8 "Apr 2010" "Version 1.0"
   3 .SH NAME
   4 lsblk \- list block devices
   5 .SH SYNOPSIS
   6 .B lsblk
   7 .RB [ options ]
   8 .sp
   9 .B lsblk
  10 .RB [ options ]
  11 .IR device...
  12 .SH DESCRIPTION
  13 .B lsblk
  14 lists information about all or the specified block devices. The
  15 .B lsblk
  16 command reads the
  17 .I sysfs
  18 filesystem to gather information.
  19 .PP
  20 The command prints all block devices (except RAM disks) in a tree-like format
  21 by default.  Use
  22 .B "lsblk --help"
  23 to get a list of all available columns.
  24 .SH OPTIONS
  25 .IP "\fB\-a, \-\-all\fP"
  26 List all block devices.
  27 .IP "\fB\-b, \-\-bytes\fP"
  28 Print the SIZE column in bytes rather than in human-readable format.
  29 .IP "\fB\-d, \-\-nodeps\fP"
  30 Don't print device holders or slaves.  For example "lsblk --nodeps /dev/sda" prints
  31 information about the sda device only.
  32 .IP "\fB\-e, \-\-exclude \fIlist\fP
  33 Exclude the devices specified by a comma-delimited list of major device numbers.
  34 Note that RAM disks (major=1) are excluded by default.
  35 .IP "\fB\-f, \-\-fs\fP
  36 Output info about filesystems.  This option is equivalent to "-o NAME,FSTYPE,LABEL,MOUNTPOINT".
  37 The authoritative information about filesystems and raids is provided by the
  38 .BR blkid (8)
  39 command.
  40 .IP "\fB\-h, \-\-help\fP"
  41 Print a help text and exit.
  42 .IP "\fB\-i, \-\-ascii\fP"
  43 Use ascii characters for tree formatting.
  44 .IP "\fB\-m, \-\-perms\fP
  45 Output info about device owner, group and mode.  This option is equivalent to "-o NAME,SIZE,OWNER,GROUP,MODE".
  46 .IP "\fB\-l, \-\-list\fP"
  47 Use the list output format.
  48 .IP "\fB\-n, \-\-noheadings\fP"
  49 Do not print a header line.
  50 .IP "\fB\-o, \-\-output \fIlist\fP"
  51 Specify which output columns to print.  Use
  52 .B "--help"
  53 to get a list of all supported columns.
  54 .IP "\fB\-r, \-\-raw\fP"
  55 Use the raw output format.
  56 .IP "\fB\-t, \-\-topology\fP"
  57 Output info about block device topology.
  58 This option is equivalent to "-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED".
  59 .SH AUTHORS
  60 .nf
  61 Milan Broz <mbroz@redhat.com>
  62 Karel Zak <kzak@redhat.com>
  63 .fi
  64 .SH SEE ALSO
  65 .BR findmnt (8),
  66 .BR blkid (8),
  67 .BR ls (1)
  68 .SH AVAILABILITY
  69 The lsblk command is part of the util-linux package and is available from
  70 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.