~ubuntu-branches/ubuntu/precise/util-linux/precise-proposed

« back to all changes in this revision

Viewing changes to misc-utils/lsblk.8

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2011-06-20 22:31:50 UTC
  • mfrom: (1.6.3 upstream) (4.5.1 sid)
  • Revision ID: james.westby@ubuntu.com-20110620223150-lz8wrv0946ihcz3z
Tags: 2.19.1-2ubuntu1
* Merge from Debian unstable, remaining changes:
  - Build for multiarch.
  - Add pre-depends on multiarch-support.
  - configure.ac: don't try to be clever about extracting a path name from
    $libdir to append to /usr in a way that's not overridable; instead,
    reuse the built-in configurable libexecdir.
  - Fix up the .pc.in files to know about libexecdir, so our substitutions
    don't leave us with unusable pkg-config files.
  - Install custom blkid.conf to use /dev/.blkid.tab since we don't
    expect device names to survive a reboot
  - Mention mountall(8) in fstab(5) manpages, along with its special
    options.
  - Since upstart is required in Ubuntu, the hwclock.sh init script is not
    called on startup and the hwclockfirst.sh init script is removed.
  - Drop depends on initscripts for the above.
  - Replace hwclock udev rule with an Upstart job.
  - For the case where mount is called with a directory to mount, look
    that directory up in mountall's /lib/init/fstab if we couldn't find
    it mentioned anywhere else.  This means "mount /proc", "mount /sys",
    etc. work.
  - mount.8 points to the cifs-utils package, not the obsolete smbfs one. 
* Dropped changes:
  - mount.preinst: lsb_release has been fixed in lucid and above to be
    usable without configuration, so we don't have to diverge from Debian
    here anymore.
* Changes merged upstream:
  - sfdisk support for '+' with '-N'
  - mount/umount.c: fix a segfault on umount with empty mtab entry
  - Fix arbitrary unmount with fuse security issue

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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/.