d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

growfs(7): clarify assumptions and limitations

Browse Source 
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:
Mike Karels 2023-01-05 07:15:21 -06:00
parent ad97b9bbfc
commit 8664e266d6
1 changed files with 11 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
share/man/man7/growfs.7
View File

@ -36,6 +36,7 @@ The
.Nm
script normally runs at the first boot after system installation.
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
can expand the root file system.
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.
A new swap partition can be created during the expansion.
.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
.Pa awk
.Xr awk 1
be present and in the path.
This usually means that
.Pa /usr
should be mounted prior to running the script.
must be available prior to running the script.
.Sh FILES
.Bl -tag -compact -width Pa
.It Pa /etc/fstab
@ -114,7 +120,9 @@ should be mounted prior to running the script.
.Ex -std
.Sh SEE ALSO
.Xr fstab 5 ,
.Xr rc.conf 5
.Xr rc.conf 5 ,
.Xr growfs 8 ,
.Xr zpool 8
.Sh HISTORY
The
.Nm