pvchange(8)

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 ]
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           [    --driverloaded y|n ]
57           [    --lockopt String ]
58           [    --longhelp ]
59           [    --nolocking ]
60           [    --profile String ]
61           [    --version ]
62

OPTIONS

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

VARIABLES

176       PV
177              Physical  Volume  name,  a device path under /dev.  For commands
178              managing physical extents, a PV positional arg generally accepts
179              a suffix indicating a range (or multiple ranges) of physical ex‐
180              tents (PEs). When the first PE is omitted, it  defaults  to  the
181              start of the device, and when the last PE is omitted it defaults
182              to end.  Start and end range (inclusive):  PV[:PE-PE]...   Start
183              and length range (counting from 0): PV[:PE+PE]...
184
185       Select
186              Select  indicates  that  a  required positional parameter can be
187              omitted if the --select option is used.  No arg appears in  this
188              position.
189
190       String
191              See the option description for information about the string con‐
192              tent.
193
194       Size[UNIT]
195              Size is an input number that accepts an  optional  unit.   Input
196              units are always treated as base two values, regardless of capi‐
197              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
198              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
199              resents other possible input units:  bBsSkKmMgGtTpPeE.   b|B  is
200              bytes,  s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G
201              is GiB, t|T is TiB, p|P is PiB, e|E is EiB.  (This should not be
202              confused  with the output control --units, where capital letters
203              mean multiple of 1000.)
204

ENVIRONMENT VARIABLES

206       See lvm(8) for information about environment  variables  used  by  lvm.
207       For example, LVM_VG_NAME can generally be substituted for a required VG
208       parameter.
209

EXAMPLES

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