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 .\"
  32 .Dd July 10, 2000
  33 .Dt BOOT98CFG 8
  34 .Os
  35 .Sh NAME
  36 .Nm boot98cfg
  37 .Nd HDD boot manager installation utility
  38 .Sh SYNOPSIS
  39 .Nm
  40 .Op Fl B
  41 .Op Fl i Ar boot0
  42 .Op Fl m Ar boot0.5
  43 .Op Fl s Ar secsize
  44 .Op Fl v Ar version
  45 .Op Fl f Ar boot0.bak
  46 .Op Fl F Ar boot0.5.bak
  47 .Ar disk
  48 .Sh DESCRIPTION
  49 On NEC PC-98s,
  50 .Sq boot loader
  51 consists of the
  52 .Sq IPL
  53 and
  54 .Sq HDD boot menu .
  55 The IPL occupies sector 0 of a disk and is followed by the partition
  56 table.  The IPL loads the HDD boot menu that starts from 0x400.
  57 .Pp
  58 The
  59 .Nm
  60 utility installs and makes backup copy of the IPL and the HDD boot menu; and
  61 allows changing the version number field in the sector 0.
  62 .Pp
  63 Note that the format command in NEC's OSs replaces the HDD boot menu
  64 with its own HDD boot menu when the version number field is smaller
  65 than that in the format command.
  66 .Pp
  67 The options are:
  68 .Bl -tag -width indent
  69 .It Fl B
  70 Install the IPL and HDD boot menu.  This option causes the IPL and HDD
  71 boot menu code to be replaced.
  72 .It Fl i Ar boot0
  73 Specify which IPL image to use.  The default is /boot/boot0.
  74 .It Fl m Ar boot0.5
  75 Specify which HDD boot menu image to use.  The default is
  76 /boot/boot0.5.
  77 .It Fl f Ar boot0.bak
  78 Specify that a backup copy of the preexisting IPL should be written to
  79 .Ar boot0.bak .
  80 This file is created if it does not exist, and truncated if it does.
  81 .It Fl F Ar boot0.5.bak
  82 Specify that a backup copy of the preexisting HDD boot menu should be
  83 written to
  84 .Ar boot0.5.bak .
  85 This file is created if it does not exist, and truncated if it does.
  86 .It Fl v Ar version
  87 Specify the version number.
  88 .It Fl s Ar secsize
  89 Specify the sector size.  The default sector size is 512
  90 (bytes/sector).
  91 .El
  92 .Sh SEE ALSO
  93 .Xr boot 8 ,
  94 .Xr fdisk 8
  95 .Sh DIAGNOSTICS
  96 .Ex -std
  97 .Sh AUTHORS
  98 .An NOKUBI Hirotaka ,
  99 .An KATO Takenori