pvresize(8)

1PVRESIZE(8)                 System Manager's Manual                PVRESIZE(8)
2
3
4

NAME

6       pvresize - Resize physical volume(s)
7

SYNOPSIS

9       pvresize position_args
10           [ option_args ]
11

DESCRIPTION

13       pvresize  resizes  a  PV.  The  PV  may already be in a VG and may have
14       active LVs allocated on it.
15

USAGE

17       pvresize PV ...
18           [    --setphysicalvolumesize Size[m|UNIT] ]
19           [    --reportformat basic|json ]
20           [ COMMON_OPTIONS ]
21
22       Common options for lvm:
23           [ -d|--debug ]
24           [ -h|--help ]
25           [ -q|--quiet ]
26           [ -t|--test ]
27           [ -v|--verbose ]
28           [ -y|--yes ]
29           [    --commandprofile String ]
30           [    --config String ]
31           [    --driverloaded y|n ]
32           [    --lockopt String ]
33           [    --longhelp ]
34           [    --nolocking ]
35           [    --profile String ]
36           [    --version ]
37

OPTIONS

39       --commandprofile String
40              The command profile to use for command configuration.  See
41              lvm.conf(5) for more information about profiles.
42
43       --config String
44              Config settings for the command. These override lvm.conf set‐
45              tings.  The String arg uses the same format as lvm.conf, or may
46              use section/field syntax.  See lvm.conf(5) for more information
47              about config.
48
49       -d|--debug ...
50              Set debug level. Repeat from 1 to 6 times to increase the detail
51              of messages sent to the log file and/or syslog (if configured).
52
53       --driverloaded y|n
54              If set to no, the command will not attempt to use device-mapper.
55              For testing and debugging.
56
57       -h|--help
58              Display help text.
59
60       --lockopt String
61              Used to pass options for special cases to lvmlockd.  See lvm‐
62              lockd(8) for more information.
63
64       --longhelp
65              Display long help text.
66
67       --nolocking
68              Disable locking.
69
70       --profile String
71              An alias for --commandprofile or --metadataprofile, depending on
72              the command.
73
74       -q|--quiet ...
75              Suppress output and log messages. Overrides --debug and --ver‐
76              bose.  Repeat once to also suppress any prompts with answer
77              'no'.
78
79       --reportformat basic|json
80              Overrides current output format for reports which is defined
81              globally by the report/output_format setting in lvm.conf.  basic
82              is the original format with columns and rows.  If there is more
83              than one report per command, each report is prefixed with the
84              report name for identification. json produces report output in
85              JSON format. See lvmreport(7) for more information.
86
87       --setphysicalvolumesize Size[m|UNIT]
88              Overrides the automatically detected size of the PV.  Use with
89              care, or prior to reducing the physical size of the device.
90
91       -t|--test
92              Run in test mode. Commands will not update metadata.  This is
93              implemented by disabling all metadata writing but nevertheless
94              returning success to the calling function. This may lead to
95              unusual error messages in multi-stage operations if a tool
96              relies on reading back metadata it believes has changed but
97              hasn't.
98
99       -v|--verbose ...
100              Set verbose level. Repeat from 1 to 4 times to increase the
101              detail of messages sent to stdout and stderr.
102
103       --version
104              Display version information.
105
106       -y|--yes
107              Do not prompt for confirmation interactively but always assume
108              the answer yes. Use with extreme caution.  (For automatic no,
109              see -qq.)
110

VARIABLES

112       PV
113              Physical Volume name, a device path under  /dev.   For  commands
114              managing physical extents, a PV positional arg generally accepts
115              a suffix indicating a range (or  multiple  ranges)  of  physical
116              extents  (PEs). When the first PE is omitted, it defaults to the
117              start of the device, and when the last PE is omitted it defaults
118              to  end.   Start and end range (inclusive): PV[:PE-PE]...  Start
119              and length range (counting from 0): PV[:PE+PE]...
120
121       String
122              See the option description for information about the string con‐
123              tent.
124
125       Size[UNIT]
126              Size  is  an  input number that accepts an optional unit.  Input
127              units are always treated as base two values, regardless of capi‐
128              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
129              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
130              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
131              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
132              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
133              e|E is exabytes.  (This should not be confused with  the  output
134              control --units, where capital letters mean multiple of 1000.)
135

ENVIRONMENT VARIABLES

137       See  lvm(8)  for  information  about environment variables used by lvm.
138       For example, LVM_VG_NAME can generally be substituted for a required VG
139       parameter.
140

NOTES

142       pvresize  will refuse to shrink a PV if it has allocated extents beyond
143       the new end.
144

EXAMPLES

146       Expand a PV after enlarging the partition.
147       pvresize /dev/sda1
148
149       Shrink a PV prior to shrinking the partition (ensure that the  PV  size
150       is appropriate for the intended new partition size).
151       pvresize --setphysicalvolumesize 40G /dev/sda1
152