dksetup(8)                                                       dksetup(8)

NAME
     dksetup - initialize/update physical disk configuration

SYNOPSIS
     dksetup -U devname [disktype]

     dksetup -I devname [disktype]

     dksetup -F devname [disktype]

     dksetup -N devname

     dksetup -R devname

     dksetup -X devname

     dksetup -L devname "string"

DESCRIPTION
     dksetup initializes a new disk or updates an existing disk for use
     with the current version of the system software. dksetup is a simpli-
     fied high level interface to the low level disk administration com-
     mands. Disk administration performed by dksetup includes:

     1. building nodes in /dev

     2. formatting disk media

     3. initializing disk configuration data structures (dkindex, dkpart,
        dktune, setinfo)

     4. writing the "Format Information Table" (FIT), if not available
        (format)

     5. Furthermore, the internal disk parameters are standardized in the
        same way as for the write/read cache and for error handling, if
        this was not already done at an earlier stage (setinfo).

     devname is the generic name of a disk device as displayed by auto-
     conf(8). For example, ios0/sdisk000 is the first IOS (SCSI) disk on
     the system. Device names of the type /dev/ios0/rsdisk012s0 may be used
     as well.

     disktype is a specification of the disk manufacturer's model number.
     The known type specifications are the names of files in the directory
     /etc/default/diskinfo/setinfo.

     If disktype is not specified, it is assumed that it is a disk not
     recognized by the system, i.e. there is no corresponding file in the
     directory /etc/default/diskinfo/setinfo. In this case, the disk is
     initialized with standard parameters.




Page 1                       Reliant UNIX 5.44                Printed 11/98

dksetup(8)                                                       dksetup(8)

     Specific administration tasks such as modifying disk partitioning,
     forwarding bad blocks, performance tuning, or building file systems
     may be done using the individual low-level commands dkpart, format,
     dktune, and mkfs.

OPTIONS
     -U   Upgrades a disk for the current release of the system software.
          This is non-destructive. It is always safe to run, even if the
          disk is being used. This initialization only takes place when it
          is determined that it has not yet been, or was only partially
          carried out. The significance of this option has been restricted
          in order to prevent certain attributes, such as the status of the
          write/read cache or the current operating mode, from being
          changed while the system is running.

     -I   Initialization as with the -U option is always carried out, but
          is only required for the first initialization of a disk.

     -F   Formats/initializes a new disk. Initializing a disk may include
          formatting of the media and writing default configuration parame-
          ters onto the disk. This is always DESTRUCTIVE. Great caution
          should be exercised to ensure that any useful data on the disk
          has been saved.

     -N   Builds the nodes of a new disk in /dev. This option should be
          used for removable disks, like ROD and WORM drives. For removable
          disks, default disk configuration data structures are calculated
          on first open. This option may be used even if no medium is in
          the drive.

     -R   Upgrades the LUN disk device specified. The other actions of
          option -U will be performed.

          Note:

          This option does only work with the optional sraid driver, and
          will fail with the standard sdisk driver.

     -X   Is only intended for a multi-hosted environment. If host1 changes
          the hard disk configuration (e. g. the partitioning), then host1
          can use the command "rsh dksetup -X devname" to tell host2 to
          read the current configuration the next time this disk is
          accessed.

     -L   This option allows you to change the name of the partition. This
          name is displayed when dkpart(8) and autoconf(8) are called. It
          is thus possible, for example, to change the autoconf display of
          the root disk from






Page 2                       Reliant UNIX 5.44                Printed 11/98

dksetup(8)                                                       dksetup(8)

          ios0/sdisk001 MP85 -- MP85

          to

          ios0/sdisk001 MP85 -- Root Disk Y543B00.

     For some I/O subsystems, it may be necessary to run dksetup -F on a
     disk to properly initialize it for the system. This is particularly
     true when a disk is moved over from an OSx (TOS) system to Reliant
     UNIX. SCSI disks in particular require dksetup -F to be run to re-
     install the Format Information Table on the disk. The option to
     install the IOS Format Information Table [see format(8) for RM600] is
     non-destructive. Refer to sdisk(7) for more information.

FILES
     /etc/default/diskinfo/setinfo
     /etc/default/diskinfo/dktune

SEE ALSO
     mkfs(1M), psdf(4), autoconf(8), dkindex(8), dkpart(8), dktune(8),
     format(8) [RM600 only], setinfo(8).

































Page 3                       Reliant UNIX 5.44                Printed 11/98