Module Name: src
Committed By: nisimura
Date: Tue Jan 31 12:23:33 UTC 2012
Modified Files:
src/distrib/sets/lists/man: mi
src/share/man/man8: Makefile
Added Files:
src/share/man/man8/man8.evbarm: Makefile bootmini2440.8
Log Message:
introduce evbarm bootmini2440(8) man entry.
To generate a diff of this commit:
cvs rdiff -u -r1.1373 -r1.1374 src/distrib/sets/lists/man/mi
cvs rdiff -u -r1.101 -r1.102 src/share/man/man8/Makefile
cvs rdiff -u -r0 -r1.3 src/share/man/man8/man8.evbarm/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man8/man8.evbarm/bootmini2440.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/sets/lists/man/mi
diff -u src/distrib/sets/lists/man/mi:1.1373 src/distrib/sets/lists/man/mi:1.1374
--- src/distrib/sets/lists/man/mi:1.1373 Sun Jan 22 08:58:13 2012
+++ src/distrib/sets/lists/man/mi Tue Jan 31 12:23:32 2012
@@ -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
Index: src/share/man/man8/Makefile
diff -u src/share/man/man8/Makefile:1.101 src/share/man/man8/Makefile:1.102
--- src/share/man/man8/Makefile:1.101 Tue Apr 26 16:57:39 2011
+++ src/share/man/man8/Makefile Tue Jan 31 12:23:33 2012
@@ -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.local.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 \
Added files:
Index: src/share/man/man8/man8.evbarm/Makefile
diff -u /dev/null src/share/man/man8/man8.evbarm/Makefile:1.3
--- /dev/null Tue Jan 31 12:23:33 2012
+++ src/share/man/man8/man8.evbarm/Makefile Tue Jan 31 12:23:33 2012
@@ -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>
Index: src/share/man/man8/man8.evbarm/bootmini2440.8
diff -u /dev/null src/share/man/man8/man8.evbarm/bootmini2440.8:1.1
--- /dev/null Tue Jan 31 12:23:33 2012
+++ src/share/man/man8/man8.evbarm/bootmini2440.8 Tue Jan 31 12:23:33 2012
@@ -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 <[email protected]>.
+.\"
+.\" 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 .
