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

NAME

6       vgimportdevices — Add devices for a VG to the devices file.
7

SYNOPSIS

9       vgimportdevices option_args position_args
10           [ option_args ]
11

DESCRIPTION

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
19       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

USAGE

25       Add devices from specific VGs to the devices file.
26
27       vgimportdevices VG|Tag|Select ...
28           [ -S|--select String ]
29           [ COMMON_OPTIONS ]
30
31       Add devices from all accessible VGs to the devices file.
32
33       vgimportdevices -a|--all
34           [ COMMON_OPTIONS ]
35
36       Common options for command:
37           [    --foreign ]
38           [    --reportformat basic|json|json_std ]
39
40       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

OPTIONS

61       -a|--all
62
63       --commandprofile String
64              The command profile  to  use  for  command  configuration.   See
65              lvm.conf(5) for more information about profiles.
66
67       --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
73       -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
77       --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
83       --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
89       --driverloaded y|n
90              If set to no, the command will not attempt to use device-mapper.
91              For testing and debugging.
92
93       --foreign
94              Report/display foreign VGs that would otherwise be skipped.  See
95              lvmsystemid(7) for more information about foreign VGs.
96
97       -h|--help
98              Display help text.
99
100       --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
107       --lockopt String
108              Used  to  pass  options for special cases to lvmlockd.  See lvm‐
109              lockd(8) for more information.
110
111       --longhelp
112              Display long help text.
113
114       --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
120       --nolocking
121              Disable  locking. Use with caution, concurrent commands may pro‐
122              duce incorrect results.
123
124       --profile String
125              An alias for --commandprofile or --metadataprofile, depending on
126              the command.
127
128       -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
133       --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
143       -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
154       -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
161       -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
165       --version
166              Display version information.
167
168       -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

VARIABLES

174       VG     Volume Group name.  See lvm(8) for valid names.
175
176       Tag    Tag  name.  See lvm(8) for information about tag names and using
177              tags in place of a VG, LV or PV.
178
179       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
183       String See the option description for information about the string con‐
184              tent.
185
186       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

ENVIRONMENT VARIABLES

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

SEE ALSO

203       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
204
205       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
206       pvremove(8), pvresize(8), pvs(8), pvscan(8),
207
208       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
213       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
214       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
215
216       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
217
218       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
219       lvmdbusd(8), fsadm(8),
220
221       lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
222
223
224
225Red Hat, Inc.        LVM TOOLS 2.03.18(2)-git (2022-11-10)  VGIMPORTDEVICES(8)
Impressum