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
147              selectable 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
157              unusual error messages in multi-stage operations if a tool
158              relies on reading back metadata it believes has changed but
159              hasn't.
160
161       -u|--uuid
162              Generate new random UUID for specified PVs.
163
164       -v|--verbose ...
165              Set verbose level. Repeat from 1 to 4 times to increase the
166              detail of messages sent to stdout and stderr.
167
168       --version
169              Display version information.
170
171       -y|--yes
172              Do not prompt for confirmation interactively but always assume
173              the answer yes. Use with extreme caution.  (For automatic no,
174              see -qq.)
175

VARIABLES

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

ENVIRONMENT VARIABLES

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

EXAMPLES

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