1 9ddaf4ab 2023-04-08 benni .\" Copyright (c) 2023 Benjamin Stürz <benni@stuerz.xyz>
 2 9ddaf4ab 2023-04-08 benni .\"
 3 9ddaf4ab 2023-04-08 benni .\" Permission to use, copy, modify, and distribute this software for any
 4 9ddaf4ab 2023-04-08 benni .\" purpose with or without fee is hereby granted, provided that the above
 5 9ddaf4ab 2023-04-08 benni .\" copyright notice and this permission notice appear in all copies.
 6 9ddaf4ab 2023-04-08 benni .\"
 7 9ddaf4ab 2023-04-08 benni .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 8 9ddaf4ab 2023-04-08 benni .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 9 9ddaf4ab 2023-04-08 benni .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 9ddaf4ab 2023-04-08 benni .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 9ddaf4ab 2023-04-08 benni .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 9ddaf4ab 2023-04-08 benni .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 9ddaf4ab 2023-04-08 benni .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 5691dc7b 2023-05-05 benni .TH LSBLK 8 lsblk-@VERSION@ 2023-05-05
15 33bf1ca4 2023-04-08 benni .SH NAME
16 33bf1ca4 2023-04-08 benni lsblk \- list block devices
17 33bf1ca4 2023-04-08 benni .SH SYNOPSIS
18 5691dc7b 2023-05-05 benni .B lsblk
19 1678d261 2023-05-15 benni [\fB-abinUuV\fR]
20 5691dc7b 2023-05-05 benni [\fIdisk ...\fR]
21 33bf1ca4 2023-04-08 benni .SH DESCRIPTION
22 33bf1ca4 2023-04-08 benni The
23 33bf1ca4 2023-04-08 benni .B lsblk
24 b78f9b30 2023-04-08 benni utility can be used to examine block devices attached to the system.
25 5691dc7b 2023-05-05 benni If passed
26 5691dc7b 2023-05-05 benni .I disk
27 5691dc7b 2023-05-05 benni operands it lists the specified devices.
28 5691dc7b 2023-05-05 benni Otherwise it lists all attached block devices.
29 fc7d38e3 2023-04-08 benni .SH OPTIONS
30 fc7d38e3 2023-04-08 benni .TP
31 b78f9b30 2023-04-08 benni .B \-V
32 9c5d8ecc 2023-05-02 benni prints version information to stdout, then exit.
33 8380cc51 2023-05-01 benni .TP
34 bf0e6461 2023-05-02 benni .B \-a
35 bf0e6461 2023-05-02 benni print all fields.
36 bf0e6461 2023-05-02 benni .TP
37 1678d261 2023-05-15 benni .B \-b
38 1678d261 2023-05-15 benni don't scan for RAID volumes using
39 1678d261 2023-05-15 benni .BR bio (4) .
40 1678d261 2023-05-15 benni .TP
41 0c961f7d 2023-05-04 benni .B \-i
42 0c961f7d 2023-05-04 benni don't print fancy unicode characters, only print ASCII.
43 0c961f7d 2023-05-04 benni .TP
44 8380cc51 2023-05-01 benni .B \-n
45 8380cc51 2023-05-01 benni don't print the header.
46 9c5d8ecc 2023-05-02 benni .TP
47 1115ad3a 2023-05-05 benni .B \-U
48 1115ad3a 2023-05-05 benni also print the disklabel UID.
49 1115ad3a 2023-05-05 benni .TP
50 9c5d8ecc 2023-05-02 benni .B \-u
51 9c5d8ecc 2023-05-02 benni also print the filesystem usage of each partition
52 9c5d8ecc 2023-05-02 benni and the disklabel usage of each disk.
53 9c5d8ecc 2023-05-02 benni 
54 5691dc7b 2023-05-05 benni Note: The disklabel usage is calculated by
55 5691dc7b 2023-05-05 benni summing the size of all (except "c") partitions.
56 9c5d8ecc 2023-05-02 benni 
57 1115ad3a 2023-05-05 benni Note 2: lsblk shows the total amount of free space,
58 1115ad3a 2023-05-05 benni including space reserved for /root.
59 5691dc7b 2023-05-05 benni 
60 5691dc7b 2023-05-05 benni .SH EXIT STATUS
61 5691dc7b 2023-05-05 benni The
62 5691dc7b 2023-05-05 benni .B lsblk
63 5691dc7b 2023-05-05 benni utility exits 0 on success, and >0 if an error occurs.
64 5691dc7b 2023-05-05 benni 
65 5691dc7b 2023-05-05 benni .SH EXAMPLES
66 5691dc7b 2023-05-05 benni The following line lists all block devices:
67 5691dc7b 2023-05-05 benni .PP
68 5691dc7b 2023-05-05 benni .RS 5
69 5691dc7b 2023-05-05 benni lsblk
70 5691dc7b 2023-05-05 benni 
71 5691dc7b 2023-05-05 benni .RE
72 5691dc7b 2023-05-05 benni The following line lists all fields of sd0:
73 5691dc7b 2023-05-05 benni .PP
74 5691dc7b 2023-05-05 benni .RS 5
75 5691dc7b 2023-05-05 benni lsblk -a sd0
76 5691dc7b 2023-05-05 benni 
77 1678d261 2023-05-15 benni .SH FIELDS
78 1678d261 2023-05-15 benni .B TODO
79 1678d261 2023-05-15 benni Explain the exact meaning of every field.
80 1678d261 2023-05-15 benni 
81 33bf1ca4 2023-04-08 benni .SH SEE ALSO
82 9c5d8ecc 2023-05-02 benni .BR disklabel (8) ,
83 1678d261 2023-05-15 benni .BR bio (4) ,
84 9c5d8ecc 2023-05-02 benni .BR df (1)
85 5691dc7b 2023-05-05 benni 
86 5691dc7b 2023-05-05 benni .SH HISTORY
87 5691dc7b 2023-05-05 benni The
88 5691dc7b 2023-05-05 benni .B lsblk(8)
89 5691dc7b 2023-05-05 benni utility was originally written by the
90 5691dc7b 2023-05-05 benni .B util-linux
91 5691dc7b 2023-05-05 benni project.
92 5691dc7b 2023-05-05 benni This is an
93 5691dc7b 2023-05-05 benni .I incompatible
94 5691dc7b 2023-05-05 benni clone of the original \fBlsblk\fR.
95 5691dc7b 2023-05-05 benni It is incompatible because it doesn't support
96 5691dc7b 2023-05-05 benni the same set of options as the original
97 5691dc7b 2023-05-05 benni and because of differences in the output.
98 5691dc7b 2023-05-05 benni More incompatibilities are caused by specific features only being available
99 5691dc7b 2023-05-05 benni on either Linux or OpenBSD.