Subject: port-i386/9552: i386 boot(8) omits mention of netbsd.gz, onetbsd, etc.
To: None <gnats-bugs@gnats.netbsd.org>
From: John Hawkinson <jhawk@mit.edu>
List: netbsd-bugs
Date: 03/05/2000 17:18:48
>Number: 9552
>Category: port-i386
>Synopsis: i386 boot(8) omits mention of netbsd.gz, onetbsd, etc.
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: port-i386-maintainer (NetBSD/i386 Portmaster)
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Sun Mar 5 17:18:00 2000
>Last-Modified:
>Originator: John Hawkinson
>Organization:
MIT
>Release: NetBSD 1.4.1
>Environment:
System: NetBSD zorkmid.mit.edu 1.4.1 NetBSD 1.4.1 (ZORKMID) #9: Sun Mar 5 15:44:11 EST 2000 jhawk@zorkmid.mit.edu:/usr/src/sys/arch/i386/compile/ZORKMID i386
>Description:
This is still present in -current.
boot(8) faiuls to mention netbsd.gz, onetbsd, or any of the
other alternate bootfiles to/netbsd.
Perhaps more seriously, there doesn't appear to be a good
discussion of gzipping of kernels. Also, some of this is
cross-platform, or at least should be consistent across platforms,
and in many cases is, but is documented seperately (and perhaps
implemented seperately) in different boot(8) manpages. Solving
that usefully is tricky
>How-To-Repeat:
Wonder where that /onetbsd thing you've been using for years is
documented, and start looking.
>Fix:
Here's what seems to be a reasonable first cut. Diff against
1.4.1 but applies cleanly to -current.
===================================================================
RCS file: share/man/man8/man8.i386/RCS/boot.8,v
retrieving revision 1.1
retrieving revision 1.2
diff -c -r1.1 -r1.2
*** share/man/man8/man8.i386/boot.8 2000/03/06 00:27:53 1.1
--- share/man/man8/man8.i386/boot.8 2000/03/06 01:15:35 1.2
***************
*** 84,91 ****
The default disk will be set to the disk that the boot loader was
loaded from.
To boot from an alternate disk, the full name of the device should
! be given at the prompt. Alternate system images can be loaded by
! just specifying the name of the image.
.Pp
The following list of supported devices may vary from installation to
installation:
--- 84,103 ----
The default disk will be set to the disk that the boot loader was
loaded from.
To boot from an alternate disk, the full name of the device should
! be given at the prompt.
! .Pp
! The default image is
! .Dq Li netbsd ;
! if the boot loader fails to successfully
! open that image, it then tries
! .Dq Li netbsd.gz
! (expected to be a kernel image compressed by gzip), followed by
! .Dq Li netbsd.old ,
! .Dq Li netbsd.old.gz ,
! .Dq Li onetbsd ,
! and finally
! .Dq Li onetbsd.gz .
! Alternate system images can be loaded by just specifying the name of the image.
.Pp
The following list of supported devices may vary from installation to
installation:
***************
*** 123,128 ****
--- 135,142 ----
.Bl -tag -width /usr/mdec/biosboot.sym -compact
.It Pa /netbsd
system code
+ .It Pa /netbsd.gz
+ gzip-compressed system code
.It Pa /usr/mdec/biosboot.sym
boot block (not installed)
.It Pa /boot
>Audit-Trail:
>Unformatted: