


MKSOLO(8)                                               MKSOLO(8)


NNAAMMEE
       mksolo - make a bootable SOLO filesystem  (v0.25)

SSYYNNOOPPSSIISS
       mmkkssoolloo    [--hh]    [--dd]    [--vv]    [--uu]    [--bb bboooott__ddeevviiccee]
       [--rr rroooott__ddiirreeccttoorryy] [ccoonnffiigg__ffiillee]

DDEESSCCRRIIPPTTIIOONN
       mmkkssoolloo is used to map out a set of files needed for  boot-
       ing  a  system with SOLO, and to create a bootsector which
       is capable of loading the map and the  default  bootloader
       file.

OOPPTTIIOONNSS
       --hh     Print out usage information.

       --vv     Print out version information.

       --dd     Turns  on  debugging  output.   Without  this flag,
              mmkkssoolloo is mostly silent, but  with  it  turned  on,
              debugging  output  is listed which shows every file
              and device being mapped, along  with  disk  parame-
              ters.

       --uu     Uninstall.   Specifies  that the configuration file
              is to be used in  reverse.   The  previously  saved
              bootsector  (with  "saveboot=") will be restored to
              the specified boot location.  For this to work, the
              boot  device  (specified  with  "boot="  or  the --bb
              option) must not have  changed  between  the  first
              install that created this saved bootsector, and the
              uninstall.  Otherwise, a  bootsector  from  another
              location will be copied to the new location.  Thus,
              when changing the boot device, it is a wise idea to
              also  change  the  name of the saveboot file, or to
              remove the old one, since this file is only written
              if it does not already exist.

       --bb bboooott__ddeevviiccee
              Specifies  an  override  for the boot device, where
              the bootsector will be placed.   The  option  over-
              rides  the  "boot="  directive in the configuration
              file.  If neither the --bb  option  nor  the  "boot="
              directive   is  specified,  then  the  boot  device
              defaults to the device on which the specified  root
              directory is mounted.

       --rr rroooott__ddiirreeccttoorryy
              Specifies  the  directory to use as the root direc-
              tory.  If this is not given, then  it  defaults  to
              "/",  the  main root directory of the system (or of
              the  current  user,  if  it  is   overridden   with
              cchhrroooott(8).)




SHAGWARE               1996/11/05 08:03:49                      1





MKSOLO(8)                                               MKSOLO(8)


       ccoonnffiigg__ffiillee
              The name of the configuration file to use.  If this
              is not specified, it defaults to "sys/solo.cnf"

CCOONNFFIIGG FFIILLEE
       The configuration file used  by  mksolo  (commonly  called
       'solo.cnf') consists of a list of directives, and any num-
       ber of comments, which start with the '#'  character,  and
       go  to  the end of the line.  The following directives are
       supported:

       ccoommppaacctt
              This turns on sector  compacting,  which  joins  as
              many adjacent sectors as possible in each track, to
              reduce the size of the mapfile.  This option should
              probably always be specified.

       bboooott==_d_e_v_i_c_e
              This  directive  specified  the  boot device, which
              defaults to being the same device that  the  speci-
              fied  root  directory is on.  This directive can be
              overridden with the --bb option.

       bboooottbblloocckk==_f_i_l_e
              This required directive specifies the name  of  the
              binary  file  to  be  put  on the bootsector of the
              disk.  Generally, 'sys/shagboot.bin' is  specified.

       ssaavveebboooott==_f_i_l_e
              This  directive  specifies  the name of the file in
              which to save the  original  bootsector.   If  this
              file  already exists, it is not overridden.  If the
              boot sector was actually marked as bootable, with a
              0xaa66  flag  at  the  end of it, then this flag is
              changed to 0xaa66, to mark it as a "mergeable" boot
              sector,  and  the  original  location is written to
              bytes 3 through 6.  Then, if  SOLO  tries  to  boot
              such  a  sector, it knows to merge it with the cur-
              rent boot sector before executing it.   When  unin-
              stalling,  all  of  this information is restored to
              its original state.

       mmaapp==_f_i_l_e
              This required directive specifies the name  of  the
              file  to  be  used for saving the file map.  Gener-
              ally, 'sys/solo.map' is specified.

       llooaaddeerr==_f_i_l_e
              This required directive specifies the name  of  the
              binary  file to be loaded by the boot sector.  This
              is the same as specifying "image=", except that the
              file  index is marked in the boot sector as the one
              to boot from.




SHAGWARE               1996/11/05 08:03:49                      2





MKSOLO(8)                                               MKSOLO(8)


       iimmaaggee==_f_i_l_e
              This directive specifies the name of a file to  add
              to  the  file  map.  MMkkssoolloo will map out all of the
              sectors used by this file, and save a list of them,
              along  with  the name and last modification date of
              the file, to the map file.

AAUUTTHHOORR
       Frank Barrus - shaggy@csh.rit.edu
















































SHAGWARE               1996/11/05 08:03:49                      3


