[src/trunk]: src introduce evbarm bootmini2440(8) man entry.

[nisimura <nisimura%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8ce6682def44
branches:  trunk
changeset: 773340:8ce6682def44
user:      nisimura <nisimura%NetBSD.org@localhost>
date:      Tue Jan 31 12:23:32 2012 +0000

description:
introduce evbarm bootmini2440(8) man entry.

diffstat:

 distrib/sets/lists/man/mi                 |    5 +-
 share/man/man8/Makefile                   |    6 +-
 share/man/man8/man8.evbarm/Makefile       |    7 +
 share/man/man8/man8.evbarm/bootmini2440.8 |  171 ++++++++++++++++++++++++++++++
 4 files changed, 185 insertions(+), 4 deletions(-)

diffs (239 lines):

diff -r 37a9ee9f09d2 -r 8ce6682def44 distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Tue Jan 31 11:04:17 2012 +0000
+++ b/distrib/sets/lists/man/mi Tue Jan 31 12:23:32 2012 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1373 2012/01/22 08:58:13 jnemeth Exp $
+# $NetBSD: mi,v 1.1374 2012/01/31 12:23:32 nisimura Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -2279,6 +2279,7 @@
 ./usr/share/man/cat8/eshconfig.0               man-sysutil-catman      .cat
 ./usr/share/man/cat8/etcupdate.0               man-sysutil-catman      .cat
 ./usr/share/man/cat8/evbarm/MAKEDEV.0          man-obsolete            obsolete
+./usr/share/man/cat8/evbarm/bootmini2440.0     man-sysutil-catman      .cat
 ./usr/share/man/cat8/evbarm/makedev.0          man-obsolete            obsolete
 ./usr/share/man/cat8/evbmips/MAKEDEV.0         man-obsolete            obsolete
 ./usr/share/man/cat8/evbmips/makedev.0         man-obsolete            obsolete
@@ -4986,6 +4987,7 @@
 ./usr/share/man/html8/edquota.html             man-sysutil-htmlman     html
 ./usr/share/man/html8/eeprom.html              man-sysutil-htmlman     html
 ./usr/share/man/html8/emips/boot.html          man-sys-htmlman         html
+./usr/share/man/html8/evbarm/bootmini2440.html man-sysutil-htmlman     html
 ./usr/share/man/html8/envstat.html             man-sysutil-htmlman     html
 ./usr/share/man/html8/error.html               man-postfix-htmlman     postfix,html
 ./usr/share/man/html8/eshconfig.html           man-sysutil-htmlman     html
@@ -7770,6 +7772,7 @@
 ./usr/share/man/man8/emips/boot.8              man-sys-man             .man
 ./usr/share/man/man8/emips/installboot.8               man-obsolete            obsolete
 ./usr/share/man/man8/emips/makedev.8           man-obsolete            obsolete
+./usr/share/man/man8/evbarm/bootmini2440.8     man-sysutils-man        .man
 ./usr/share/man/man8/envstat.8                 man-sysutil-man         .man
 ./usr/share/man/man8/error.8                   man-postfix-man         postfix,.man
 ./usr/share/man/man8/eshconfig.8               man-sysutil-man         .man
diff -r 37a9ee9f09d2 -r 8ce6682def44 share/man/man8/Makefile
--- a/share/man/man8/Makefile   Tue Jan 31 11:04:17 2012 +0000
+++ b/share/man/man8/Makefile   Tue Jan 31 12:23:32 2012 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.101 2011/04/26 16:57:39 joerg Exp $
+#      $NetBSD: Makefile,v 1.102 2012/01/31 12:23:33 nisimura Exp $
 #      from: @(#)Makefile      8.1 (Berkeley) 6/5/93
 
 MAN=   MAKEDEV.8 MAKEDEV.local.8 afterboot.8 boot.8 compat_30.8 \
@@ -21,8 +21,8 @@
 MLINKS+=rc.8 rc.shutdown.8
 
 SUBDIR= man8.acorn26 man8.acorn32 man8.alpha man8.amd64 man8.amiga man8.atari \
-       man8.cobalt man8.dreamcast man8.emips man8.hp300 man8.hp700 \
-       man8.hpcarm \
+       man8.cobalt man8.dreamcast man8.emips man8.evbarm man8.hp300 \
+       man8.hp700 man8.hpcarm \
        man8.hpcmips man8.hpcsh man8.i386 man8.mac68k man8.macppc \
        man8.mvme68k man8.next68k man8.pmax man8.prep man8.sandpoint \
        man8.sgimips man8.sparc man8.sparc64 man8.sun2 man8.sun3 \
diff -r 37a9ee9f09d2 -r 8ce6682def44 share/man/man8/man8.evbarm/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man8/man8.evbarm/Makefile       Tue Jan 31 12:23:32 2012 +0000
@@ -0,0 +1,7 @@
+#      @(#)Makefile    5.1 (Berkeley) 3/22/91
+#      $NetBSD: Makefile,v 1.3 2012/01/31 12:23:33 nisimura Exp $
+
+MAN=   bootmini2440.8
+MANSUBDIR=/evbarm
+
+.include <bsd.man.mk>
diff -r 37a9ee9f09d2 -r 8ce6682def44 share/man/man8/man8.evbarm/bootmini2440.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man8/man8.evbarm/bootmini2440.8 Tue Jan 31 12:23:32 2012 +0000
@@ -0,0 +1,171 @@
+.\" $NetBSD: bootmini2440.8,v 1.1 2012/01/31 12:23:33 nisimura Exp $
+.\"
+.\" Copyright (c) 2012 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Paul Fleischer <paul%xpg.dk@localhost>.
+.\"
+.\" 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.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+
+.Dd January 31, 2012
+.Dt BOOTMINI2440 8 evbarm
+.Os NetBSD
+.Sh NAME
+.Nm bootmini2440
+.Nd bootloader for FriendlyARM MINI2440 evaluation board
+.Sh DESCRIPTION
+.Nm
+is a program to load
+.Tn ELF
+.Nx
+kernel, which works on top of
+.Tn U-Boot .
+It loads and executes a kernel from an SD memory card, or over
+network using
+.Tn NFS/TFTP
+protocol.
+.Pp
+The 
+.Nm
+bootloader can be loaded anywhere by
+.Tn U-Boot ,
+although care should be taken that the bootloader can load the
+.Nx
+kernel without overwriting itself. The kernel is, by default, made
+to be loaded at 0x30200000. The recommended location for
+.Nm
+is 0x30A00000.
+.Pp
+.Nm
+takes a number of arguments, which all are optional:
+.Dl Ar mac=xx:xx:xx:xx:xx:xx Ar opt1 ... Ar optN Ar bootname
+.Bl -tag -width xx
+.It Va mac=
+is used to set the MAC-address of the on-board DM9000 Ethernet
+chip. As Mini2440 has no EEPROM to store DM9000 MAC-address, this
+is necessary in order to have a working Ethernet controller. If
+this argument is left unspecified, a default value of 08:08:11:18:12:27
+is used.
+.It Va opt1 ... Va optN
+is one of single, kdb, ask, quiet, or verbose. Their meaning is described in 
+.Xr boothowto 7 .
+.It Va bootname
+is one of the following:
+.Pp
+.Dl net: Ns Ar ip Ns : Ns Ar filename
+.Dl net: Ns Ar filename
+.Dl net:
+.Dl tftp: Ns Ar filename
+.Dl tftp:
+.Dl ld0 Ns Ar p : Ns Ar filename
+.Dl ld0 Ns Ar p : 
+.Pp
+.Bl -tag -width xx
+.It net: Ns Va ip Ns : Ns Va filename
+use
+.Tn DHCP
+to determine own IP-address and load kernel specified by
+.Ar filename
+from the server specified by
+.Ar ip
+using
+.Tn NFS .
+.It net: Ns Ar filename
+use
+.Tn DHCP
+to determine own IP-address and server IP-address. Load kernel specified by
+.Ar filename
+from the server using
+.Tn NFS .
+.It net:
+use
+.Tn DHCP
+to determine own IP-address, server IP-address, and kernel to load.
+Load the kernel using
+.Tn NFS .
+.It tftp: Ns Ar filename
+use
+.Tn DHCP
+to determine own IP-address and server IP-address. Load kernel specified by
+.Ar filename
+from the server using
+.Tn TFTP .
+.It tftp:
+use
+.Tn DHCP
+to determine own IP-address, server IP-address, and kernel to load.
+Load kernel using
+.Tn TFTP .
+.It ld0 Ns Va p : Ns Va filename
+load kernel from an SD card. The kernel specified by
+.Ar filename
+is attempted loaded on the partition given by
+.Ar p .
+.It ld0 Ns Va p : 
+load kernel from an SD card. The kernel will be loaded from the
+file "netbsd" on the partition specified by
+.Ar p .
+.El
+.Pp
+.Sh EXAMPLES
+.Ss Loading Nm
+Use
+.Tn U-Boot
+to load
+.Nm
+at 0x30A00000 from an
+.Tn NFS
+share:
+.Dl Uboot> nfs 30A00000 10.0.0.1:/srv/mini2440/bootmini2440
+.Ss Booting Nx
+Load the kernel from an
+.Tn NFS
+share, overwriting the default MAC-address, and
+booting into single user-mode:
+.Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 net:10.0.0.1:/srv/mini2440/netbsd
+.Pp
+Load the kernel from an SD card, overwriting the default
+MAC-address, and booting into single user-mode:
+.Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 ld0a:netbsd
+.Sh SEE ALSO
+.Xr dhcpd 8 ,
+.Xr diskless 8 ,
+.Xr nfsd 8 ,
+.xr tftpd 8 ,
+.Xr boothowto 9
+.Sh BUGS
+.Nm
+cannot currently function properly without
+.Tn U-Boot
+(or equivalent). Although it performs clock and
+.Tn UART
+configuration, it cannot bootstrap itself from
+.Tn NAND
+flash.
+.Sh HISTORY
+The
+.Nx Ns Tn /evbarm
+.Nm
+first appeared in
+.Nx 6.0 .