Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LVEXTEND(8)		    System Manager's Manual		   LVEXTEND(8)

NAME
       lvextend	-- extend the size of a	logical	volume

SYNOPSIS
       lvextend	[--alloc AllocationPolicy] [-A|--autobackup {y|n}] [--command-
       profile	 ProfileName]	[-d|--debug]	[-h|-?|--help]	  [-f|--force]
       [-i|--stripes   Stripes	 [-I|--stripesize  StripeSize]]	 {-l|--extents
       [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}] | -L|--size  [+]Logi-
       calVolumeSize[bBsSkKmMgGtTpPeE]}	[-n|--nofsck] [--noudevsync] [-r|--re-
       sizefs] [--use-policies]	[-t|--test]  [-v|--verbose]  LogicalVolumePath
       [PhysicalVolumePath[:PE[-PE]]...]

DESCRIPTION
       lvextend	 allows	you to extend the size of a logical volume.  Extension
       of snapshot logical volumes (see	lvcreate(8) for	information to	create
       snapshots) is supported as well.	 But to	change the number of copies in
       a mirrored logical volume use lvconvert(8).

OPTIONS
       See lvm(8) for common options.

       -f, --force
	      Proceed with size	extension without prompting.

       -l, --extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]
	      Extend or	set the	logical	volume size in units  of  logical  ex-
	      tents.   With the	'+' sign the value is added to the actual size
	      of the logical volume and	without	it, the	value is taken	as  an
	      absolute	one.   The  total number of physical extents allocated
	      will be greater than this, for example, if the  volume  is  mir-
	      rored.   The number can also be expressed	as a percentage	of the
	      total space in the Volume	Group with the suffix %VG, relative to
	      the  existing size of the	Logical	Volume with the	suffix %LV, of
	      the remaining free space	for  the  specified  PhysicalVolume(s)
	      with  the	 suffix	 %PVS,	as  a percentage of the	remaining free
	      space in the Volume Group	with the suffix	%FREE, or (for a snap-
	      shot)  as	 a percentage of the total space in the	Origin Logical
	      Volume with the suffix %ORIGIN.  The resulting value is  rounded
	      upward.	N.B. In	a future release, when expressed as a percent-
	      age with PVS, VG or FREE,	the number will	be treated as  an  ap-
	      proximate	 upper	limit for the total number of physical extents
	      to be allocated (including extents used by any mirrors, for  ex-
	      ample).	The  code  may	currently allocate more	space than you
	      might otherwise expect.

       -L, --size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
	      Extend or	set the	logical	volume size in units of	megabytes.   A
	      size  suffix  of	M  for	megabytes, G for gigabytes, T for ter-
	      abytes, P	for petabytes or E for exabytes	is optional.  With the
	      +	sign the value is added	to the actual size of the logical vol-
	      ume and without it, the value is taken as	an absolute one.

       -i, --stripes Stripes
	      Gives the	number of stripes for the extension.   Not  applicable
	      to  LVs using the	original metadata LVM format, which must use a
	      single value throughout.

       -I, --stripesize	StripeSize
	      Gives the	 number	 of  kilobytes	for  the  granularity  of  the
	      stripes.	 Not applicable	to LVs using the original metadata LVM
	      format, which must use a single value throughout.
	      StripeSize must be 2^n (n	= 2 to 9)

       -n, --nofsck
	      Do not perform fsck before extending filesystem when  filesystem
	      requires	it.  You  may need to use --force to proceed with this
	      option.

       --noudevsync
	      Disable udev synchronisation. The	process	will not wait for  no-
	      tification from udev.  It	will continue irrespective of any pos-
	      sible udev processing in the background.	You  should  only  use
	      this if udev is not running or has rules that ignore the devices
	      LVM2 creates.

       -r, --resizefs
	      Resize underlying	filesystem together with  the  logical	volume
	      using fsadm(8).

       --use-policies
	      Resizes  the  logical volume according to	configured policy. See
	      lvm.conf(5) for some details.

Examples
       Extends the size	of the logical volume "vg01/lvol10" by 54MiB on	physi-
       cal volume /dev/sdk3. This is only possible if /dev/sdk3	is a member of
       volume group vg01 and there are enough free physical extents in it:

       lvextend	-L +54 /dev/vg01/lvol10	/dev/sdk3

       Extends the size	of logical volume "vg01/lvol01"	by the amount of  free
       space  on  physical  volume /dev/sdk3. This is equivalent to specifying
       "-l +100%PVS" on	the command line:

       lvextend	/dev/vg01/lvol01 /dev/sdk3

       Extends a logical volume	"vg01/lvol01" by 16MiB using physical  extents
       /dev/sda:8-9 and	/dev/sdb:8-9 for allocation of extents:

       lvextend	-L+16M vg01/lvol01 /dev/sda:8-9	/dev/sdb:8-9

SEE ALSO
       fsadm(8),  lvm(8), lvm.conf(5), lvcreate(8), lvconvert(8), lvreduce(8),
       lvresize(8), lvchange(8)

Sistina	Software UKLVM TOOLS 2.02.115(2)-RHEL7 (2015-01-28)	   LVEXTEND(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | Examples | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lvextend&sektion=8&manpath=CentOS+7.1>

home | help