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           [    --reportformat basic|json ]
47
48       Common options for lvm:
49           [ -d|--debug ]
50           [ -h|--help ]
51           [ -q|--quiet ]
52           [ -t|--test ]
53           [ -v|--verbose ]
54           [ -y|--yes ]
55           [    --commandprofile String ]
56           [    --config String ]
57           [    --driverloaded y|n ]
58           [    --lockopt String ]
59           [    --longhelp ]
60           [    --nolocking ]
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       --lockopt String
111              Used to pass options for special cases to lvmlockd.  See lvm‐
112              lockd(8) for more information.
113
114       --longhelp
115              Display long help text.
116
117       --metadataignore y|n
118              Specifies the metadataignore property of a PV.  If yes, metadata
119              areas on the PV are ignored, and lvm will not store metadata in
120              the metadata areas of the PV.  If no, lvm will store metadata on
121              the PV.
122
123       --nolocking
124              Disable locking.
125
126       --profile String
127              An alias for --commandprofile or --metadataprofile, depending on
128              the command.
129
130       -q|--quiet ...
131              Suppress output and log messages. Overrides --debug and --ver‐
132              bose.  Repeat once to also suppress any prompts with answer
133              'no'.
134
135       --reportformat basic|json
136              Overrides current output format for reports which is defined
137              globally by the report/output_format setting in lvm.conf.  basic
138              is the original format with columns and rows.  If there is more
139              than one report per command, each report is prefixed with the
140              report name for identification. json produces report output in
141              JSON format. See lvmreport(7) for more information.
142
143       -S|--select String
144              Select objects for processing and reporting based on specified
145              criteria.  The criteria syntax is described by --select help and
146              lvmreport(7).  For reporting commands, one row is displayed for
147              each object matching the criteria.  See --options help for
148              selectable object fields.  Rows can be displayed with an addi‐
149              tional "selected" field (-o selected) showing 1 if the row
150              matches the selection and 0 otherwise.  For non-reporting com‐
151              mands which process LVM entities, the selection is used to
152              choose items to process.
153
154       -t|--test
155              Run in test mode. Commands will not update metadata.  This is
156              implemented by disabling all metadata writing but nevertheless
157              returning success to the calling function. This may lead to
158              unusual error messages in multi-stage operations if a tool
159              relies on reading back metadata it believes has changed but
160              hasn't.
161
162       -u|--uuid
163              Generate new random UUID for specified PVs.
164
165       -v|--verbose ...
166              Set verbose level. Repeat from 1 to 4 times to increase the
167              detail of messages sent to stdout and stderr.
168
169       --version
170              Display version information.
171
172       -y|--yes
173              Do not prompt for confirmation interactively but always assume
174              the answer yes. Use with extreme caution.  (For automatic no,
175              see -qq.)
176

VARIABLES

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

ENVIRONMENT VARIABLES

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

EXAMPLES

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