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

NAME

6       vgremove — Remove volume group(s)
7

SYNOPSIS

9       vgremove position_args
10           [ option_args ]
11

DESCRIPTION

13       vgremove  removes  one or more VGs. If LVs exist in the VG, a prompt is
14       used to confirm LV removal.
15
16       If one or more PVs in the VG are lost, consider vgreduce  --removemiss‐
17       ing to make the VG metadata consistent again.
18
19       Repeat  the force option (-ff) to forcibly remove LVs in the VG without
20       confirmation.
21

USAGE

23       vgremove VG|Tag|Select ...
24           [ -f|--force ]
25           [ -S|--select String ]
26           [    --noudevsync ]
27           [    --reportformat basic|json|json_std ]
28           [ COMMON_OPTIONS ]
29
30       Common options for lvm:
31           [ -d|--debug ]
32           [ -h|--help ]
33           [ -q|--quiet ]
34           [ -t|--test ]
35           [ -v|--verbose ]
36           [ -y|--yes ]
37           [    --commandprofile String ]
38           [    --config String ]
39           [    --devices PV ]
40           [    --devicesfile String ]
41           [    --driverloaded y|n ]
42           [    --journal String ]
43           [    --lockopt String ]
44           [    --longhelp ]
45           [    --nohints ]
46           [    --nolocking ]
47           [    --profile String ]
48           [    --version ]
49

OPTIONS

51       --commandprofile String
52              The command profile  to  use  for  command  configuration.   See
53              lvm.conf(5) for more information about profiles.
54
55       --config String
56              Config settings for the command. These override lvm.conf(5) set‐
57              tings.  The String arg uses the same format as  lvm.conf(5),  or
58              may use section/field syntax.  See lvm.conf(5) for more informa‐
59              tion about config.
60
61       -d|--debug ...
62              Set debug level. Repeat from 1 to 6 times to increase the detail
63              of messages sent to the log file and/or syslog (if configured).
64
65       --devices PV
66              Restricts  the  devices  that  are visible and accessible to the
67              command.  Devices not listed will appear to be missing. This op‐
68              tion  can  be repeated, or accepts a comma separated list of de‐
69              vices. This overrides the devices file.
70
71       --devicesfile String
72              A file listing devices that LVM should use.  The file must exist
73              in  /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
74              mand.  This overrides the  lvm.conf(5)  devices/devicesfile  and
75              devices/use_devicesfile settings.
76
77       --driverloaded y|n
78              If set to no, the command will not attempt to use device-mapper.
79              For testing and debugging.
80
81       -f|--force ...
82              Override various checks,  confirmations  and  protections.   Use
83              with extreme caution.
84
85       -h|--help
86              Display help text.
87
88       --journal String
89              Record  information in the systemd journal.  This information is
90              in addition to information enabled by the  lvm.conf  log/journal
91              setting.   command:  record information about the command.  out‐
92              put: record the default command output.  debug: record full com‐
93              mand debugging.
94
95       --lockopt String
96              Used  to  pass  options for special cases to lvmlockd.  See lvm‐
97              lockd(8) for more information.
98
99       --longhelp
100              Display long help text.
101
102       --nohints
103              Do not use the hints file to locate devices for PVs.  A  command
104              may  read  more devices to find PVs when hints are not used. The
105              command will still perform standard hint file invalidation where
106              appropriate.
107
108       --nolocking
109              Disable  locking. Use with caution, concurrent commands may pro‐
110              duce incorrect results.
111
112       --noudevsync
113              Disables udev synchronisation. The process will not wait for no‐
114              tification  from udev. It will continue irrespective of any pos‐
115              sible udev processing in the background. Only use this  if  udev
116              is not running or has rules that ignore the devices LVM creates.
117
118       --profile String
119              An alias for --commandprofile or --metadataprofile, depending on
120              the command.
121
122       -q|--quiet ...
123              Suppress output and log messages. Overrides --debug  and  --ver‐
124              bose.   Repeat  once  to  also  suppress any prompts with answer
125              'no'.
126
127       --reportformat basic|json|json_std
128              Overrides current output format for  reports  which  is  defined
129              globally  by  the  report/output_format  setting in lvm.conf(5).
130              basic is the original format with columns and rows.  If there is
131              more  than  one report per command, each report is prefixed with
132              the report name for identification. json produces report  output
133              in  JSON  format. json_std produces report output in JSON format
134              which is more compliant with JSON  standard.   See  lvmreport(7)
135              for more information.
136
137       -S|--select String
138              Select  objects  for processing and reporting based on specified
139              criteria.  The criteria syntax is described by --select help and
140              lvmreport(7).   For reporting commands, one row is displayed for
141              each object matching the criteria.  See --options help  for  se‐
142              lectable  object  fields.   Rows  can be displayed with an addi‐
143              tional "selected" field (-o  selected)  showing  1  if  the  row
144              matches  the  selection and 0 otherwise.  For non-reporting com‐
145              mands which process LVM  entities,  the  selection  is  used  to
146              choose items to process.
147
148       -t|--test
149              Run  in  test  mode. Commands will not update metadata.  This is
150              implemented by disabling all metadata writing  but  nevertheless
151              returning  success to the calling function. This may lead to un‐
152              usual error messages in multi-stage operations if a tool  relies
153              on reading back metadata it believes has changed but hasn't.
154
155       -v|--verbose ...
156              Set  verbose level. Repeat from 1 to 4 times to increase the de‐
157              tail of messages sent to stdout and stderr.
158
159       --version
160              Display version information.
161
162       -y|--yes
163              Do not prompt for confirmation interactively but  always  assume
164              the  answer  yes.  Use with extreme caution.  (For automatic no,
165              see -qq.)
166

VARIABLES

168       VG     Volume Group name.  See lvm(8) for valid names.
169
170       Tag    Tag name.  See lvm(8) for information about tag names and  using
171              tags in place of a VG, LV or PV.
172
173       Select Select  indicates  that  a  required positional parameter can be
174              omitted if the --select option is used.  No arg appears in  this
175              position.
176
177       String See the option description for information about the string con‐
178              tent.
179
180       Size[UNIT]
181              Size is an input number that accepts an  optional  unit.   Input
182              units are always treated as base two values, regardless of capi‐
183              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
184              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
185              resents other possible input units: b|B is bytes, s|S is sectors
186              of  512  bytes,  k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
187              p|P is PiB, e|E is EiB.  (This should not be confused  with  the
188              output  control  --units, where capital letters mean multiple of
189              1000.)
190

ENVIRONMENT VARIABLES

192       See lvm(8) for information about environment  variables  used  by  lvm.
193       For example, LVM_VG_NAME can generally be substituted for a required VG
194       parameter.
195

SEE ALSO

197       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
198
199       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
200       pvremove(8), pvresize(8), pvs(8), pvscan(8),
201
202       vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
203       vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
204       vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
205       vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
206
207       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
208       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
209
210       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
211
212       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
213       lvmdbusd(8), fsadm(8),
214
215       lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
216
217
218
219Red Hat, Inc.        LVM TOOLS 2.03.18(2)-git (2022-11-10)         VGREMOVE(8)
Impressum