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

NAME

6       pvchange — Change attributes of physical volume(s)
7

SYNOPSIS

9       pvchange option_args position_args
10           [ option_args ]
11

DESCRIPTION

13       pvchange changes PV attributes in the VG.
14
15       For options listed in parentheses, any one is required, after which the
16       others are optional.
17

USAGE

19       Change properties of all PVs.
20
21       pvchange -a|--all
22           ( -x|--allocatable y|n
23             -u|--uuid
24                --addtag Tag
25                --deltag Tag
26                --metadataignore y|n )
27           [ COMMON_OPTIONS ]
28
29       Change properties of specified PVs.
30
31       pvchange
32           ( -x|--allocatable y|n
33             -u|--uuid
34                --addtag Tag
35                --deltag Tag
36                --metadataignore y|n )
37            PV|Select ...
38           [ -S|--select String ]
39           [ COMMON_OPTIONS ]
40
41       Common options for command:
42           [ -A|--autobackup y|n ]
43           [ -f|--force ]
44           [ -u|--uuid ]
45           [    --reportformat basic|json|json_std ]
46
47       Common options for lvm:
48           [ -d|--debug ]
49           [ -h|--help ]
50           [ -q|--quiet ]
51           [ -t|--test ]
52           [ -v|--verbose ]
53           [ -y|--yes ]
54           [    --commandprofile String ]
55           [    --config String ]
56           [    --devices PV ]
57           [    --devicesfile String ]
58           [    --driverloaded y|n ]
59           [    --journal String ]
60           [    --lockopt String ]
61           [    --longhelp ]
62           [    --nohints ]
63           [    --nolocking ]
64           [    --profile String ]
65           [    --version ]
66

OPTIONS

68       --addtag Tag
69              Adds a tag to a PV, VG or LV. This option can be repeated to add
70              multiple tags at once. See lvm(8) for information about tags.
71
72       -a|--all
73              Change all visible PVs.
74
75       -x|--allocatable y|n
76              Enable or disable allocation of physical extents on this PV.
77
78       -A|--autobackup y|n
79              Specifies  if metadata should be backed up automatically after a
80              change.  Enabling this is strongly advised!  See  vgcfgbackup(8)
81              for more information.
82
83       --commandprofile String
84              The  command  profile  to  use  for  command configuration.  See
85              lvm.conf(5) for more information about profiles.
86
87       --config String
88              Config settings for the command. These override lvm.conf(5) set‐
89              tings.   The  String arg uses the same format as lvm.conf(5), or
90              may use section/field syntax.  See lvm.conf(5) for more informa‐
91              tion about config.
92
93       -d|--debug ...
94              Set debug level. Repeat from 1 to 6 times to increase the detail
95              of messages sent to the log file and/or syslog (if configured).
96
97       --deltag Tag
98              Deletes a tag from a PV, VG or LV. This option can  be  repeated
99              to  delete  multiple  tags  at  once. See lvm(8) for information
100              about tags.
101
102       --devices PV
103              Restricts the devices that are visible  and  accessible  to  the
104              command.  Devices not listed will appear to be missing. This op‐
105              tion can be repeated, or accepts a comma separated list  of  de‐
106              vices. This overrides the devices file.
107
108       --devicesfile String
109              A file listing devices that LVM should use.  The file must exist
110              in /etc/lvm/devices/ and is managed with the lvmdevices(8)  com‐
111              mand.   This  overrides  the lvm.conf(5) devices/devicesfile and
112              devices/use_devicesfile settings.
113
114       --driverloaded y|n
115              If set to no, the command will not attempt to use device-mapper.
116              For testing and debugging.
117
118       -f|--force ...
119              Override  various  checks,  confirmations  and protections.  Use
120              with extreme caution.
121
122       -h|--help
123              Display help text.
124
125       --journal String
126              Record information in the systemd journal.  This information  is
127              in  addition  to information enabled by the lvm.conf log/journal
128              setting.  command: record information about the  command.   out‐
129              put: record the default command output.  debug: record full com‐
130              mand debugging.
131
132       --lockopt String
133              Used to pass options for special cases to  lvmlockd.   See  lvm‐
134              lockd(8) for more information.
135
136       --longhelp
137              Display long help text.
138
139       --metadataignore y|n
140              Specifies the metadataignore property of a PV.  If yes, metadata
141              areas on the PV are ignored, and lvm will not store metadata  in
142              the metadata areas of the PV.  If no, lvm will store metadata on
143              the PV.
144
145       --nohints
146              Do not use the hints file to locate devices for PVs.  A  command
147              may  read  more devices to find PVs when hints are not used. The
148              command will still perform standard hint file invalidation where
149              appropriate.
150
151       --nolocking
152              Disable  locking. Use with caution, concurrent commands may pro‐
153              duce incorrect results.
154
155       --profile String
156              An alias for --commandprofile or --metadataprofile, depending on
157              the command.
158
159       -q|--quiet ...
160              Suppress  output  and log messages. Overrides --debug and --ver‐
161              bose.  Repeat once to also  suppress  any  prompts  with  answer
162              'no'.
163
164       --reportformat basic|json|json_std
165              Overrides  current  output  format  for reports which is defined
166              globally by the  report/output_format  setting  in  lvm.conf(5).
167              basic is the original format with columns and rows.  If there is
168              more than one report per command, each report is  prefixed  with
169              the  report name for identification. json produces report output
170              in JSON format. json_std produces report output in  JSON  format
171              which  is  more  compliant with JSON standard.  See lvmreport(7)
172              for more information.
173
174       -S|--select String
175              Select objects for processing and reporting based  on  specified
176              criteria.  The criteria syntax is described by --select help and
177              lvmreport(7).  For reporting commands, one row is displayed  for
178              each  object  matching the criteria.  See --options help for se‐
179              lectable object fields.  Rows can be  displayed  with  an  addi‐
180              tional  "selected"  field  (-o  selected)  showing  1 if the row
181              matches the selection and 0 otherwise.  For  non-reporting  com‐
182              mands  which  process  LVM  entities,  the  selection is used to
183              choose items to process.
184
185       -t|--test
186              Run in test mode. Commands will not update  metadata.   This  is
187              implemented  by  disabling all metadata writing but nevertheless
188              returning success to the calling function. This may lead to  un‐
189              usual  error messages in multi-stage operations if a tool relies
190              on reading back metadata it believes has changed but hasn't.
191
192       -u|--uuid
193              Generate new random UUID for specified PVs.
194
195       -v|--verbose ...
196              Set verbose level. Repeat from 1 to 4 times to increase the  de‐
197              tail of messages sent to stdout and stderr.
198
199       --version
200              Display version information.
201
202       -y|--yes
203              Do  not  prompt for confirmation interactively but always assume
204              the answer yes. Use with extreme caution.   (For  automatic  no,
205              see -qq.)
206

