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

NAME

6       lvscan - List all logical volumes in all volume groups
7

SYNOPSIS

9       lvscan option_args
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

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

USAGE

21       lvscan
22           [ -a|--all ]
23           [ COMMON_OPTIONS ]
24
25       lvscan --cache
26           [ COMMON_OPTIONS ]
27           [ LV ... ]
28
29       Common options for command:
30           [ -b|--blockdevice ]
31           [    --ignorelockingfailure ]
32           [    --readonly ]
33           [    --reportformat basic|json ]
34
35       Common options for lvm:
36           [ -d|--debug ]
37           [ -h|--help ]
38           [ -q|--quiet ]
39           [ -t|--test ]
40           [ -v|--verbose ]
41           [ -y|--yes ]
42           [    --commandprofile String ]
43           [    --config String ]
44           [    --driverloaded y|n ]
45           [    --lockopt String ]
46           [    --longhelp ]
47           [    --profile String ]
48           [    --version ]
49

OPTIONS

51       -a|--all
52              Show information about internal LVs.  These are components of
53              normal LVs, such as mirrors, which are not independently acces‐
54              sible, e.g. not mountable.
55
56       -b|--blockdevice
57              No longer used.
58
59       --cache
60              Scan the devices used by an LV and send the metadata to lvmetad.
61
62       --commandprofile String
63              The command profile to use for command configuration.  See
64              lvm.conf(5) for more information about profiles.
65
66       --config String
67              Config settings for the command. These override lvm.conf set‐
68              tings.  The String arg uses the same format as lvm.conf, or may
69              use section/field syntax.  See lvm.conf(5) for more information
70              about config.
71
72       -d|--debug ...
73              Set debug level. Repeat from 1 to 6 times to increase the detail
74              of messages sent to the log file and/or syslog (if configured).
75
76       --driverloaded y|n
77              If set to no, the command will not attempt to use device-mapper.
78              For testing and debugging.
79
80       -h|--help
81              Display help text.
82
83       --ignorelockingfailure
84              Allows a command to continue with read-only metadata operations
85              after locking failures.
86
87       --lockopt String
88              Used to pass options for special cases to lvmlockd.  See lvm‐
89              lockd(8) for more information.
90
91       --longhelp
92              Display long help text.
93
94       --profile String
95              An alias for --commandprofile or --metadataprofile, depending on
96              the command.
97
98       -q|--quiet ...
99              Suppress output and log messages. Overrides --debug and --ver‐
100              bose.  Repeat once to also suppress any prompts with answer
101              'no'.
102
103       --readonly
104              Run the command in a special read-only mode which will read on-
105              disk metadata without needing to take any locks. This can be
106              used to peek inside metadata used by a virtual machine image
107              while the virtual machine is running.  It can also be used to
108              peek inside the metadata of clustered VGs when clustered locking
109              is not configured or running. No attempt will be made to commu‐
110              nicate with the device-mapper kernel driver, so this option is
111              unable to report whether or not LVs are actually in use.
112
113       --reportformat basic|json
114              Overrides current output format for reports which is defined
115              globally by the report/output_format setting in lvm.conf.  basic
116              is the original format with columns and rows.  If there is more
117              than one report per command, each report is prefixed with the
118              report name for identification. json produces report output in
119              JSON format. See lvmreport(7) for more information.
120
121       -t|--test
122              Run in test mode. Commands will not update metadata.  This is
123              implemented by disabling all metadata writing but nevertheless
124              returning success to the calling function. This may lead to
125              unusual error messages in multi-stage operations if a tool
126              relies on reading back metadata it believes has changed but
127              hasn't.
128
129       -v|--verbose ...
130              Set verbose level. Repeat from 1 to 4 times to increase the
131              detail of messages sent to stdout and stderr.
132
133       --version
134              Display version information.
135
136       -y|--yes
137              Do not prompt for confirmation interactively but always assume
138              the answer yes. Use with extreme caution.  (For automatic no,
139              see -qq.)
140

VARIABLES

142       LV
143              Logical Volume name.  See lvm(8) for valid names.  An  LV  posi‐
144              tional  arg  generally  includes  the  VG name and LV name, e.g.
145              VG/LV.
146
147       String
148              See the option description for information about the string con‐
149              tent.
150
151       Size[UNIT]
152              Size  is  an  input number that accepts an optional unit.  Input
153              units are always treated as base two values, regardless of capi‐
154              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
155              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
156              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
157              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
158              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
159              e|E is exabytes.  (This should not be confused with  the  output
160              control --units, where capital letters mean multiple of 1000.)
161

ENVIRONMENT VARIABLES

163       See  lvm(8)  for  information  about environment variables used by lvm.
164       For example, LVM_VG_NAME can generally be substituted for a required VG
165       parameter.
166

SEE ALSO

168       lvm(8) lvm.conf(5) lvmconfig(8)
169
170       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
171       pvresize(8) pvs(8) pvscan(8)
172
173       vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8)  vgcreate(8)  vgcon‐
174       vert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport‐
175       clone(8) vgmerge(8) vgmknodes(8)  vgreduce(8)  vgremove(8)  vgrename(8)
176       vgs(8) vgscan(8) vgsplit(8)
177
178       lvcreate(8)  lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8) lvre‐
179       duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
180
181       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
182       vate(8) lvmdump(8)
183
184       dmeventd(8)  lvmetad(8)  lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8)
185       cmirrord(8) lvmdbusd(8)
186
187       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
188
189
190
191Red Hat, Inc.         LVM TOOLS 2.02.183(2) (2018-12-07)             LVSCAN(8)
Impressum