share/man/man8/man8.sparc/binstall.8

   1 .\"     $NetBSD: binstall.8,v 1.4 2008/05/29 14:51:25 mrg Exp $
   2 .\"
   3 .\" Copyright (c) 2002 Matthew R. Green
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  20 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  21 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  22 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  23 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  25 .\" SUCH DAMAGE.
  26 .\"
  27 .Dd January 6, 2002
  28 .Dt BINSTALL 8 sparc
  29 .Os
  30 .Sh NAME
  31 .Nm /usr/mdec/binstall
  32 .Nd install sparc and sparc64 boot blocks
  33 .Sh SYNOPSIS
  34 .Nm
  35 .Op Fl htUuv
  36 .Op Fl b Ar bootprog
  37 .Op Fl f Ar filesystem
  38 .Op Fl m Ar mdec
  39 .Op Fl i Ar installbootprog
  40 .Oo
  41 .Dq net
  42 .Ns \&|
  43 .Dq ffs
  44 .Oc
  45 .Op directory
  46 .Sh DESCRIPTION
  47 The
  48 .Nm
  49 program prepares a sparc or sparc64 system for booting, either from local
  50 disk from a
  51 .Dq ffs
  52 partition or over the network.  The default type of boot block installed
  53 is derived from the host system.  If it is an UltraSPARC, the sparc64
  54 boot blocks will be used, otherwise the SPARC boot blocks will be used.
  55 .Nm
  56 can be forced to prepare a disk for either.
  57 .Sh OPTIONS
  58 The following options are available:
  59 .Bl -tag -width 123456
  60 .It Fl b
  61 Set the second stage boot program to
  62 .Ar bootprog .
  63 This will typically be
  64 .Pa boot.net
  65 for sparc systems and
  66 .Pa ofwboot.net
  67 for sparc64 systems.
  68 .It Fl f
  69 Set the path to the filesystem being installed for to
  70 .Ar filesystem .
  71 This is otherwise derived from the
  72 .Op directory .
  73 .It Fl h
  74 Display help.
  75 .It Fl i
  76 Set the path to the
  77 .Xr installboot 8
  78 program to
  79 .Ar installbootprog .
  80 This is useful for using
  81 .Nm
  82 on non-sparc or sparc64 systems.
  83 .It Fl m
  84 Sets the path to the machine dependent directory to
  85 .Ar mdec .
  86 This is the directory that both the boot blocks and the
  87 .Xr installboot 8
  88 program live.
  89 .It Fl t
  90 Test mode; does not run any program.  Implies the
  91 .Fl v
  92 option.
  93 .It Fl U
  94 Install sparc (SPARC) boot blocks.
  95 .It Fl u
  96 Install sparc64 (UltraSPARC) boot blocks.
  97 .It Fl v
  98 Be verbose.
  99 .El
 100 .Sh SEE ALSO
 101 .Xr disklabel 8 ,
 102 .Xr installboot 8