NetBSD Problem Report #56953

From  Thu Aug  4 18:25:43 2022
Return-Path: <>
Received: from ( [])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "", Issuer " CA" (not verified))
	by (Postfix) with ESMTPS id 36E841A921F
	for <>; Thu,  4 Aug 2022 18:25:43 +0000 (UTC)
Message-Id: <>
Date: Thu,  4 Aug 2022 20:25:34 +0200 (CEST)
Subject: install notes are slightly outdated
X-Send-Pr-Version: 3.95

>Number:         56953
>Category:       install
>Synopsis:       install notes are slightly outdated
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    install-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Aug 04 18:30:00 +0000 2022
>Last-Modified:  Thu Aug 04 18:35:01 +0000 2022
>Originator:     Martin Husemann
>Release:        NetBSD 9.99.99
The NetBSD Foundation, Inc.
System: NetBSD 9.99.99 NetBSD 9.99.99 (GENERIC) #142: Sat Jul 30 14:28:52 CEST 2022 amd64
Architecture: x86_64
Machine: amd64

The installation notes, especially distrib/notes/common/sysinst, are
slightly wrong/outdated.

Unfortunately they are a twisty maze of machine dependend .if and need
very carefull editing and proofreading.

Read the INSTALL.html of a daily HEAD build, e.g.

Note that:
 - it lists "Selecting which sets to install" very early, while it only
   actually happens after partitioning and file system creation (in
   the current numbering: between step 11 and 12)
 - in step 9 "Partitioning the disk" and 10 "Editing the NetBSD disklabel"
   it does not mention GPT options (side note: it also only explains MBR/fdisk
   for i386, but not amd64)
   Probably both of these sections should be rewritten from scratch,
   mentioning that available partitioning schemes will vary by
   architecture and sometimes even by install medium selected (due to
   space constraints). Most of the .if spagethi can probably removed
   and a general one (GPT or disklabel, depending on machine and boot
   details) or two level (outer [MBR] and inner [disklabel]) scheme

yes, *roff wizards and well trained english writers: please do :-}

From: Martin Husemann <>
Subject: Re: install/56953: install notes are slightly outdated
Date: Thu, 4 Aug 2022 20:33:00 +0200

 It also misses (after current point 18 "Extracting the distribution set"
 and point 19 "Configure additional items") one new mandatory
 item: "Setup the root password" and on some machines (where no TRNG
 is available) an optional step to seed the initial entropy.


NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.46 2020/01/03 16:35:01 leot Exp $
$NetBSD:,v 1.9 2014/08/02 14:16:04 spz Exp $
Copyright © 1994-2020 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.