From owner-freebsd-doc@freebsd.org Sat Nov 12 07:51:49 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B1F2FC3DD43 for ; Sat, 12 Nov 2016 07:51:49 +0000 (UTC) (envelope-from adamw@adamw.org) Received: from anoxia.adamw.org (anoxia.adamw.org [104.225.8.149]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "anoxia.adamw.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 73FF21266 for ; Sat, 12 Nov 2016 07:51:48 +0000 (UTC) (envelope-from adamw@adamw.org) Received: by anoxia.adamw.org (OpenSMTPD) with ESMTPSA id 977d9206 TLS version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO for ; Sat, 12 Nov 2016 00:51:47 -0700 (MST) From: Adam Weinberger Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Mime-Version: 1.0 (Mac OS X Mail 10.1 \(3251\)) Subject: freebsd-update and kernels Message-Id: <627FBEFC-27B7-4D0A-9D71-F1AA78AE74D6@adamw.org> Date: Sat, 12 Nov 2016 00:51:45 -0700 To: freebsd-doc@freebsd.org X-Mailer: Apple Mail (2.3251) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 12 Nov 2016 07:51:49 -0000 Hi, doc folks. Can someone please take a look at section 23.2.3 of the = handbook? At multiple points in 23.2.3.1, and in the nextboot instructions, it = tells users that the GENERIC kernel will be updated if it lives in = /boot/GENERIC. AFAICT, freebsd-update will only update the GENERIC = kernel if it lives in /boot/kernel, NOT /boot/GENERIC. At best, running "nextboot -k GENERIC" after following the instructions = will boot an old, non-updated kernel. At worst (i.e., if people follow = the instructions given), they will attempt to boot a kernel that doesn't = exist. Shouldn't users be told to keep GENERIC in /boot/kernel, where = freebsd-update will actually update it, and to install custom kernels = into /boot/SOMENAME? I'd suggest changing that nextboot line to be "nextboot -k kernel". Then, I'd suggest replacing the first paragraph of 23.2.3.1 with = something like this: """ Before using freebsd-update, ensure that a copy of the GENERIC kernel = exists in /boot/GENERIC as a backup in case anything goes wrong. freebsd-update will update the GENERIC kernel, but only if it is = installed into /boot/kernel and only if it is completely unmodified. If = a custom kernel has only been built once, [... etc] """ And in the last sentence of that section, change /boot/GENERIC to = /boot/kernel. # Adam --=20 Adam Weinberger adamw@adamw.org // adamw@FreeBSD.org https://www.adamw.org