From nobody Fri Jan 06 01:45:45 2023 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Np5lQ1gLdz2p7Bf; Fri, 6 Jan 2023 01:45:54 +0000 (UTC) (envelope-from mike@karels.net) Received: from mail.karels.net (mail.karels.net [216.160.39.52]) by mx1.freebsd.org (Postfix) with ESMTP id 4Np5lP1Wn3z46t3; Fri, 6 Jan 2023 01:45:53 +0000 (UTC) (envelope-from mike@karels.net) Authentication-Results: mx1.freebsd.org; none Received: from mail.karels.net (localhost [127.0.0.1]) by mail.karels.net (8.16.1/8.16.1) with ESMTP id 3061jj06027177; Thu, 5 Jan 2023 19:45:46 -0600 (CST) (envelope-from mike@karels.net) Received: from [10.0.2.130] ([10.0.1.1]) by mail.karels.net with ESMTPSA id hLDrJkl9t2MnagAA4+wvSQ (envelope-from ); Thu, 05 Jan 2023 19:45:45 -0600 From: Mike Karels To: Mike Karels Cc: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org Subject: Re: git: 8664e266d6a4 - main - growfs(7): clarify assumptions and limitations Date: Thu, 05 Jan 2023 19:45:45 -0600 X-Mailer: MailMate (1.14r5921) Message-ID: <7F2990FE-AA0B-4825-B14F-96E9333C51EF@karels.net> In-Reply-To: <202301060044.3060iOli020349@gitrepo.freebsd.org> References: <202301060044.3060iOli020349@gitrepo.freebsd.org> List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: 4Np5lP1Wn3z46t3 X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:209, ipnet:216.160.36.0/22, country:US] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-ThisMailContainsUnwantedMimeParts: N On 5 Jan 2023, at 18:44, Mike Karels wrote: > The branch main has been updated by karels: > > URL: https://cgit.FreeBSD.org/src/commit/?id=3D8664e266d6a4573d1875ee8f= 4ce0cdb091171780 > > commit 8664e266d6a4573d1875ee8f4ce0cdb091171780 > Author: Mike Karels > AuthorDate: 2023-01-05 13:15:21 +0000 > Commit: Mike Karels > 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 syst= em > 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 Reviewed by: manpages (pauamma) Differential revision: https://reviews.freebsd.org/D37959 > --- > 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 partitio= ns, > +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 bo= ot 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