VARIABLES

208       PV     Physical  Volume  name,  a device path under /dev.  For commands
209              managing physical extents, a PV positional arg generally accepts
210              a suffix indicating a range (or multiple ranges) of physical ex‐
211              tents (PEs). When the first PE is omitted, it  defaults  to  the
212              start of the device, and when the last PE is omitted it defaults
213              to end.  Start and end range (inclusive):  PV[:PE-PE]...   Start
214              and length range (counting from 0): PV[:PE+PE]...
215
216       Select Select  indicates  that  a  required positional parameter can be
217              omitted if the --select option is used.  No arg appears in  this
218              position.
219
220       String See the option description for information about the string con‐
221              tent.
222
223       Size[UNIT]
224              Size is an input number that accepts an  optional  unit.   Input
225              units are always treated as base two values, regardless of capi‐
226              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
227              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
228              resents other possible input units: b|B is bytes, s|S is sectors
229              of  512  bytes,  k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
230              p|P is PiB, e|E is EiB.  (This should not be confused  with  the
231              output  control  --units, where capital letters mean multiple of
232              1000.)
233

ENVIRONMENT VARIABLES

235       See lvm(8) for information about environment  variables  used  by  lvm.
236       For example, LVM_VG_NAME can generally be substituted for a required VG
237       parameter.
238

EXAMPLES

240       Disallow the allocation of physical extents on a PV  (e.g.  because  of
241       disk errors, or because it will be removed after freeing it).
242       pvchange -x n /dev/sdk1
243

SEE ALSO

245       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
246
247       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
248       pvremove(8), pvresize(8), pvs(8), pvscan(8),
249
250       vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
251       vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
252       vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
253       vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
254
255       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
256       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
257
258       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
259
260       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
261       lvmdbusd(8), fsadm(8),
262
263       lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
264       lvmvdo(7), lvmautoactivation(7)
265
266
267
268
269Red Hat, Inc.          LVM TOOLS 2.03.22(2) (2023-08-02)           PVCHANGE(8)
Impressum