search..
No manual entry for -- in section 8
LVDISPLAY(8)		    System Manager's Manual		   LVDISPLAY(8)

NAME
       lvdisplay -- Display information about a logical volume

SYNOPSIS
       lvdisplay option_args
	   [ option_args ]
	   [ position_args ]

	   --aligned
	-a|--all
	   --binary
	-c|--colon
	-C|--columns
	   --commandprofile String
	   --config String
	   --configreport log|vg|lv|pv|pvseg|seg
	-d|--debug
	   --devices PV
	   --devicesfile String
	   --driverloaded y|n
	   --foreign
	   --headings none|abbrev|full|0|1|2
	-h|--help
	-H|--history
	   --ignorelockingfailure
	   --journal String
	   --lockopt String
	   --logonly
	   --longhelp
	-m|--maps
	   --nameprefixes
	   --noheadings
	   --nohints
	   --nolocking
	   --nosuffix
	-o|--options String
	   --profile String
	-q|--quiet
	   --readonly
	   --reportformat basic|json|json_std
	   --rows
	   --segments
	-S|--select String
	   --separator String
	   --shared
	-O|--sort String
	-t|--test
	   --unbuffered
	   --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
	   --unquoted
	-v|--verbose
	   --version
	-y|--yes

DESCRIPTION
       lvdisplay  shows	 the  attributes  of LVs, like size, read/write status,
       snapshot information, etc.

       lvs(8) is a preferred alternative that shows the	 same  information  and
       more, using a more compact and configurable output format.

USAGE
       lvdisplay
	   [ -m|--maps ]
	   [ COMMON_OPTIONS ]
	   [ VG|LV|Tag ... ]

       --

       Display output in columns like lvs.

       lvdisplay -C|--columns
	   [ -o|--options String ]
	   [ -O|--sort String ]
	   [	--aligned ]
	   [	--binary ]
	   [	--headings none|abbrev|full|0|1|2 ]
	   [	--nameprefixes ]
	   [	--noheadings ]
	   [	--nosuffix ]
	   [	--rows ]
	   [	--separator String ]
	   [	--unbuffered ]
	   [	--unquoted ]
	   [ COMMON_OPTIONS ]
	   [ VG|LV|Tag ... ]

       --

       Generate colon separated output.

       lvdisplay -c|--colon
	   [ COMMON_OPTIONS ]
	   [ VG|LV|Tag ... ]

       --

       Common options for command:
	   [ -a|--all ]
	   [ -H|--history ]
	   [ -S|--select String ]
	   [	--configreport log|vg|lv|pv|pvseg|seg ]
	   [	--foreign ]
	   [	--ignorelockingfailure ]
	   [	--logonly ]
	   [	--readonly ]
	   [	--reportformat basic|json|json_std ]
	   [	--segments ]
	   [	--shared ]
	   [	--units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]

       Common options for lvm:
	   [ -d|--debug ]
	   [ -h|--help ]
	   [ -q|--quiet ]
	   [ -t|--test ]
	   [ -v|--verbose ]
	   [ -y|--yes ]
	   [	--commandprofile String ]
	   [	--config String ]
	   [	--devices PV ]
	   [	--devicesfile String ]
	   [	--driverloaded y|n ]
	   [	--journal String ]
	   [	--lockopt String ]
	   [	--longhelp ]
	   [	--nohints ]
	   [	--nolocking ]
	   [	--profile String ]
	   [	--version ]

