[BACK]Return to mkubootimage.1 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / usr.bin / mkubootimage

Annotation of src/usr.bin/mkubootimage/mkubootimage.1, Revision 1.4

1.4     ! wiz         1: .\"    $NetBSD: mkubootimage.1,v 1.3 2012/12/01 05:26:16 matt Exp $
1.1       reed        2: .\"
                      3: .\" Copyright (c) 2012 The NetBSD Foundation, Inc.
                      4: .\" All rights reserved.
                      5: .\"
                      6: .\" This code is derived from software contributed to The NetBSD Foundation
                      7: .\" by Jeremy C. Reed
                      8: .\"
                      9: .\" Redistribution and use in source and binary forms, with or without
                     10: .\" modification, are permitted provided that the following conditions
                     11: .\" are met:
                     12: .\" 1. Redistributions of source code must retain the above copyright
                     13: .\"    notice, this list of conditions and the following disclaimer.
                     14: .\" 2. Redistributions in binary form must reproduce the above copyright
                     15: .\"    notice, this list of conditions and the following disclaimer in the
                     16: .\"    documentation and/or other materials provided with the distribution.
                     17: .\"
                     18: .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
                     19: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
                     20: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
                     21: .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
                     22: .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
                     23: .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
                     24: .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
                     25: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
                     26: .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
                     27: .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
                     28: .\" POSSIBILITY OF SUCH DAMAGE.
                     29: .\"
                     30: .Dd November 28, 2012
                     31: .Dt MKUBOOTIMAGE 1
                     32: .Os
                     33: .Sh NAME
                     34: .Nm mkubootimage
                     35: .Nd create U-Boot loader image
                     36: .Sh SYNOPSIS
                     37: .Nm
1.2       wiz        38: .Op Fl h
1.1       reed       39: .Fl A No ( arm Ns | Ns mips Ns | Ns mips64 Ns | Ns powerpc )
                     40: .Fl a Ar address
                     41: .Op Fl C No Po bz2 Ns | Ns gz Ns | Ns lzma Ns | Ns lzo Ns | Ns none Pc
                     42: .Op Fl E Ar address
                     43: .Op Fl e Ar address
                     44: .Op Fl m Ar magic
                     45: .Fl n Ar image
                     46: .Op Fl O No Po freebsd Ns | Ns linux Ns | Ns netbsd Ns | Ns openbsd Pc
                     47: .Fl T No ( fs Ns | Ns kernel Ns | Ns ramdisk Ns | Ns standalone )
                     48: .Ar source destination
                     49: .\"
                     50: .Sh DESCRIPTION
                     51: The
                     52: .Nm
                     53: utility is used to create an image for Das U-Boot, the
                     54: .Qq Universal Boot Loader .
                     55: .Pp
                     56: The arguments are as follows:
                     57: .Bl -tag -width indent
                     58: .It Fl A No ( arm Ns | Ns mips Ns | Ns mips64 Ns | Ns powerpc )
                     59: Defines the architecture.
                     60: This is required.
                     61: .It Fl a Ar address
                     62: Sets the image load address.
1.4     ! wiz        63: This is an integer between 0 and
        !            64: .Dv UINT32_MAX .
1.1       reed       65: This is required.
1.2       wiz        66: .It Fl C No ( bz2 Ns | Ns gz Ns | Ns lzma Ns | Ns lzo Ns | Ns none )
1.1       reed       67: Defines the compression.
                     68: The default is
                     69: .Qq none .
                     70: .It Fl E Ar address
                     71: Define the entry point.
1.4     ! wiz        72: This is an integer between 0 and
        !            73: .Dv UINT32_MAX .
1.1       reed       74: This option is the same as
                     75: .Fl e
                     76: but it inverts the bytes to convert the 32 bit integer
                     77: from little to big endian (or vice versa).
                     78: If
                     79: .Fl E
                     80: or
                     81: .Fl e
                     82: are not set, the entry point defaults to the
                     83: image load address
                     84: .Pq Fl a .
                     85: .It Fl e Ar address
                     86: Define the entry point.
1.4     ! wiz        87: This is an integer between 0 and
        !            88: .Dv UINT32_MAX .
1.1       reed       89: If
                     90: .Fl E
                     91: or
                     92: .Fl e
                     93: are not set, the entry point defaults to the
                     94: image load address
                     95: .Pq Fl a .
                     96: .It Fl h
                     97: Display the usage and exit.
                     98: .It Fl m Ar magic
                     99: Set the magic.
1.4     ! wiz       100: This is an integer between 0 and
        !           101: .Dv UINT32_MAX .
1.1       reed      102: The default is
1.2       wiz       103: .Qq 0x27051956 .
1.1       reed      104: .It Fl n Ar image
                    105: Defines the image name.
                    106: This is required.
                    107: .It Fl O No ( freebsd Ns | Ns linux Ns | Ns netbsd Ns | Ns openbsd )
                    108: Defines the operating system type.
                    109: The default OS name is
                    110: .Qq netbsd .
                    111: .It Fl T No ( fs Ns | Ns kernel Ns | Ns ramdisk Ns | Ns standalone )
                    112: Defines the image type.
                    113: This is required.
                    114: .El
                    115: .Pp
                    116: The required
                    117: .Ar source
                    118: argument is the filename of the kernel that is read.
                    119: The required
                    120: .Ar destination
                    121: argument is the filename of the image file that is created.
                    122: .\"
                    123: .Sh RETURN VALUES
                    124: .Nm
                    125: returns 1 on failure to read the kernel,
                    126: generate a header, or create the image.
                    127: .\"
                    128: .Sh EXAMPLES
                    129: Before the image is written, the header is displayed to standard out;
                    130: for example:
                    131: .Bd -literal -offset 0
                    132:  magic:       0x27051956
                    133:  time:        Tue Jun  7 15:58:41 2011
                    134:  size:        2482203
                    135:  load addr:   0x00020000
                    136:  entry point: 0x00020000
                    137:  data crc:    0x700fdf53
                    138:  os:          2 (netbsd)
                    139:  arch:        7 (powerpc)
                    140:  type:        2 (kernel)
                    141:  comp:        1 (gz)
                    142:  name:        NetBSD/evbppc 5.99.52 (INSTALL_PMPPC)
                    143:  header crc:  0x94ea96cf
                    144: .Ed
                    145: .\" TODO: check the name line above
                    146: .\" .Sh FILES
                    147: .Sh SEE ALSO
                    148: .Qq Das U-Boot - the Universal Boot Loader
                    149: .Pa http://www.denx.de/wiki/U-Boot/
                    150: .\"
                    151: .\" .Sh STANDARDS
                    152: .\"
                    153: .Sh HISTORY
                    154: The
                    155: .Nm
                    156: command first appeared in
                    157: .Nx 6.0 .
                    158: .\"
                    159: .Sh AUTHORS
                    160: The
                    161: .Nm
                    162: utility was originally written by Jared D. McNeill.
                    163: This manual page was written by Jeremy C. Reed.
                    164: .\" .Sh CAVEATS
                    165: .\" .Sh BUGS
                    166: .\" .Sh SECURITY CONSIDERATIONS

CVSweb <webmaster@jp.NetBSD.org>