vgremove(8)

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 ]
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           [    --driverloaded y|n ]
40           [    --lockopt String ]
41           [    --longhelp ]
42           [    --profile String ]
43           [    --version ]
44

OPTIONS

46       --commandprofile String
47              The command profile to use for command configuration.  See
48              lvm.conf(5) for more information about profiles.
49
50       --config String
51              Config settings for the command. These override lvm.conf set‐
52              tings.  The String arg uses the same format as lvm.conf, or may
53              use section/field syntax.  See lvm.conf(5) for more information
54              about config.
55
56       -d|--debug ...
57              Set debug level. Repeat from 1 to 6 times to increase the detail
58              of messages sent to the log file and/or syslog (if configured).
59
60       --driverloaded y|n
61              If set to no, the command will not attempt to use device-mapper.
62              For testing and debugging.
63
64       -f|--force ...
65              Override various checks, confirmations and protections.  Use
66              with extreme caution.
67
68       -h|--help
69              Display help text.
70
71       --lockopt String
72              Used to pass options for special cases to lvmlockd.  See lvm‐
73              lockd(8) for more information.
74
75       --longhelp
76              Display long help text.
77
78       --noudevsync
79              Disables udev synchronisation. The process will not wait for
80              notification from udev. It will continue irrespective of any
81              possible udev processing in the background. Only use this if
82              udev is not running or has rules that ignore the devices LVM
83              creates.
84
85       --profile String
86              An alias for --commandprofile or --metadataprofile, depending on
87              the command.
88
89       -q|--quiet ...
90              Suppress output and log messages. Overrides --debug and --ver‐
91              bose.  Repeat once to also suppress any prompts with answer
92              'no'.
93
94       --reportformat basic|json
95              Overrides current output format for reports which is defined
96              globally by the report/output_format setting in lvm.conf.  basic
97              is the original format with columns and rows.  If there is more
98              than one report per command, each report is prefixed with the
99              report name for identification. json produces report output in
100              JSON format. See lvmreport(7) for more information.
101
102       -S|--select String
103              Select objects for processing and reporting based on specified
104              criteria.  The criteria syntax is described by --select help and
105              lvmreport(7).  For reporting commands, one row is displayed for
106              each object matching the criteria.  See --options help for
107              selectable object fields.  Rows can be displayed with an addi‐
108              tional "selected" field (-o selected) showing 1 if the row
109              matches the selection and 0 otherwise.  For non-reporting com‐
110              mands which process LVM entities, the selection is used to
111              choose items to process.
112
113       -t|--test
114              Run in test mode. Commands will not update metadata.  This is
115              implemented by disabling all metadata writing but nevertheless
116              returning success to the calling function. This may lead to
117              unusual error messages in multi-stage operations if a tool
118              relies on reading back metadata it believes has changed but
119              hasn't.
120
121       -v|--verbose ...
122              Set verbose level. Repeat from 1 to 4 times to increase the
123              detail of messages sent to stdout and stderr.
124
125       --version
126              Display version information.
127
128       -y|--yes
129              Do not prompt for confirmation interactively but always assume
130              the answer yes. Use with extreme caution.  (For automatic no,
131              see -qq.)
132

VARIABLES

134       VG
135              Volume Group name.  See lvm(8) for valid names.
136
137       Tag
138              Tag name.  See lvm(8) for information about tag names and  using
139              tags in place of a VG, LV or PV.
140
141       Select
142              Select  indicates  that  a  required positional parameter can be
143              omitted if the --select option is used.  No arg appears in  this
144              position.
145
146       String
147              See the option description for information about the string con‐
148              tent.
149
150       Size[UNIT]
151              Size is an input number that accepts an  optional  unit.   Input
152              units are always treated as base two values, regardless of capi‐
153              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
154              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
155              resents other possible input units:  bBsSkKmMgGtTpPeE.   b|B  is
156              bytes,  s|S  is  sectors  of 512 bytes, k|K is kilobytes, m|M is
157              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
158              e|E  is  exabytes.  (This should not be confused with the output
159              control --units, where capital letters mean multiple of 1000.)
160

ENVIRONMENT VARIABLES

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