growfs(7): clarify assumptions and limitations
Document that the growfs(7) script works only if the root file system is in the last partition and free space immediately follows it. Don't imply that /usr can be a separate partition, as that would likely mean that root is not last. Reported by: marklmi at yahoo dot com
This commit is contained in:
parent
ad97b9bbfc
commit
8664e266d6
@ -36,6 +36,7 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
script normally runs at the first boot after system installation.
|
script normally runs at the first boot after system installation.
|
||||||
If the boot disk is larger than the root file system and boot partitions,
|
If the boot disk is larger than the root file system and boot partitions,
|
||||||
|
and the root file system is in the last partition,
|
||||||
.Nm
|
.Nm
|
||||||
can expand the root file system.
|
can expand the root file system.
|
||||||
It can also add a swap partition, with a default size of 10% of the boot disk.
|
It can also add a swap partition, with a default size of 10% of the boot disk.
|
||||||
@ -99,12 +100,17 @@ partition before this procedure
|
|||||||
in order to expand the root file system to the new size.
|
in order to expand the root file system to the new size.
|
||||||
A new swap partition can be created during the expansion.
|
A new swap partition can be created during the expansion.
|
||||||
.Sh IMPLEMENTATION NOTES
|
.Sh IMPLEMENTATION NOTES
|
||||||
|
The
|
||||||
|
.Nm
|
||||||
|
script only attempts to expand the root file system,
|
||||||
|
and free space must be available immediately after the root partition.
|
||||||
|
It is normally used on images that have a single file system.
|
||||||
The script requires that
|
The script requires that
|
||||||
.Pa awk
|
.Xr awk 1
|
||||||
be present and in the path.
|
be present and in the path.
|
||||||
This usually means that
|
This usually means that
|
||||||
.Pa /usr
|
.Pa /usr
|
||||||
should be mounted prior to running the script.
|
must be available prior to running the script.
|
||||||
.Sh FILES
|
.Sh FILES
|
||||||
.Bl -tag -compact -width Pa
|
.Bl -tag -compact -width Pa
|
||||||
.It Pa /etc/fstab
|
.It Pa /etc/fstab
|
||||||
@ -114,7 +120,9 @@ should be mounted prior to running the script.
|
|||||||
.Ex -std
|
.Ex -std
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr fstab 5 ,
|
.Xr fstab 5 ,
|
||||||
.Xr rc.conf 5
|
.Xr rc.conf 5 ,
|
||||||
|
.Xr growfs 8 ,
|
||||||
|
.Xr zpool 8
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
|
Loading…
Reference in New Issue
Block a user