1LVS(8)                      System Manager's Manual                     LVS(8)
2
3
4

NAME

6       lvs - report information about logical volumes
7

SYNOPSIS

9       lvs  [-a|--all]  [--aligned] [-d|--debug] [-h|-?|--help] [--ignorelock‐
10       ingfailure] [--nameprefixes] [--noheadings] [--nosuffix]  [-o|--options
11       [+]Field[,Field]]  [-O|--sort  [+|-]Key1[,[+|-]Key2[,...]]]  [-P|--par‐
12       tial]  [--rows]  [--segments]  [--separator  Separator]  [--unbuffered]
13       [--units  hHbBsSkKmMgGtTpPeE]  [--unquoted]  [-v|--verbose] [--version]
14       [VolumeGroupName [VolumeGroupName...]]
15

DESCRIPTION

17       lvs produces formatted output about logical volumes.
18

OPTIONS

20       See lvm for common options.
21
22       --all  Include information in the output about internal Logical Volumes
23              that are components of normally-accessible Logical Volumes, such
24              as mirrors, but which are not independently accessible (e.g. not
25              mountable).   The  names  of  such  Logical Volumes are enclosed
26              within square brackets in the output.  For example, after creat‐
27              ing  a mirror using 'lvcreate -m1 --mirrorlog disk', this option
28              will reveal three internal Logical Volumes, with  suffixes  mim‐
29              age_0, mimage_1, and mlog.
30
31       --aligned
32              Use with --separator to align the output columns.
33
34       --nameprefixes
35              Add an "LVM2_" prefix plus the field name to the output.  Useful
36              with --noheadings to produce a list of  field=value  pairs  that
37              can  be  used to set environment variables (for example, in udev
38              (7) rules).
39
40       --noheadings
41              Suppress the headings line that is normally the  first  line  of
42              output.  Useful if grepping the output.
43
44       --nosuffix
45              Suppress the suffix on output sizes.  Use with --units (except h
46              and H) if processing the output.
47
48       -o, --options
49              Comma-separated ordered list of columns.  Precede the list  with
50              '+'  to  append  to  the default selection of columns instead of
51              replacing it.
52
53              Use -o lv_all to select  all  logical  volume  columns,  and  -o
54              seg_all to select all logical volume segment columns.
55
56              Use -o help to view the full list of columns available.
57
58              Column   names  include:  lv_uuid,  lv_name,  lv_path,  lv_attr,
59              lv_major,  lv_minor,  lv_read_ahead,  lv_kernel_major,   lv_ker‐
60              nel_minor,  lv_kernel_read_ahead,  lv_size,  seg_count,  origin,
61              origin_size, snap_percent,  copy_percent,  move_pv,  convert_lv,
62              lv_tags,  mirror_log,  modules,  segtype,  stripes,  stripesize,
63              regionsize,  chunksize,   seg_start,   seg_start_pe,   seg_size,
64              seg_tags, seg_pe_ranges, devices.
65
66              With --segments, any "seg_" prefixes are optional; otherwise any
67              "lv_" prefixes are optional.  Columns mentioned in vgs  (8)  can
68              also be chosen.
69
70              The lv_attr bits are:
71
72              1  Volume  type:  (m)irrored,  (M)irrored  without initial sync,
73                 (o)rigin, (O)rigin with merging snapshot, (s)napshot, merging
74                 (S)napshot,   (p)vmove,  (v)irtual,  mirror  (i)mage,  mirror
75                 (I)mage out-of-sync, under (c)onversion
76
77              2  Permissions: (w)riteable, (r)ead-only
78
79              3  Allocation   policy:   (c)ontiguous,    c(l)ing,    (n)ormal,
80                 (a)nywhere,  (i)nherited This is capitalised if the volume is
81                 currently locked against allocation changes, for example dur‐
82                 ing pvmove (8).
83
84              4  fixed (m)inor
85
86              5  State:  (a)ctive,  (s)uspended,  (I)nvalid  snapshot, invalid
87                 (S)uspended snapshot, mapped (d)evice present without tables,
88                 mapped device present with (i)nactive table
89
90              6  device (o)pen
91
92       --segments
93              Use default columns that emphasize segment information.
94
95       -O, --sort
96              Comma-separated  ordered  list  of columns to sort by.  Replaces
97              the default selection. Precede any column with - for  a  reverse
98              sort on that column.
99
100       --rows Output columns as rows.
101
102       --separator Separator
103              String  to  use to separate each column.  Useful if grepping the
104              output.
105
106       --unbuffered
107              Produce output immediately without sorting or aligning the  col‐
108              umns properly.
109
110       --units hHbBsSkKmMgGtTpPeE
111              All  sizes are output in these units: (h)uman-readable, (b)ytes,
112              (s)ectors, (k)ilobytes, (m)egabytes,  (g)igabytes,  (t)erabytes,
113              (p)etabytes,  (e)xabytes.   Capitalise  to use multiples of 1000
114              (S.I.) instead of 1024.  Can  also  specify  custom  units  e.g.
115              --units 3M
116
117       --unquoted
118              When  used with --nameprefixes, output values in the field=value
119              pairs are not quoted.
120

SEE ALSO

122       lvm(8), lvdisplay(8), pvs(8), vgs(8)
123
124
125
126Sistina Software UK    LVM TOOLS 2.02.84(2) (2011-02-09)                LVS(8)
Impressum