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

OPTIONS

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

VARIABLES

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

ENVIRONMENT VARIABLES

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

EXAMPLES

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