Return to installboot.8 CVS log

Up to [local] / sys / arch / sparc64 / stand / installboot

Annotation of sys/arch/sparc64/stand/installboot/installboot.8, Revision 1.1

1.1     ! nbrk        1: .\"    $OpenBSD: installboot.8,v 1.8 2007/05/31 19:20:05 jmc Exp $
        !             2: .\"    $NetBSD: installboot.8,v 1.1 1995/09/30 21:32:14 pk Exp $
        !             3: .\"
        !             4: .\" Copyright (c) 1995 Paul Kranenburg
        !             5: .\" All rights reserved.
        !             6: .\"
        !             7: .\" Redistribution and use in source and binary forms, with or without
        !             8: .\" modification, are permitted provided that the following conditions
        !             9: .\" are met:
        !            10: .\" 1. Redistributions of source code must retain the above copyright
        !            11: .\"    notice, this list of conditions and the following disclaimer.
        !            12: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            13: .\"    notice, this list of conditions and the following disclaimer in the
        !            14: .\"    documentation and/or other materials provided with the distribution.
        !            15: .\" 3. All advertising materials mentioning features or use of this software
        !            16: .\"    must display the following acknowledgement:
        !            17: .\"      This product includes software developed by Paul Kranenburg.
        !            18: .\" 3. The name of the author may not be used to endorse or promote products
        !            19: .\"    derived from this software without specific prior written permission
        !            20: .\"
        !            21: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
        !            22: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
        !            23: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
        !            24: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
        !            25: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
        !            26: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
        !            27: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
        !            28: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
        !            29: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
        !            30: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
        !            31: .\"
        !            32: .Dd $Mdocdate: May 31 2007 $
        !            33: .Dt INSTALLBOOT 8 sparc64
        !            34: .Os
        !            35: .Sh NAME
        !            36: .Nm installboot
        !            37: .Nd install a bootstrap on an FFS filesystem partition
        !            38: .Sh SYNOPSIS
        !            39: .Nm installboot
        !            40: .Op Fl nv
        !            41: .Ar bootblk
        !            42: .Ar device
        !            43: .Sh DESCRIPTION
        !            44: .Nm installboot
        !            45: prepares an FFS filesystem partition for boot-strapping from the PROM.
        !            46: The sparc bootblocks are split into two parts: a small first-stage program that
        !            47: is written into the superblock area in a partition
        !            48: .Po
        !            49: and hence is limited in size to SBSIZE - DEV_BSIZE bytes
        !            50: .Pc ,
        !            51: and a second-stage program that resides in the filesystem proper.
        !            52: The first-stage program is loaded into memory by the PROM.
        !            53: After it receives control, it loads the second stage program
        !            54: .Ar ofwboot
        !            55: from the filesystem.
        !            56: The second-stage boot program uses the device driver interface to
        !            57: the PROM and the stand-alone filesystem code in
        !            58: .Dq libsa.a
        !            59: to locate and load the kernel.
        !            60: The second-stage boot program and the prototype code for the
        !            61: first-stage bootprogram can be found in
        !            62: .Pa /usr/mdec/ofwboot
        !            63: and
        !            64: .Pa /usr/mdec/bootblk
        !            65: respectively.
        !            66: The second-stage program commonly resides in the root directory as
        !            67: .Pa /ofwboot .
        !            68: .Pp
        !            69: The options are as follows:
        !            70: .Bl -tag -width flag
        !            71: .It Fl n
        !            72: Do not actually write anything on the disk.
        !            73: .It Fl v
        !            74: Verbose mode.
        !            75: .El
        !            76: .Pp
        !            77: The arguments are:
        !            78: .Bl -tag -width ofwboot
        !            79: .It Ar bootblk
        !            80: the name of the prototype file for the first stage boot program.
        !            81: .It Ar device
        !            82: the name of the raw device in which the first-stage boot program
        !            83: is to be installed.
        !            84: This should correspond to the block device on which the file system containing
        !            85: .Ar ofwboot
        !            86: is mounted.
        !            87: .El
        !            88: .Sh EXAMPLES
        !            89: The following commands will install the first-stage bootblocks in the
        !            90: root filesystem
        !            91: .Pq assumed to be mounted on Dq sd0a
        !            92: using the file
        !            93: .Pa /ofwboot
        !            94: as the second-level boot program:
        !            95: .Bd -literal -offset indent
        !            96: # cp /usr/mdec/ofwboot /ofwboot
        !            97: # /usr/mdec/installboot /usr/mdec/bootblk /dev/rsd0c
        !            98: .Ed
        !            99: .Sh SEE ALSO
        !           100: .Xr boot 8 ,
        !           101: .Xr disklabel 8 ,
        !           102: .Xr init 8
        !           103: .Sh HISTORY
        !           104: The
        !           105: .Nm installboot
        !           106: first appeared in
        !           107: .Nx 1.1 .
        !           108: .Sh BUGS
        !           109: .Nm installboot
        !           110: requires simultaneous access to the mounted file system and
        !           111: the raw device, but that is not allowed with the kernel
        !           112: .Dv securelevel
        !           113: variable set to a value greater than zero
        !           114: .Pq the default ,
        !           115: so
        !           116: .Nm installboot
        !           117: only works in single-user mode
        !           118: .Pq or insecure mode - see Xr init 8 .