1VGIMPORTDEVICES(8) System Manager's Manual VGIMPORTDEVICES(8)
2
6 vgimportdevices — Add devices for a VG to the devices file.
7
9 vgimportdevices option_args position_args
10 [ option_args ]
11
13 vgimportdevices adds PVs from a VG to the devices file. This is simi‐
14 lar to using using lvmdevices --adddev to add each PV to the devices
15 file individually. vgimportdevices will also update the VG metadata to
16 include the device IDs of each PV. vgimportdevices will create a new
17 devices file if none exists.
18 When a devices file is used, the regex filter is ignored, except in the
20 case of vgimportdevices which will apply the regex filter when looking
21 for the VGs to import to the devices file. Use vgimportdevices -a to
22 import all VGs on a system to the devices file.
23
25 Add devices from specific VGs to the devices file.
26 vgimportdevices VG|Tag|Select ...
28 [ -S|--select String ]
29 [ COMMON_OPTIONS ]
30 Add devices from all accessible VGs to the devices file.
32 vgimportdevices -a|--all
34 [ COMMON_OPTIONS ]
35 Common options for command:
37 [ --foreign ]
38 [ --reportformat basic|json|json_std ]
39 Common options for lvm:
41 [ -d|--debug ]
42 [ -h|--help ]
43 [ -q|--quiet ]
44 [ -t|--test ]
45 [ -v|--verbose ]
46 [ -y|--yes ]
47 [ --commandprofile String ]
48 [ --config String ]
49 [ --devices PV ]
50 [ --devicesfile String ]
51 [ --driverloaded y|n ]
52 [ --journal String ]
53 [ --lockopt String ]
54 [ --longhelp ]
55 [ --nohints ]
56 [ --nolocking ]
57 [ --profile String ]
58 [ --version ]
59
61 -a|--all
62 --commandprofile String
64 The command profile to use for command configuration. See
65 lvm.conf(5) for more information about profiles.
66 --config String
68 Config settings for the command. These override lvm.conf(5) set‐
69 tings. The String arg uses the same format as lvm.conf(5), or
70 may use section/field syntax. See lvm.conf(5) for more informa‐
71 tion about config.
72 -d|--debug ...
74 Set debug level. Repeat from 1 to 6 times to increase the detail
75 of messages sent to the log file and/or syslog (if configured).
76 --devices PV
78 Restricts the devices that are visible and accessible to the
79 command. Devices not listed will appear to be missing. This op‐
80 tion can be repeated, or accepts a comma separated list of de‐
81 vices. This overrides the devices file.
82 --devicesfile String
84 A file listing devices that LVM should use. The file must exist
85 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
86 mand. This overrides the lvm.conf(5) devices/devicesfile and
87 devices/use_devicesfile settings.
88 --driverloaded y|n
90 If set to no, the command will not attempt to use device-mapper.
91 For testing and debugging.
92 --foreign
94 Report/display foreign VGs that would otherwise be skipped. See
95 lvmsystemid(7) for more information about foreign VGs.
96 -h|--help
98 Display help text.
99 --journal String
101 Record information in the systemd journal. This information is
102 in addition to information enabled by the lvm.conf log/journal
103 setting. command: record information about the command. out‐
104 put: record the default command output. debug: record full com‐
105 mand debugging.
106 --lockopt String
108 Used to pass options for special cases to lvmlockd. See lvm‐
109 lockd(8) for more information.
110 --longhelp
112 Display long help text.
113 --nohints
115 Do not use the hints file to locate devices for PVs. A command
116 may read more devices to find PVs when hints are not used. The
117 command will still perform standard hint file invalidation where
118 appropriate.
119 --nolocking
121 Disable locking. Use with caution, concurrent commands may pro‐
122 duce incorrect results.
123 --profile String
125 An alias for --commandprofile or --metadataprofile, depending on
126 the command.
127 -q|--quiet ...
129 Suppress output and log messages. Overrides --debug and --ver‐
130 bose. Repeat once to also suppress any prompts with answer
131 'no'.
132 --reportformat basic|json|json_std
134 Overrides current output format for reports which is defined
135 globally by the report/output_format setting in lvm.conf(5).
136 basic is the original format with columns and rows. If there is
137 more than one report per command, each report is prefixed with
138 the report name for identification. json produces report output
139 in JSON format. json_std produces report output in JSON format
140 which is more compliant with JSON standard. See lvmreport(7)
141 for more information.
142 -S|--select String
144 Select objects for processing and reporting based on specified
145 criteria. The criteria syntax is described by --select help and
146 lvmreport(7). For reporting commands, one row is displayed for
147 each object matching the criteria. See --options help for se‐
148 lectable object fields. Rows can be displayed with an addi‐
149 tional "selected" field (-o selected) showing 1 if the row
150 matches the selection and 0 otherwise. For non-reporting com‐
151 mands which process LVM entities, the selection is used to
152 choose items to process.
153 -t|--test
155 Run in test mode. Commands will not update metadata. This is
156 implemented by disabling all metadata writing but nevertheless
157 returning success to the calling function. This may lead to un‐
158 usual error messages in multi-stage operations if a tool relies
159 on reading back metadata it believes has changed but hasn't.
160 -v|--verbose ...
162 Set verbose level. Repeat from 1 to 4 times to increase the de‐
163 tail of messages sent to stdout and stderr.
164 --version
166 Display version information.
167 -y|--yes
169 Do not prompt for confirmation interactively but always assume
170 the answer yes. Use with extreme caution. (For automatic no,
171 see -qq.)
172
174 VG Volume Group name. See lvm(8) for valid names.
175 Tag Tag name. See lvm(8) for information about tag names and using
177 tags in place of a VG, LV or PV.
178 Select Select indicates that a required positional parameter can be
180 omitted if the --select option is used. No arg appears in this
181 position.
182 String See the option description for information about the string con‐
184 tent.
185 Size[UNIT]
187 Size is an input number that accepts an optional unit. Input
188 units are always treated as base two values, regardless of capi‐
189 talization, e.g. 'k' and 'K' both refer to 1024. The default
190 input unit is specified by letter, followed by |UNIT. UNIT rep‐
191 resents other possible input units: b|B is bytes, s|S is sectors
192 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
193 p|P is PiB, e|E is EiB. (This should not be confused with the
194 output control --units, where capital letters mean multiple of
195 1000.)
196
198 See lvm(8) for information about environment variables used by lvm.
199 For example, LVM_VG_NAME can generally be substituted for a required VG
200 parameter.
201
203 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
204 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
206 pvremove(8), pvresize(8), pvs(8), pvscan(8),
207 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
209 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
210 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
211 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
212 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
214 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
215 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
217 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
219 lvmdbusd(8), fsadm(8),
220 lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
222 lvmvdo(7), lvmautoactivation(7)
223Red Hat, Inc. LVM TOOLS 2.03.22(2) (2023-08-02) VGIMPORTDEVICES(8)