usr.sbin/boot98cfg/boot98cfg.8

   1 .\" Copyright (c) KATO Takenori, 2000.
   2 .\"
   3 .\" All rights reserved.  Unpublished rights reserved under the copyright
   4 .\" laws of Japan.
   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 .\"
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer as
  12 .\"    the first lines of this file unmodified.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. The name of the author may not be used to endorse or promote products
  17 .\"    derived from this software without specific prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  20 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  21 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  22 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  24 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  28 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .\" $FreeBSD: src/usr.sbin/boot98cfg/boot98cfg.8,v 1.1.2.8 2003/03/11 21:13:48 trhodes Exp $
  31 .\" $DragonFly: src/usr.sbin/boot98cfg/Attic/boot98cfg.8,v 1.2 2003/06/17 04:29:52 dillon Exp $
  32 .\"
  33 .Dd July 10, 2000
  34 .Dt BOOT98CFG 8
  35 .Os
  36 .Sh NAME
  37 .Nm boot98cfg
  38 .Nd HDD boot manager installation utility
  39 .Sh SYNOPSIS
  40 .Nm
  41 .Op Fl B
  42 .Op Fl i Ar boot0
  43 .Op Fl m Ar boot0.5
  44 .Op Fl s Ar secsize
  45 .Op Fl v Ar version
  46 .Op Fl f Ar boot0.bak
  47 .Op Fl F Ar boot0.5.bak
  48 .Ar disk
  49 .Sh DESCRIPTION
  50 On NEC PC-98s,
  51 .Sq boot loader
  52 consists of the
  53 .Sq IPL
  54 and
  55 .Sq HDD boot menu .
  56 The IPL occupies sector 0 of a disk and is followed by the partition
  57 table.  The IPL loads the HDD boot menu that starts from 0x400.
  58 .Pp
  59 The
  60 .Nm
  61 utility installs and makes backup copy of the IPL and the HDD boot menu; and
  62 allows changing the version number field in the sector 0.
  63 .Pp
  64 Note that the format command in NEC's OSs replaces the HDD boot menu
  65 with its own HDD boot menu when the version number field is smaller
  66 than that in the format command.
  67 .Pp
  68 The options are:
  69 .Bl -tag -width indent
  70 .It Fl B
  71 Install the IPL and HDD boot menu.  This option causes the IPL and HDD
  72 boot menu code to be replaced.
  73 .It Fl i Ar boot0
  74 Specify which IPL image to use.  The default is /boot/boot0.
  75 .It Fl m Ar boot0.5
  76 Specify which HDD boot menu image to use.  The default is
  77 /boot/boot0.5.
  78 .It Fl f Ar boot0.bak
  79 Specify that a backup copy of the preexisting IPL should be written to
  80 .Ar boot0.bak .
  81 This file is created if it does not exist, and truncated if it does.
  82 .It Fl F Ar boot0.5.bak
  83 Specify that a backup copy of the preexisting HDD boot menu should be
  84 written to
  85 .Ar boot0.5.bak .
  86 This file is created if it does not exist, and truncated if it does.
  87 .It Fl v Ar version
  88 Specify the version number.
  89 .It Fl s Ar secsize
  90 Specify the sector size.  The default sector size is 512
  91 (bytes/sector).
  92 .El
  93 .Sh SEE ALSO
  94 .Xr boot 8 ,
  95 .Xr fdisk 8
  96 .Sh DIAGNOSTICS
  97 .Ex -std
  98 .Sh AUTHORS
  99 .An NOKUBI Hirotaka ,
 100 .An KATO Takenori