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: