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 <p...@xpg.dk>. +.\" +.\" 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 .