docs: Added All NetBSD Manuals

1 files changed, 153 insertions, 0 deletions

diff --git a/static/netbsd/man8/ndbootd.8 b/static/netbsd/man8/ndbootd.8
new file mode 100644
index 00000000..c1f7b2b2
--- /dev/null
+++ b/static/netbsd/man8/ndbootd.8
@@ -0,0 +1,153 @@
+.\"	$NetBSD: ndbootd.8,v 1.4 2002/02/02 01:21:00 wiz Exp $
+.\"	<<Id: ndbootd.8,v 1.2 2001/05/15 14:42:25 fredette Exp >>
+.\"
+.\" Copyright (c) 2001 Matthew Fredette.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\"   1. Redistributions of source code must retain the above copyright
+.\"      notice, this list of conditions and the following disclaimer.
+.\"   2. Redistributions in binary form must reproduce the above copyright
+.\"      notice, this list of conditions and the following disclaimer in the
+.\"      documentation and/or other materials provided with the distribution.
+.\"   3. All advertising materials mentioning features or use of this software
+.\"      must display the following acknowledgement:
+.\"        This product includes software developed by Matthew Fredette.
+.\"   4. The name of Matthew Fredette may not be used to endorse or promote
+.\"      products derived from this software without specific prior written
+.\"      permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.Dd May 9, 2001
+.Dt NDBOOTD 8
+.Os
+.Sh NAME
+.Nm ndbootd
+.Nd
+.Tn Sun
+Network Disk (ND) Protocol server
+.Sh SYNOPSIS
+.Nm
+.Op Fl s Ar boot2
+.Op Fl i Ar interface
+.Op Fl w Ar windowsize
+.Op Fl d
+.Ar boot1
+.Sh DESCRIPTION
+.Nm
+is a server which supports the
+Sun Network Disk (ND) Protocol.
+This protocol was designed by Sun before they designed
+.Tn NFS .
+ND simply
+makes the raw blocks of a disk available to network clients.  Contrast
+this with the true namespace and file abstractions that
+.Tn NFS
+provides.
+.Pp
+The only reason you're likely to encounter ND nowadays is if you have
+an old Sun 2 machine, like the 2/120 or 2/50.  The Sun 2 PROMs can
+only use ND to boot over the network.  (Later, the Sun 3 PROMs would
+use
+.Tn RARP
+and
+.Tn TFTP
+to boot over the network.)
+.Pp
+.Nm
+is a very simple ND server that only supports client reads for
+booting.  It exports a disk that the clients consider to be
+.Pa /dev/ndp0
+(ND public unit zero).  The disk is available only to clients that are
+listed in
+.Pa /etc/ethers
+and have valid hostnames.
+(Sun 2 PROMs don't do RARP, but they do learn their IP
+address from the first ND response they receive from the server.)
+.Pp
+.Ar boot1
+is a file containing the mandatory first-stage network boot
+program, typically
+.Pa /usr/mdec/bootyy .
+The layout of the exported disk is:
+.Bl -bullet -offset indent
+.It
+block 0: normally a Sun disklabel (but ignored by the PROM)
+.It
+blocks 1-15: the first-stage network boot program
+.El
+.Pp
+With the
+.Fl s Ar boot2
+option,
+.Nm
+will also make a second-stage network
+boot program available to clients, typically
+.Pa /usr/mdec/netboot .
+When
+.Ar boot2
+is a filename, that file is the single second-stage network boot program
+to be served to all clients.
+.Pp
+When
+.Ar boot2
+is a directory name, typically
+.Pa /tftpboot ,
+.Nm
+finds a
+client's second-stage network boot program by turning its IP address
+into a filename in that directory, in the same manner later Sun 3
+PROMs do when TFTPing (i.e., if a client has IP address 192.168.1.10,
+.Nm
+expects to find
+.Pa /tftpboot/C0A8010A.SUN2
+).
+.Pp
+When used in this last manner with an ND-aware first-stage boot program,
+.Nm
+serves the same purpose in the Sun 2 netboot process as
+.Xr tftpd 8
+serves in the Sun 3 netboot process.
+.Pp
+Any second-stage network boot program always begins at block 16 of the
+exported disk, regardless of the length of the first-stage network
+boot program.
+.Pp
+All first- and second-stage network boot programs must have all
+executable headers stripped off; they must be raw binary programs.
+.Pp
+The remaining options are:
+.Bl -tag -width "directory"
+.It Fl i Ar interface
+Only listen for ND clients on interface
+.Ar interface .
+Normally
+.Nm
+listens for clients on the first non-loopback IP interface
+that is up and running.
+.It Fl w Ar windowsize
+This adjusts the window size of the ND protocol.  This is
+the number of 1-kilobyte packets that can be transmitted before
+waiting for an acknowledgement.  Defaults to 6.
+.It Fl d
+Run in debug mode.  Debugging output goes to standard error
+and the server will not fork.
+.El
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /etc/ethers
+.It Pa /etc/hosts
+.\" .It Pa /tftpboot
+.El
+.Sh SEE ALSO
+.Xr tftpd 8
+.Sh BUGS
+Whether or not there is a second-stage network boot program, the
+exported disk appears to all clients to have infinite length.  The
+content of all blocks not used by the first- or second-stage network
+boot programs is undefined.  All client reads of undefined blocks
+are silently allowed by the server.