vtoc(1M)                                                           vtoc(1M)


   NAME
         vtoc - install or amend a VTOC interactively

   SYNOPSIS
         /usr/bin/vtoc raw_device

   DESCRIPTION
         Vtoc displays the current VTOC on the disk selected by the argument.
         Each entry in the partition table in the VTOC is displayed if its
         size is non zero, or if the entry is locked, (Locked entries are
         described below), or if it is the currently selected entry.  Each
         entry consists of one line on the display, and has the following
         fields:

         Id    The slice number of the partition.

         Tag   The type of the entry, one of Boot, Root, Swap, Stand, User,
               Var, Home, Over or Full. These tags values are defined in the
               file /usr/include/sys/vtoc.h.

         Flag  A 'm' in this field indicates that the partition is mountable.
               A 'r' in this field indicates that the partition is read-only.

         Start The start sector of the partition. Sectors are in 512 byte
               units.

         Size  The size in sectors of the partition. This field is followed by
               the size represented in megabytes.

         The currently selected partition is denoted by a '>' character in the
         Id field. A locked partition is denoted by a '*' character in the Id
         field.

         Commands are single characters, and normally effect only the
         currently selected entry.

         Tag commands.

         B     Set Tag to V_BOOT.

         R     Set tag to V_ROOT.

         U     Set tag to V_USR.

         V     Set tag to V_VAR

         H     Set tag to V_HOME.

         S     Set tag to V_STAND.




   12/91                                                                Page 1

   vtoc(1M)                                                           vtoc(1M)


         W     Set tag to V_SWAP.

         O     Set tag to V_OVERLAP.

         F     Set tag to V_FULLDISK.

         Flag commands:

         m     Toggle the mountable flag.

         r     Toggle the read only flag.

         Other commands

         s     Set the size. The following digits will be used to specify the
               new size of the partition. If the digits are terminate by a 'M'
               character, the the digits are interpreted as Megabytes.

         q     Quit.

         w     Write the new VTOC and quit. The program will ask for
               confirmation.

         l     Toggle the lock flag. You cannot lock V_OVERLAP or V_FULLDISK
               entries.

         u     Unlock all the entries.

         +     Increment the size by 10 Megabytes.

         -     Decrement the size by 10 Megabytes.

         >     Increment the size by 1 Megabyte.

         <     Decrement the size by 1 Megabye.

         The current entry is selected by a character between '0' and 'f'.
         The program will try to adjust the start field in each entry such
         that there are no gaps between entries.  All the free space will
         therefore be available for allocation to the last entry.  A locked
         entry stops the program from changing its start field.  All size
         requests are rounded down to fit into the available space.

   SEE ALSO
         setvtoc(1M), prtvtoc(1M), /usr/include/sys/vtoc.h.

   WARNINGS
         Never use vtoc on an active disk.





   Page 2                                                                12/91