From nobody Tue Nov 21 21:10:46 2023 X-Original-To: freebsd-questions@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 4SZcVL2wxpz52JNt for ; Tue, 21 Nov 2023 21:10:50 +0000 (UTC) (envelope-from iio7@tutanota.com) Received: from w1.tutanota.de (w1.tutanota.de [81.3.6.162]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "mail.tutanota.de", Issuer "Sectigo RSA Domain Validation Secure Server CA" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SZcVJ5pVtz3Yjj for ; Tue, 21 Nov 2023 21:10:48 +0000 (UTC) (envelope-from iio7@tutanota.com) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=tutanota.com header.s=s1 header.b="N/Rg+AyO"; spf=pass (mx1.freebsd.org: domain of iio7@tutanota.com designates 81.3.6.162 as permitted sender) smtp.mailfrom=iio7@tutanota.com; dmarc=pass (policy=quarantine) header.from=tutanota.com Received: from tutadb.w10.tutanota.de (unknown [192.168.1.10]) by w1.tutanota.de (Postfix) with ESMTP id C4555FBFBAA for ; Tue, 21 Nov 2023 21:10:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1700601046; s=s1; d=tutanota.com; h=From:From:To:To:Subject:Subject:Content-Description:Content-ID:Content-Type:Content-Type:Content-Transfer-Encoding:Content-Transfer-Encoding:Cc:Date:Date:In-Reply-To:In-Reply-To:MIME-Version:MIME-Version:Message-ID:Message-ID:Reply-To:References:References:Sender; bh=VC877Mas/InLDHwqL8ZIRRoGjG8M01OBo0Z2Rjl2Xqg=; b=N/Rg+AyOLEyU76ez7zl6G9IbfK/FWhJvA0QSOOkn99nCFS/ALsHq159UKxY66LmI 38TX3iogVHC9YTetqds8sMGaY4cMUpGoPzIt0lwKcyUQ+iAtUhtCmvmGL3Ho1b4Ez8O jbMyUfM4xKDxVh4WpBAHi+UWyVRglAc46I5PkzRHS8r7rvINrKf8ffaA3EUgyKMfQb3 F3FrUUOXDPKV+E+TVNKRi6KBApbi0F7n+y2EKuccu2Jk9b95jEGorrihvCh1CuHR4Ot PdX53znltW2h25xHtZdiDKV3ClMt5zF9XOpwCI67V5h07CEAkbIiYMetLo2dFB9xmlC 1+mNwBCKGw== Date: Tue, 21 Nov 2023 22:10:46 +0100 (CET) From: iio7@tutanota.com To: Freebsd Questions Message-ID: In-Reply-To: References: <20231121203038.9484f62455034022a4689468@sohara.org> Subject: Re: I am sick and tired of the poor quality of documentation on FreeBSD List-Id: User questions List-Archive: https://lists.freebsd.org/archives/freebsd-questions List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-questions@freebsd.org X-BeenThere: freebsd-questions@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spamd-Result: default: False [-4.30 / 15.00]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_SHORT(-1.00)[-0.997]; DMARC_POLICY_ALLOW(-0.50)[tutanota.com,quarantine]; RWL_MAILSPIKE_EXCELLENT(-0.40)[81.3.6.162:from]; R_DKIM_ALLOW(-0.20)[tutanota.com:s=s1]; R_SPF_ALLOW(-0.20)[+ip4:81.3.6.160/28]; ONCE_RECEIVED(0.10)[]; MIME_GOOD(-0.10)[text/plain]; RCVD_COUNT_ONE(0.00)[1]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_TLS_LAST(0.00)[]; MLMMJ_DEST(0.00)[freebsd-questions@freebsd.org]; ASN(0.00)[asn:24679, ipnet:81.3.0.0/18, country:DE]; DKIM_TRACE(0.00)[tutanota.com:+]; MID_RHS_MATCH_FROM(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; FROM_NO_DN(0.00)[]; PREVIOUSLY_DELIVERED(0.00)[freebsd-questions@freebsd.org]; TO_DN_ALL(0.00)[]; RCPT_COUNT_ONE(0.00)[1]; ARC_NA(0.00)[] X-Rspamd-Queue-Id: 4SZcVJ5pVtz3Yjj X-Spamd-Bar: ---- > Nov 21, 2023, 21:30 by steve@sohara.org: > >> >> You did of course read the release notes right ? The rather good >> documentation provided by the FreeBSD project for each new release. >> Specifically this section that tells you exactly what to do and why. >> >> https://www.freebsd.org/releases/14.0R/relnotes/#upgrade >> >> Documentation is only useful if you read it! BEFORE you do things. >> >>> Something like this doesn't help! >>> =C2=A0 Pool 'zroot' has the bootfs property set, you might need to upda= te the >>> boot code. See gptzfsboot(8) and loader.efi(8) for details. >>> >> >> It's a warning not documentation, heeding it could have saved you >> much trouble. >> >>> I might need to update the boot code!? WTF does that even mean? >>> >> >> It seems pretty clear that you should make sure you understand it >> and do what is necessary *before* you reboot. The boot code is (as the n= ame >> implies) the code used to boot the system which has to be able to read t= he >> filesystem containing the OS, which it can't if that filesystem has been >> updated with features that the existing boot code does not support. >> >>> I never touched any boot code during installation so I don't even know >>> what that is! And reading those man pages did NOT help me in any way. >>> >> >> If you had read the release notes you would know what to do, and >> surely the name "boot code" is sufficiently descriptive as to what it is= . >> >>> So now I got a box that's borked with this beautiful message after >>> updating the zroot pool: >>> >> >> AND rebooting without updating the boot code right ? >> >>> ZFS: unsupported feature: com.delphix:head_errlog >>> ZFS: pool zroot is not supported >>> Can't find /boot/zfsloader >>> Can't find /boot/loader >>> Can't find /boot/kernel/kernel >>> >> >> Now you're going to need this article in the forums which a search >> would have found for you in a few seconds: >> >> >> >> You might want to thank T-Aoki and note the rather more polite way >> someone else who got themselves into this mess asked for help. >> The release engineering and related documentation suck as usual. Polite my = ass. I have had it. I have been on FreeBSD for more than 20 years and always have to deal with = shitload of problems on this operating system ONLY due to the lack of docum= entation. I read the man pages, I read the forum post, which doesn't help shit when t= he next crap you run into is this: =C2=A0 ZFS: unsupported feature: com.klarasystems:vdev_zaps_vs Nothing should break this bad during a simple upgrade and then have the guy= responsible for the documentation to make a fucking blog post about the mi= ssing documentation on the website: https://www.daemonology.net/blog/2023-11-21-late-breaking-FreeBSD-14-breaka= ge.html "but there are a few last-minute issues which deserve to bedocumented =E2= =80=94 probably somewhere on the FreeBSD website, but I canpost to my blog = much faster and hopefully we'll get these onto the FreeBSDwebsite later." Oh, and let's not forget this one: "stand: Fix oversight in updating OpenZFS: Add com.klarasystems:vdev_zaps_v= 2com.klarasystems:vdev_zaps_v2 is a new feature that the last OpenZFSimport= brought in. It needs to be on the list of supported features, butthat upda= te didn't happen so I woke up to a mailbox with multiplecomplaints." Thank you very much! Amazing work.