1LVSCAN(8) System Manager's Manual LVSCAN(8)
2
6 lvscan - List all logical volumes in all volume groups
7
9 lvscan option_args
10 [ option_args ]
11 [ position_args ]
12
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
21 lvscan
22 [ -a|--all ]
23 [ COMMON_OPTIONS ]
24 lvscan --cache
26 [ COMMON_OPTIONS ]
27 [ LV ... ]
28 Common options for command:
30 [ -b|--blockdevice ]
31 [ --ignorelockingfailure ]
32 [ --readonly ]
33 [ --reportformat basic|json ]
34 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
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 -b|--blockdevice
57 No longer used.
58 --cache
60 Scan the devices used by an LV and send the metadata to lvmetad.
61 --commandprofile String
63 The command profile to use for command configuration. See
64 lvm.conf(5) for more information about profiles.
65 --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 -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 --driverloaded y|n
77 If set to no, the command will not attempt to use device-mapper.
78 For testing and debugging.
79 -h|--help
81 Display help text.
82 --ignorelockingfailure
84 Allows a command to continue with read-only metadata operations
85 after locking failures.
86 --lockopt String
88 Used to pass options for special cases to lvmlockd. See lvm‐
89 lockd(8) for more information.
90 --longhelp
92 Display long help text.
93 --profile String
95 An alias for --commandprofile or --metadataprofile, depending on
96 the command.
97 -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 --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 --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 -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 -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 --version
134 Display version information.
135 -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
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 String
148 See the option description for information about the string con‐
149 tent.
150 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
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
168 lvm(8) lvm.conf(5) lvmconfig(8)
169 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
171 pvresize(8) pvs(8) pvscan(8)
172 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 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 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
182 vate(8) lvmdump(8)
183 dmeventd(8) lvmetad(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8)
185 cmirrord(8) lvmdbusd(8)
186 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
188Red Hat, Inc. LVM TOOLS 2.02.180(2)-RHEL7 (2018-07-20) LVSCAN(8)