GROWFS(1M)

NAME

growfs − non-destructively expand a mounted file system

SYNOPSIS

/usr/opt/SUNWmd/sbin/growfs [ −M directory-name ] [ newfs-options ] raw-special-device

AVAILABILITY

This program is available with the Solstice DiskSuite software package (SUNWmd).

DESCRIPTION

growfs non-destructively expands a mounted or unmounted file system up to the size of the file system’s partition. growfs is a “friendly” front-end to the mkfs(1M) program.

This command is most often used after a metadevice has been expanded using metattach(1M).

growfs will “write-lock” (see lockfs(1M)) a mounted file system when expanding. The length of time the file system is write-locked can be shortened by expanding the file system in stages. For instance, to expand a 1 Gbyte file system to 2 Gbytes, the file system can be grown in 16 Mbyte stages. To do this, use the -s option to specify the total size of the new file system at each stage. The argument for -s is the number of sectors, and must be a multiple of the cylinder size.

Note that growfs displays the same information as mkfs(1M) during the expansion of the file system. This is normal behavior for growfs.

You must be super-user to use this command.

If growfs is aborted, the user can recover any lost free space by unmounting the file system and running fsck(1M), or the user can issue the growfs command again.

OPTIONS

-M directory-name
The file system to be expanded is mounted on directory name. File system locking (lockfs) will be used.

newfs-options
The options are documented in the newfs man page.

raw-special-device
is the name of a raw special device residing in /dev, including the disk partition, where you want the file system to be grown.

EXAMPLES

The following example verbosely displays the parameters for the raw special device, /dev/rdsk/c0t1d0s0, but does not actually expand the unmounted file system:

example% growfs −vN /dev/rdsk/c0t1d0s0
mkfs −G −N /dev/rdsk/c0t1d0s0 16048 34 8 8192 1024 16 10 60 2048 t 0 -1
/dev/rdsk/c0t1d0s0: 16048 sectors in 59 cylinders of 8 tracks, 34 sectors
8.2Mb in 4 cyl groups (16 c/g, 2.23Mb/g, 896 i/g)
super-block backups (for fsck −b#) at:
32, 4432, 8832, 13232,
example%

The following example shows how growfs is used to expand the file system /dev/rdsk/c0t2d0s0 mounted on /var.

example% growfs −M /var /dev/rdsk/c0t2d0s0
/dev/rdsk/c0t2d0s0: 16048 sectors in 59 cylinders of 8 tracks, 34 sectors
8.2Mb in 4 cyl groups (16 c/g, 2.23Mb/g, 896 i/g)
super-block backups (for fsck −b#) at:
32, 4432, 8832, 13232,
example%

Museum

Related Articles