From owner-freebsd-doc@freebsd.org Wed Jun 27 18:37:17 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B38E510009B6 for ; Wed, 27 Jun 2018 18:37:17 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "freefall.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 656FC8BF6F; Wed, 27 Jun 2018 18:37:17 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from FreeBSD.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by freefall.freebsd.org (Postfix) with ESMTPS id 281C21F9EC; Wed, 27 Jun 2018 18:37:17 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Date: Wed, 27 Jun 2018 18:37:15 +0000 From: Glen Barber To: Adam Weinberger Cc: re@freebsd.org, freebsd-doc@freebsd.org Subject: Re: Problem with FreeBSD Update handbook instructions Message-ID: <20180627183715.GC3861@FreeBSD.org> References: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="Y5rl02BVI9TCfPar" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.9.1 (2017-09-22) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Jun 2018 18:37:17 -0000 --Y5rl02BVI9TCfPar Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Jun 27, 2018 at 12:30:49PM -0600, Adam Weinberger wrote: > Hi, re team, >=20 > The handbook instructions in =A723.2 "FreeBSD Update" > (https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/updating-upgr= ading-freebsdupdate.html) > have a number of instructions that appear to be incorrect. >=20 > The instructions say repeatedly that a copy of the GENERIC kernel > should be kept in /boot/GENERIC, and that freebsd-update will then > keep it up-to-date. >=20 > This does not appear to be correct. freebsd-update only keeps a > GENERIC kernel up-to-date if it is in /boot/kernel. Custom kernels > must be installed with a new name using INSTKERNNAME=3D, so that > /boot/kernel always remains GENERIC. >=20 > If the instructions in that page are followed for 11.1 -> 11.2, for > example, a copy of the old kernel will be made to /boot/GENERIC, fail > to be updated by freebsd-update, and then "nextboot -k GENERIC" will > boot into an 11.1 kernel, instead of 11.2. >=20 > Unless I'm missing something, those instructions really need to be > updated before someone shoots himself or herself in the foot with > them. >=20 This looks like a general documentation issue. If I recall correctly, the details in this document apply to 8.x and earlier, and 9.x and later use /boot/kernel. Maybe someone on docs@ could take a moment to look into this, or at least verify if my assumption is correct. Glen --Y5rl02BVI9TCfPar Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAlsz2VsACgkQAxRYpUeP 4pPd9w//aQwEPW+sDsfjp2yeB0/5UoBJLDs9mbM/0nYkbxCIz2MxgmtXx1cKMA4y qChXfCesahskPUjOuaG5YepK08as8sshhpPB/RJsbdmVoxg1ulhODWgrwRsquzOK t3rhKRHYplxjxRFc3AyYtx3FjL+E9+pwuEdAnBrfJb27Bku8y1YyUikJUq+QqB84 Q8w3RVmO2aPAR0rYiwpr/hmAbG2J3OsXPqC5vVgYZXff0T+NSFoQHU7qgqEYvp1c skGOMQ/2VnLRaUhsYrtRf06L/QC9W8OfF7fjS/szAJVh8VfroIq7mTYcbqwHfau3 /k5rHhtg1u74zJAIoU4msOOiA8u1VbuzeyzBaeuhLz35E4ZOD3q4dI8hSGAzIo93 ScxJqy4oL7cLRBGSznUrul7916oVaH2bNjoR5OTy2HbUXr9mPyBNwp+wPG8zjIh0 TYx2/rX/hJDKAtAjdiBCWTdPuvbztm6yuFaoVAi+dk64sC1lgTnWdWptW5jSorP0 cr4riUcAuBQh3dRwdZk8NWi5mSlfnkGmSEMnMbK90qZAE5QSfhT2rBRtN/TgPi4k tw/J1PbneWVetst1wnmwoKBXisNKr7Qq5tcGzS5ctpxLNNqkiGAJB23kiEXION1S mz6TSbto6nF0LJj8SQr0d3VNhDJF7bEEQ5GAI9KN5sd5fQUEJpQ= =83NK -----END PGP SIGNATURE----- --Y5rl02BVI9TCfPar--