setvtoc(1M)                                                     setvtoc(1M)


   NAME
         setvtoc - populate VTOC on hard disks

   SYNOPSIS
         /sbin/setvtoc [-d data] [-i] [-n volume_name] [-s datafile] [-p]
         /dev/rdsk/c?d?s?

   DESCRIPTION
         The setvtoc command creates (or updates) the VTOC (Volume Table of
         Contents) on hard disks.  The /dev/rdsk/c?d?s?  file must be the
         character special file of the device where the new VTOC is to be
         installed.

   OPTIONS
         The following options apply to setvtoc:

         -d data
               The data argument of this option is a string representing the
               information for a particular partition in the current VTOC.
               The string must be of the format part:tag:flag:start:size where
               part is the partition number, tag is the ID tag of the
               partition, flag is the set of permission flags, start is the
               starting sector number of the partition, and size is the number
               of sectors in the partition.  See the description of the
               datafile below for more information on these fields.  This
               option assumes that a VTOC is already present on disk.

         -i    Initialise the vtoc on a new disk, with one mountable partition
               the size of the allocatable disk (partition zero, with a
               partition tag of V_HOME).

         -n volume_name
               Allows the disk to be given a volume_name up to 8 characters
               long.  This option assumes that a VTOC is already present on
               disk.

         -s datafile
               The VTOC is populated according to a datafile created by the
               user.  The datafile format is described below.  This option
               causes all of the disk partition timestamp fields to be set to
               zero.

         -p    Lets the command create the desired VTOC, but prints the
               information to standard output instead of modifying the VTOC on
               the disk. This option can only be used be with one of the above
               options.

         Partitions with partition tags V_FULLDISK and V_OVERLAP are the only
         partitions that can overlap others.




   7/91                                                                 Page 1

   setvtoc(1M)                                                     setvtoc(1M)


         The datafile contains one specification line for each partition,
         starting with partition 0.  Each line is delimited by a new-line
         character (\n).  If the first character of a line is an asterisk (*),
         the line is treated as a comment.  Each line is composed of entries
         that are position-dependent, separated by "white space" and having
         the following format:

               partition  tag  flag  starting_sector  size_in_sectors

         where the entries have the following values:

         partition        The partition number: 0-15 decimal or 0x0-0xf
                          hexadecimal.

         tag              The partition tag:  a two-digit hex number.  The
                          following are reserved codes:  0x01 (V_BOOT), 0x02
                          (V_ROOT), 0x03 (V_SWAP), 0x04 (V_USR), 0x05 (V_VAR),
                          0x06 (V_STAND), 0x07 (V_BACKUP/V_FULLDISK), 0x08
                          (V_HOME) and 0x09 (V_OVERLAP).

         flag             The flag allows a partition to be flagged as
                          unmountable or read only, the masks being:  V_UNMNT
                          0x01, and V_RONLY 0x10.  For mountable partitions
                          use 0x00.

         starting sector  The physical sector number (decimal) at which the
                          partition starts.

         size in sectors  The number (decimal) of sectors occupied by the
                          partition.

               Note that you can save the output of a prtvtoc command to a



         file, edit the file, and use it as the datafile argument to the -s
         option.

   SEE ALSO
         prtvtoc(1M),

   NOTES
         Special care should be exercised when overwriting an existing VTOC,
         as incorrect entries could result in current data being inaccessible.
         As a precaution, save the old VTOC.








   Page 2                                                                 7/91