pvremove(8)

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

NAME

6       pvremove — Remove LVM label(s) from physical volume(s)
7

SYNOPSIS

9       pvremove position_args
10           [ option_args ]
11

DESCRIPTION

13       pvremove  wipes the label on a device so that LVM will no longer recog‐
14       nise it as a PV.
15
16       A PV cannot be removed from a VG while it is used by an active LV.
17
18       Repeat the force option (-ff) to forcibly remove a PV belonging  to  an
19       existing VG. Normally, vgreduce(8) should be used instead.
20

USAGE

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

OPTIONS

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

VARIABLES

148       PV     Physical Volume name, a device path under  /dev.   For  commands
149              managing physical extents, a PV positional arg generally accepts
150              a suffix indicating a range (or multiple ranges) of physical ex‐
151              tents  (PEs).  When  the first PE is omitted, it defaults to the
152              start of the device, and when the last PE is omitted it defaults
153              to  end.   Start and end range (inclusive): PV[:PE-PE]...  Start
154              and length range (counting from 0): PV[:PE+PE]...
155
156       String See the option description for information about the string con‐
157              tent.
158
159       Size[UNIT]
160              Size  is  an  input number that accepts an optional unit.  Input
161              units are always treated as base two values, regardless of capi‐
162              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
163              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
164              resents other possible input units: b|B is bytes, s|S is sectors
165              of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB,  t|T  is  TiB,
166              p|P  is  PiB, e|E is EiB.  (This should not be confused with the
167              output control --units, where capital letters mean  multiple  of
168              1000.)
169

ENVIRONMENT VARIABLES

171       See  lvm(8)  for  information  about environment variables used by lvm.
172       For example, LVM_VG_NAME can generally be substituted for a required VG
173       parameter.
174