From nobody Tue Nov 21 22:07:41 2023 X-Original-To: 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 4SZdlz4Xk6z518V8 for ; Tue, 21 Nov 2023 22:07:43 +0000 (UTC) (envelope-from kevans@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SZdlz30jdz4Gkg for ; Tue, 21 Nov 2023 22:07:43 +0000 (UTC) (envelope-from kevans@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1700604463; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=uhtfPp8Rcw69a3AWlNyXA+kXmnBul0mwi15N1ehL8Zk=; b=OlUWm1tQkNK4TzruoVDh0E1K0WKrerIR29Bp9CD4VUlsHs4Hl8ALG9HeE09f9UKmgtYSPd FvkCuECvzERqbBiH4oikOoZXIU9NX7bwrcLGx4kKgNQANecXaPlMJFj+WEv9EodjAkgGsR 6OLjCqJGxg27AcWo14iZihR9QAHGO19WAFPKJ7e+Qo8Tc2HEsBRim6idhrarA921MmZlJt fONQqlJzKVfOIPy2DYvMQn22b3JKqY0nwPkHIH4RnLaBvNC+dPLYrn07BlzJDdkv4bJj/p khL14dljfTfPj45JCEaervrKmzfwroDdPs0oCoSblSxwGGv/fEiDVZM6fC6keQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1700604463; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=uhtfPp8Rcw69a3AWlNyXA+kXmnBul0mwi15N1ehL8Zk=; b=CvpvRJzle1Dr49Npk8p1NcJlNfAY42sQU2yYHm2hLEMXB+JvXpqiQJufUCFYvx0rbAYJmh 8+Zj/PChVNJT2gQPgLjDE+cRwSyOuLkkODFrT/4e/ObGyZcQkZcy0NuAPc8b1+FU2LBIBi sKIc0xb1J6JkZR6MfPFztDq9q2Xuh5fdlHuSGVSLeFpCwPUoKag71q6sbkpcmsM72aY2hQ +DMs5lkGoqCprJ57RU3VN5ll/UwURJk2gotYJKBh5Ra0NOk/d4qULDM3K4cBZjQy1b3KZs TlyboAJJk9g4H7l7w0hRGOP/s0PnPRYDrkYqp9eN6HrZAXYrftiXe0veYyI8mQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1700604463; a=rsa-sha256; cv=none; b=es7UtWdu1r5IWfwGD6boIGtdGmGEVQq3zINzEs+bipSvdqficKxIMkXxhd5iUFpze+COIG IBoimSGkKZh9KxrUx0ev4wB8BwrlNRGDNXtV6P8gBGi5BHzRrkvYIwMfNtrbtVoU3Dtrnf 9McDJAmkoYrsX3aAuKu8QRLateIV4SVkcXPUI9De2AIQet3ATbMMo18+BxeWLDpuOrWH+q tph7ULvGC8HmGq5DS+nJsG5qPHFuG+89H5Io6Ae5paLRC/wd9N4SgPS+RctKG0HQU4ROXD UZohZoWMrfl161m633UrBkZmAw3eFOecKhNcSp28J1gXapSmKWh1IIGIkDFZMg== Received: from [10.9.4.95] (unknown [209.182.120.176]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) (Authenticated sender: kevans/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4SZdly67hRz1SKK for ; Tue, 21 Nov 2023 22:07:42 +0000 (UTC) (envelope-from kevans@FreeBSD.org) Message-ID: <11d339e5-8c77-4c87-816a-c37c57b15152@FreeBSD.org> Date: Tue, 21 Nov 2023 16:07:41 -0600 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 User-Agent: Mozilla Thunderbird Subject: Re: I am sick and tired of the poor quality of documentation on FreeBSD Content-Language: en-US To: questions@freebsd.org References: <20231121203038.9484f62455034022a4689468@sohara.org> From: Kyle Evans In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit On 11/21/23 15:10, iio7@tutanota.com wrote: > > > >> 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! >>>>   Pool 'zroot' has the bootfs property set, you might need to update 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 name >>> implies) the code used to boot the system which has to be able to read the >>> 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 documentation. > > I read the man pages, I read the forum post, which doesn't help shit when the next crap you run into is this: > >   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 missing documentation on the website: > You didn't do the complete upgrade because you failed to read the release notes, as noted a couple of times so far. You might have missed the part where you're upgrading major versions, where stuff like the above *does* happen and that's why you have to actually read the material presented to you that's discussing what's changed. We can't stop you from shooting yourself in the foot when it's so clearly written right there what to do on a UEFI system where it's less straightforward, and given your apparent years of experience there's no way you haven't had to deal with a gpart-bootcode update that hasn't changed in any material fashion in years. I'm not going to bother responding to the rest, because you seem to have some strong wrong opinions about who does what on the project and how source trees work.