OPTIONS

       --aligned
	      Use with --separator to align the output columns

       -a|--all
	      Show  information	 about	internal  LVs.	These are components of
	      normal LVs, such as mirrors, which are not independently accessi-
	      ble, e.g. not mountable.

       --binary
	      Use binary values "0" or "1" instead of descriptive literal  val-
	      ues for columns that have exactly two valid values to report (not
	      counting	the  "unknown" value which denotes that the value could
	      not be determined).

       -c|--colon
	      Generate colon separated output for easier parsing in scripts  or
	      programs.	  Also see lvs(8) which provides considerably more con-
	      trol over the output.  The values are:
		o logical volume name
		o volume group name
		o logical volume access
		o logical volume status
		o internal logical volume number
		o open count of logical volume
		o logical volume size in sectors
		o current logical extents associated to logical volume
		o allocated logical extents of logical volume
		o allocation policy of logical volume
		o read ahead sectors of logical volume
		o major device number of logical volume
		o minor device number of logical volume

       -C|--columns
	      Display output in columns.  The equivalent  of  lvs(8).	Options
	      listed are the same as options given in lvs(8).

       --commandprofile String
	      The  command  profile  to	 use  for  command  configuration.  See
	      lvm.conf(5) for more information about profiles.

       --config String
	      Config settings for the command. These override lvm.conf(5)  set-
	      tings.   The  String  arg uses the same format as lvm.conf(5), or
	      may use section/field syntax.  See lvm.conf(5) for more  informa-
	      tion about config.

       --configreport log|vg|lv|pv|pvseg|seg
	      See lvmreport(7).

       -d|--debug ...
	      Set  debug level. Repeat from 1 to 6 times to increase the detail
	      of messages sent to the log file and/or syslog (if configured).

       --devices PV
	      Restricts the devices that are visible and accessible to the com-
	      mand.  Devices not listed will appear to be missing. This	 option
	      can  be  repeated,  or accepts a comma separated list of devices.
	      This overrides the devices file.

       --devicesfile String
	      A file listing devices that LVM should use.  The file must  exist
	      in  /etc/lvm/devices/  and is managed with the lvmdevices(8) com-
	      mand.  This overrides the lvm.conf(5) devices/devicesfile and de-
	      vices/use_devicesfile settings.

       --driverloaded y|n
	      If set to no, the command will not attempt to use	 device-mapper.
	      For testing and debugging.

       --foreign
	      Report/display  foreign VGs that would otherwise be skipped.  See
	      lvmsystemid(7) for more information about foreign VGs.

       --headings none|abbrev|full|0|1|2
	      Type of headings to use in report output.	 none or  0:  No  head-
	      ings.   abbrev  or 1: Column name abbreviations.	full or 2: Full
	      column names.

       -h|--help
	      Display help text.

       -H|--history
	      Include historical LVs in the output.  (This has no effect unless
	      LVs were removed	while  lvm.conf(5)  metadata/record_lvs_history
	      was enabled.

       --ignorelockingfailure
	      Allows  a	 command to continue with read-only metadata operations
	      after locking failures.

       --journal String
	      Record information in the systemd journal.  This	information  is
	      in  addition  to	information enabled by the lvm.conf log/journal
	      setting.	command: record information about the command.	output:
	      record the default command output.  debug:  record  full	command
	      debugging.

       --lockopt String
	      Used  to	pass  options  for special cases to lvmlockd.  See lvm-
	      lockd(8) for more information.

       --logonly
	      Suppress command report and display only log report.

       --longhelp
	      Display long help text.

       -m|--maps
	      Display the mapping of logical extents to PVs  and  physical  ex-
	      tents.   To  map	physical  extents  to  logical extents use: pvs
	      --segments -o+lv_name,seg_start_pe,segtype

       --nameprefixes
	      Add an "LVM2_" prefix plus the field name to the	output.	 Useful
	      with --noheadings to produce a list of field=value pairs that can
	      be  used	to  set	 environment  variables	 (for  example, in udev
	      rules).

       --noheadings
	      Suppress the headings line that is normally  the	first  line  of
	      output.  Useful if grepping the output.

       --nohints
	      Do  not  use  the hints file to locate devices for PVs. A command
	      may read more devices to find PVs when hints are	not  used.  The
	      command  will still perform standard hint file invalidation where
	      appropriate.

       --nolocking
	      Disable locking. Use with caution, concurrent commands  may  pro-
	      duce incorrect results.

       --nosuffix
	      Suppress	the  suffix on output sizes. Use with --units (except h
	      and H) if processing the output.

       -o|--options String
	      Comma-separated, ordered list of fields to  display  in  columns.
	      String  arg  syntax  is: [+|-|#]Field1[,Field2 ...]  The prefix +
	      will append the specified fields to the default  fields,	-  will
	      remove  the  specified fields from the default fields, and # will
	      compact specified fields (removing them when empty for all rows.)
	      Use -o help to view the list of all available fields.  Use  sepa-
	      rate  lists  of fields to add, remove or compact by repeating the
	      -o option: -o+field1,field2  -o-field3,field4  -o#field5.	  These
	      lists are evaluated from left to right.  Use field name lv_all to
	      view  all	 LV fields, vg_all all VG fields, pv_all all PV fields,
	      pvseg_all all PV segment fields, seg_all all LV  segment	fields,
	      and pvseg_all all PV segment columns.  See the lvm.conf(5) report
	      section  for  more config options.  See lvmreport(7) for more in-
	      formation about reporting.

       --profile String
	      An alias for --commandprofile or --metadataprofile, depending  on
	      the command.

       -q|--quiet ...
	      Suppress	output	and  log messages. Overrides --debug and --ver-
	      bose.  Repeat once to also suppress any prompts with answer 'no'.

       --readonly
	      Prevent the command from making changes, including activation and
	      metadata updates.	 (See --permission r for read only LVs.)

       --reportformat basic|json|json_std
	      Overrides current output format  for  reports  which  is	defined
	      globally by the report/output_format setting in lvm.conf(5).  ba-
	      sic  is  the  original format with columns and rows.  If there is
	      more than one report per command, each report  is	 prefixed  with
	      the  report  name for identification. json produces report output
	      in JSON format. json_std produces report output  in  JSON	 format
	      which is more compliant with JSON standard.  See lvmreport(7) for
	      more information.

       --rows
	      Output columns as rows.

       --segments

       -S|--select String
	      Select  objects  for  processing and reporting based on specified
	      criteria.	 The criteria syntax is described by --select help  and
	      lvmreport(7).   For  reporting commands, one row is displayed for
	      each object matching the criteria.  See --options help for selec-
	      table object fields.  Rows can be displayed  with	 an  additional
	      "selected"  field	 (-o selected) showing 1 if the row matches the
	      selection and 0  otherwise.   For	 non-reporting	commands  which
	      process  LVM  entities,  the selection is used to choose items to
	      process.

       --separator String
	      String to use to separate each column.  Useful  if  grepping  the
	      output.

       --shared
	      Report/display  shared  VGs  that would otherwise be skipped when
	      lvmlockd is not being used on the host.  See lvmlockd(8) for more
	      information about shared VGs.

       -O|--sort String
	      Comma-separated ordered list of columns to sort by. Replaces  the
	      default  selection.  Precede any column with - for a reverse sort
	      on that column.

       -t|--test
	      Run in test mode. Commands will not update metadata.  This is im-
	      plemented by disabling all metadata writing but nevertheless  re-
	      turning success to the calling function. This may lead to unusual
	      error  messages  in  multi-stage	operations  if a tool relies on
	      reading back metadata it believes has changed but hasn't.

       --unbuffered
	      Produce  output  immediately  without  sorting  or  aligning  the
	      columns properly.

       --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
	      All  sizes  are  output in these units: human-(r)eadable with '<'
	      rounding	 indicator,   (h)uman-readable,	  (b)ytes,   (s)ectors,
	      (k)ilobytes,  (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
	      (e)xabytes.  Capitalise to use multiples of 1000	(S.I.)	instead
	      of 1024.	Custom units can be specified, e.g. --units 3M.

       --unquoted
	      When  used  with --nameprefixes, output values in the field=value
	      pairs are not quoted.

       -v|--verbose ...
	      Set verbose level. Repeat from 1 to 4 times to increase  the  de-
	      tail of messages sent to stdout and stderr.

       --version
	      Display version information.

       -y|--yes
	      Do  not  prompt  for confirmation interactively but always assume
	      the answer yes. Use with extreme caution.	 (For automatic no, see
	      -qq.)

VARIABLES
       VG     Volume Group name.  See lvm(8) for valid names.

       LV     Logical Volume name.  See lvm(8) for valid names.	  An  LV  posi-
	      tional  arg  generally  includes	the  VG	 name and LV name, e.g.
	      VG/LV.

       Tag    Tag name.	 See lvm(8) for information about tag names  and  using
	      tags in place of a VG, LV or PV.

       String See  the option description for information about the string con-
	      tent.

       Size[UNIT]
	      Size is an input number that accepts  an	optional  unit.	  Input
	      units  are always treated as base two values, regardless of capi-
	      talization, e.g. 'k' and 'K' both refer to 1024.	The default in-
	      put unit is specified by letter, followed by |UNIT.  UNIT	 repre-
	      sents other possible input units: b|B is bytes, s|S is sectors of
	      512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB, p|P is
	      PiB,  e|E	 is  EiB.  (This should not be confused with the output
	      control --units, where capital letters mean multiple of 1000.)

ENVIRONMENT VARIABLES
       See lvm(8) for information about environment variables used by lvm.  For
       example, LVM_VG_NAME can generally be substituted for a required VG  pa-
       rameter.

SEE ALSO
       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),

       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8),
       pvresize(8), pvs(8), pvscan(8),

       vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
       vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
       vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
       vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),

       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),

       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),

       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
       lvmdbusd(8), fsadm(8),

       lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
       lvmvdo(7), lvmautoactivation(7)

Red Hat, Inc.	       LVM TOOLS 2.03.31(2) (2025-02-27)	   LVDISPLAY(8)