Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ partinit(1m) — Atari System V ue12

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

format(1M)

setvtoc(1M)

scsiblk(1M)

hd(7)





   partinit(1M)                      (Atari)                      partinit(1M)


   NAME
         partinit - install or amend a TOS disk partition

   SYNOPSIS
         /usr/sbin/partinit [-I] [-i] [-b] [-n] [-m] [-p] [-Z] [-P partdata]
         [-f datafile] [-u file] [-t file] -o raw_device

   DESCRIPTION
         partinit is a program that is used in preparing a disk for use with
         UNIX.  It sets up the TOS partition table in block zero of the disk
         and installs the bootstraps.

         The following options apply to partinit:

         -I    Block zero should be cleared, destroying any existing partition
               table.

         -i    Install bootstrap files. One bootstrap is installed in block
               zero, either the default file /etc/T0boot, or the file
               specified with the -t option. The other bootstrap, default
               /etc/U0boot, or the file specified with the -u option, is
               installed on the first block of the UNIX partition. If there is
               a TOS partition table but no UNIX partition, then this second
               bootstrap is not installed.  If there is not a TOS partition
               table then this bootstrap is installed in block zero.

         -b    Adjust the checksum on block zero to identify the disk as
               bootable.

         -n    Adjust the checksum on block zero to identify the disk as not
               bootable.

         -m    Interactively modify the TOS partition table.  The program will
               prompt for a partition number (0-3).  A newline, or non-digit
               character, will print out the current partition table. A 'q'
               character will write any changes and terminate the program.  An
               EOF character will abandon any changes and terminate the
               program.  Once a partition number has been selected, the
               following fields can be modified. A newline will leave the
               field unchanged.

               Flag: One of St-boot, Delete, Unix-boot or Non-boot.  St-boot
                     sets this partition to be an ST boot partition.  Delete
                     removes this entry from the partition table.  Unix-boot
                     sets this partition to be  UNIX boot partition.  Non-boot
                     unsets the current bootable status of the selected
                     partition.

               ID    A three character identification string. For  UNIX
                     partition this must be set to UNX.



   7/91                                                                 Page 1









   partinit(1M)                      (Atari)                      partinit(1M)


               Start sector
                     The first sector of this partition.

               Size  The number of sectors in this partition.

         -p    Display the partition table on the standard output, then exit.
               No modifications are made.  For the -p option only, the exit
               code of the program is 10 plus the number of valid partitions
               found.

         -Z    Normally, partinit delays for 10 seconds before writing block
               zero to allow the user to change his mind before committing
               changes to disk.  Use of the -Z option inhibits this delay.
               This option is intended for use only by programs which
               automatically generate the data for partinit and theoretically
               "know what they are doing".

         -P partdata
               The partdata argument of the -P option is a string representing
               the information for a particular partition. The string must be
               of the format part:start:size:tag:flag where part is the
               partition number, start is the starting sector number of the
               partition, size is the number of sectors in the partition, tag
               is the three-character identification string (must be UNX for a
               UNIX partition), and flag is the partition flags in hex.  Some
               special arguments are allowed; if size is set to FILL, then the
               size will be set so that the partition consumes the rest of the
               available disk.  Flag can either be a hex number or the
               symbolic names STBOOT, UNIXBOOT, or NONBOOT, which correspond
               to hex values of 0x81, 0x41, and 0x01, respectively.

         -f datafile
               Set the partition table from data obtained from datafile.
               Format is similar to that for the -P option, except that spaces
               are used as field separators instead of the character ':', and
               that the symbolic names FILL, STBOOT, UNIXBOOT, and NONBOOT are
               not valid.

         -u file
               Set the bootstrap to be loaded into block zero of the UNIX
               partition to file.  If this option is not specified, the
               default /etc/U0boot will be used.

         -t file
               Set the bootstrap to be loaded into block zero to file.  If
               this option is not specified, the default /etc/T0boot will be
               used.

         -o raw_device
               Specifies the device to which the modifications should be
               applied. This argument must be present, and must be a character


   Page 2                                                                 7/91









   partinit(1M)                      (Atari)                      partinit(1M)


               special device that references the whole physical disk, e.g.
               /dev/rdsk/c0d0 (see hd(7)).

   NOTES
         All sectors are in 512 byte units.

         You can save the output of partinit -p to a file, edit the file, and
         use it as the datafile argument to the -f option.

         Once partinit has been used to create  UNIX partition, format(1M)
         should be used to set up the disk label, then setvtoc(1M) used to
         partition the UNIX partition.

         There is expected to be only one UNIX partition per drive.  While
         partinit will allow additional UNIX partitions to be set up, they
         cannot be made "bootable", i.e., the bootstrap file will not be
         installed.  A UNIX partition can coexist with one or more (possibly
         bootable) TOS partitions, however.

         Partinit does not work on floppy disks.

         The program is unable to modify a DOS format partition, although the
         -I option can be used to delete the DOS partition table.

   FILES
         /etc/T0boot
         /etc/U0boot

   SEE ALSO
         format(1M), setvtoc(1M), scsiblk(1M), hd(7).

   DIAGNOSTICS
         The program warns if any of the partitions overlap each other or if
         they exceed the physical limits of the disk drive.

   WARNINGS
         Never use partinit on an active disk.
















   7/91                                                                 Page 3





Typewritten Software • bear@typewritten.org • Edmonds, WA 98026