1PVCHANGE(8) System Manager's Manual PVCHANGE(8)
2
6 pvchange — Change attributes of physical volume(s)
7
9 pvchange option_args position_args
10 [ option_args ]
11
13 pvchange changes PV attributes in the VG.
14 For options listed in parentheses, any one is required, after which the
16 others are optional.
17
19 Change properties of all PVs.
20 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 Change properties of specified PVs.
30 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 Common options for command:
42 [ -A|--autobackup y|n ]
43 [ -f|--force ]
44 [ -u|--uuid ]
45 [ --reportformat basic|json|json_std ]
46 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
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 -a|--all
73 Change all visible PVs.
74 -x|--allocatable y|n
76 Enable or disable allocation of physical extents on this PV.
77 -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 --commandprofile String
84 The command profile to use for command configuration. See
85 lvm.conf(5) for more information about profiles.
86 --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 -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 --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 --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 --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 --driverloaded y|n
115 If set to no, the command will not attempt to use device-mapper.
116 For testing and debugging.
117 -f|--force ...
119 Override various checks, confirmations and protections. Use
120 with extreme caution.
121 -h|--help
123 Display help text.
124 --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 --lockopt String
133 Used to pass options for special cases to lvmlockd. See lvm‐
134 lockd(8) for more information.
135 --longhelp
137 Display long help text.
138 --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 --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 --nolocking
152 Disable locking. Use with caution, concurrent commands may pro‐
153 duce incorrect results.
154 --profile String
156 An alias for --commandprofile or --metadataprofile, depending on
157 the command.
158 -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 --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 -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 -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 -u|--uuid
193 Generate new random UUID for specified PVs.
194 -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 --version
200 Display version information.
201 -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
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 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 String See the option description for information about the string con‐
221 tent.
222 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
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
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
245 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
246 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
248 pvremove(8), pvresize(8), pvs(8), pvscan(8),
249 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 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
256 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
257 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
259 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
261 lvmdbusd(8), fsadm(8),
262 lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
264 lvmvdo(7), lvmautoactivation(7)
265Red Hat, Inc. LVM TOOLS 2.03.22(2) (2023-08-02) PVCHANGE(8)