LVSCAN(8)      (LVM TOOLS 2.03.11(2) (2021-01-08))      LVSCAN(8)

     NAME
          lvscan - List all logical volumes in all volume groups

     SYNOPSIS
          lvscan
              [ option_args ]

     DESCRIPTION
          lvscan scans all VGs or all supported LVM block devices in
          the system for LVs. The output consists of one line for each
          LV indicating whether or not it is active, a snapshot or
          origin, the size of the device and its allocation policy.
          Use lvs(8) or lvdisplay(8) to obtain more comprehensive
          information about LVs.

     USAGE
          lvscan
              [ -a|--all ]
              [ -b|--blockdevice ]
              [    --ignorelockingfailure ]
              [    --readonly ]
              [    --reportformat basic|json ]
              [ COMMON_OPTIONS ]

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

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

          -b|--blockdevice
               No longer used.

          --commandprofile String

     Page 1                    Red Hat, Inc.         (printed 5/25/22)

     LVSCAN(8)      (LVM TOOLS 2.03.11(2) (2021-01-08))      LVSCAN(8)

               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 settings.  The String arg uses the same format
               as lvm.conf, or may use section/field syntax.  See
               lvm.conf(5) for more information about config.

          -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).

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

          -h|--help
               Display help text.

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

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

          --longhelp
               Display long help text.

          --nolocking
               Disable locking.

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

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

          --readonly
               Run the command in a special read-only mode which will
               read on-disk metadata without needing to take any
               locks. This can be used to peek inside metadata used by
               a virtual machine image while the virtual machine is
               running. No attempt will be made to communicate with
               the device-mapper kernel driver, so this option is
               unable to report whether or not LVs are actually in

     Page 2                    Red Hat, Inc.         (printed 5/25/22)

     LVSCAN(8)      (LVM TOOLS 2.03.11(2) (2021-01-08))      LVSCAN(8)

               use.

          --reportformat basic|json
               Overrides current output format for reports which is
               defined globally by the report/output_format setting in
               lvm.conf.  basic 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. See lvmreport(7) for more information.

          -t|--test
               Run in test mode. Commands will not update metadata.
               This is implemented by disabling all metadata writing
               but nevertheless returning 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.

          -v|--verbose ...
               Set verbose level. Repeat from 1 to 4 times to increase
               the detail 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
          String
               See the option description for  information  about  the
               string content.

          Size[UNIT]
               Size is an input number that accepts an optional  unit.
               Input  units  are  always  treated  as base two values,
               regardless of capitalization, e.g.  'k'  and  'K'  both
               refer  to 1024.  The default input unit is specified by
               letter,  followed  by  |UNIT.   UNIT  represents  other
               possible  input units: bBsSkKmMgGtTpPeE.  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 parameter.

     Page 3                    Red Hat, Inc.         (printed 5/25/22)

     LVSCAN(8)      (LVM TOOLS 2.03.11(2) (2021-01-08))      LVSCAN(8)

     SEE ALSO
          lvm(8) lvm.conf(5) lvmconfig(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)    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) lvm2-activation-generator(8)
          blkdeactivate(8) lvmdump(8)

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

          lvmsystemid(7)    lvmreport(7)     lvmraid(7)     lvmthin(7)
          lvmcache(7)

     Page 4                    Red Hat, Inc.         (printed 5/25/22)