Date: Fri, 6 Jan 2023 00:44:24 GMT From: Mike Karels <karels@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org Subject: git: 8664e266d6a4 - main - growfs(7): clarify assumptions and limitations Message-ID: <202301060044.3060iOli020349@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch main has been updated by karels: URL: https://cgit.FreeBSD.org/src/commit/?id=8664e266d6a4573d1875ee8f4ce0cdb091171780 commit 8664e266d6a4573d1875ee8f4ce0cdb091171780 Author: Mike Karels <karels@FreeBSD.org> AuthorDate: 2023-01-05 13:15:21 +0000 Commit: Mike Karels <karels@FreeBSD.org> CommitDate: 2023-01-06 00:44:16 +0000 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 --- share/man/man7/growfs.7 | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/share/man/man7/growfs.7 b/share/man/man7/growfs.7 index 0ebc5b6f3ee0..41903023af91 100644 --- a/share/man/man7/growfs.7 +++ b/share/man/man7/growfs.7 @@ -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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202301060044.3060iOli020349>