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

NAME

6       lvdisplay — Display information about a logical volume
7

SYNOPSIS

9       lvdisplay
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

14       lvdisplay  shows  the  attributes of LVs, like size, read/write status,
15       snapshot information, etc.
16
17       lvs(8) is a preferred alternative that shows the same  information  and
18       more, using a more compact and configurable output format.
19

USAGE

21       lvdisplay
22           [ -a|--all ]
23           [ -c|--colon ]
24           [ -C|--columns ]
25           [ -H|--history ]
26           [ -m|--maps ]
27           [ -o|--options String ]
28           [ -O|--sort String ]
29           [ -S|--select String ]
30           [    --aligned ]
31           [    --binary ]
32           [    --configreport log|vg|lv|pv|pvseg|seg ]
33           [    --foreign ]
34           [    --ignorelockingfailure ]
35           [    --logonly ]
36           [    --noheadings ]
37           [    --nosuffix ]
38           [    --readonly ]
39           [    --segments ]
40           [    --separator String ]
41           [    --shared ]
42           [    --unbuffered ]
43           [    --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
44           [ COMMON_OPTIONS ]
45           [ VG|LV|Tag ... ]
46
47       Common options for lvm:
48           [ -d|--debug ]
49           [ -h|--help ]
50           [ -q|--quiet ]
51           [ -t|--test ]
52           [ -v|--verbose ]
53           [ -y|--yes ]
54           [    --commandprofile String ]
55           [    --config String ]
56           [    --devices PV ]
57           [    --devicesfile String ]
58           [    --driverloaded y|n ]
59           [    --journal String ]
60           [    --lockopt String ]
61           [    --longhelp ]
62           [    --nohints ]
63           [    --nolocking ]
64           [    --profile String ]
65           [    --version ]
66

OPTIONS

68       --aligned
69              Use with --separator to align the output columns
70
71       -a|--all
72              Show  information  about  internal LVs.  These are components of
73              normal LVs, such as mirrors, which are not independently  acces‐
74              sible, e.g. not mountable.
75
76       --binary
77              Use binary values "0" or "1" instead of descriptive literal val‐
78              ues for columns that have exactly two  valid  values  to  report
79              (not  counting  the "unknown" value which denotes that the value
80              could not be determined).
81
82       -c|--colon
83              Generate colon separated output for easier parsing in scripts or
84              programs.  Also see vgs(8) which provides considerably more con‐
85              trol over the output.
86
87       -C|--columns
88              Display output in columns, the equivalent  of  vgs(8).   Options
89              listed are the same as options given in vgs(8).
90
91       --commandprofile String
92              The  command  profile  to  use  for  command configuration.  See
93              lvm.conf(5) for more information about profiles.
94
95       --config String
96              Config settings for the command. These override lvm.conf(5) set‐
97              tings.   The  String arg uses the same format as lvm.conf(5), or
98              may use section/field syntax.  See lvm.conf(5) for more informa‐
99              tion about config.
100
101       --configreport log|vg|lv|pv|pvseg|seg
102              See lvmreport(7).
103
104       -d|--debug ...
105              Set debug level. Repeat from 1 to 6 times to increase the detail
106              of messages sent to the log file and/or syslog (if configured).
107
108       --devices PV
109              Restricts the devices that are visible  and  accessible  to  the
110              command.  Devices not listed will appear to be missing. This op‐
111              tion can be repeated, or accepts a comma separated list  of  de‐
112              vices. This overrides the devices file.
113
114       --devicesfile String
115              A file listing devices that LVM should use.  The file must exist
116              in /etc/lvm/devices/ and is managed with the lvmdevices(8)  com‐
117              mand.   This  overrides  the lvm.conf(5) devices/devicesfile and
118              devices/use_devicesfile settings.
119
120       --driverloaded y|n
121              If set to no, the command will not attempt to use device-mapper.
122              For testing and debugging.
123
124       --foreign
125              Report/display foreign VGs that would otherwise be skipped.  See
126              lvmsystemid(7) for more information about foreign VGs.
127
128       -h|--help
129              Display help text.
130
131       -H|--history
132              Include historical LVs in the output.  (This has no  effect  un‐
133              less LVs were removed while lvm.conf(5) metadata/record_lvs_his‐
134              tory was enabled.
135
136       --ignorelockingfailure
137              Allows a command to continue with read-only metadata  operations
138              after locking failures.
139
140       --journal String
141              Record  information in the systemd journal.  This information is
142              in addition to information enabled by the  lvm.conf  log/journal
143              setting.   command:  record information about the command.  out‐
144              put: record the default command output.  debug: record full com‐
145              mand debugging.
146
147       --lockopt String
148              Used  to  pass  options for special cases to lvmlockd.  See lvm‐
149              lockd(8) for more information.
150
151       --logonly
152              Suppress command report and display only log report.
153
154       --longhelp
155              Display long help text.
156
157       -m|--maps
158              Display the mapping of logical extents to PVs and  physical  ex‐
159              tents.   To  map  physical  extents  to logical extents use: pvs
160              --segments -o+lv_name,seg_start_pe,segtype
161
162       --noheadings
163              Suppress the headings line that is normally the  first  line  of
164              output.  Useful if grepping the output.
165
166       --nohints
167              Do  not  use the hints file to locate devices for PVs. A command
168              may read more devices to find PVs when hints are not  used.  The
169              command will still perform standard hint file invalidation where
170              appropriate.
171
172       --nolocking
173              Disable locking. Use with caution, concurrent commands may  pro‐
174              duce incorrect results.
175
176       --nosuffix
177              Suppress  the suffix on output sizes. Use with --units (except h
178              and H) if processing the output.
179
180       -o|--options String
181              Comma-separated, ordered list of fields to display  in  columns.
182              String  arg  syntax is: [+|-|#]Field1[,Field2 ...]  The prefix +
183              will append the specified fields to the default fields,  -  will
184              remove  the specified fields from the default fields, and # will
185              compact specified fields  (removing  them  when  empty  for  all
186              rows.)   Use  -o  help to view the list of all available fields.
187              Use separate lists of fields to add, remove or  compact  by  re‐
188              peating   the   -o   option:  -o+field1,field2  -o-field3,field4
189              -o#field5.  These lists are evaluated from left to  right.   Use
190              field  name  lv_all to view all LV fields, vg_all all VG fields,
191              pv_all all PV fields, pvseg_all all PV segment  fields,  seg_all
192              all  LV  segment  fields,  and pvseg_all all PV segment columns.
193              See the lvm.conf(5) report section for more config options.  See
194              lvmreport(7) for more information about reporting.
195
196       --profile String
197              An alias for --commandprofile or --metadataprofile, depending on
198              the command.
199
200       -q|--quiet ...
201              Suppress output and log messages. Overrides --debug  and  --ver‐
202              bose.   Repeat  once  to  also  suppress any prompts with answer
203              'no'.
204
205       --readonly
206              Run the command in a special read-only mode which will read  on-
207              disk  metadata  without  needing  to take any locks. This can be
208              used to peek inside metadata used by  a  virtual  machine  image
209              while the virtual machine is running. No attempt will be made to
210              communicate with the device-mapper kernel driver, so this option
211              is unable to report whether or not LVs are actually in use.
212
213       --segments
214
215       -S|--select String
216              Select  objects  for processing and reporting based on specified
217              criteria.  The criteria syntax is described by --select help and
218              lvmreport(7).   For reporting commands, one row is displayed for
219              each object matching the criteria.  See --options help  for  se‐
220              lectable object fields.  Rows can be displayed with an addition‐
221              al "selected" field (-o selected) showing 1 if the  row  matches
222              the selection and 0 otherwise.  For non-reporting commands which
223              process LVM entities, the selection is used to choose  items  to
224              process.
225
226       --separator String
227              String  to  use  to separate each column. Useful if grepping the
228              output.
229
230       --shared
231              Report/display shared VGs that would otherwise be  skipped  when
232              lvmlockd  is  not  being  used on the host.  See lvmlockd(8) for
233              more information about shared VGs.
234
235       -O|--sort String
236              Comma-separated ordered list of columns to sort by. Replaces the
237              default  selection. Precede any column with - for a reverse sort
238              on that column.
239
240       -t|--test
241              Run in test mode. Commands will not update  metadata.   This  is
242              implemented  by  disabling all metadata writing but nevertheless
243              returning success to the calling function. This may lead to  un‐
244              usual  error messages in multi-stage operations if a tool relies
245              on reading back metadata it believes has changed but hasn't.
246
247       --unbuffered
248              Produce output immediately without sorting or aligning the  col‐
249              umns properly.
250
251       --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
252              All  sizes  are output in these units: human-(r)eadable with '<'
253              rounding  indicator,   (h)uman-readable,   (b)ytes,   (s)ectors,
254              (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
255              (e)xabytes.  Capitalise to use multiples of 1000 (S.I.)  instead
256              of 1024.  Custom units can be specified, e.g. --units 3M.
257
258       -v|--verbose ...
259              Set  verbose level. Repeat from 1 to 4 times to increase the de‐
260              tail of messages sent to stdout and stderr.
261
262       --version
263              Display version information.
264
265       -y|--yes
266              Do not prompt for confirmation interactively but  always  assume
267              the  answer  yes.  Use with extreme caution.  (For automatic no,
268              see -qq.)
269

VARIABLES

271       VG     Volume Group name.  See lvm(8) for valid names.
272
273       LV     Logical Volume name.  See lvm(8) for valid names.  An  LV  posi‐
274              tional  arg  generally  includes  the  VG name and LV name, e.g.
275              VG/LV.
276
277       Tag    Tag name.  See lvm(8) for information about tag names and  using
278              tags in place of a VG, LV or PV.
279
280       String See the option description for information about the string con‐
281              tent.
282
283       Size[UNIT]
284              Size is an input number that accepts an  optional  unit.   Input
285              units are always treated as base two values, regardless of capi‐
286              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
287              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
288              resents other possible input units: b|B is bytes, s|S is sectors
289              of  512  bytes,  k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
290              p|P is PiB, e|E is EiB.  (This should not be confused  with  the
291              output  control  --units, where capital letters mean multiple of
292              1000.)
293

ENVIRONMENT VARIABLES

295       See lvm(8) for information about environment  variables  used  by  lvm.
296       For example, LVM_VG_NAME can generally be substituted for a required VG
297       parameter.
298

SEE ALSO

300       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
301
302       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
303       pvremove(8), pvresize(8), pvs(8), pvscan(8),
304
305       vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
306       vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
307       vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
308       vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
309
310       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
311       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
312
313       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
314
315       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
316       lvmdbusd(8), fsadm(8),
317
318       lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
319       lvmvdo(7), lvmautoactivation(7)
320
321
322
323
324Red Hat, Inc.          LVM TOOLS 2.03.22(2) (2023-08-02)          LVDISPLAY(8)
Impressum