Index for Section 1

Alphabetical listing for G

gendisk(1)
NAME
  gendisk - produces distribution disk media

SYNOPSIS
  /usr/bin/gendisk [-wv] [-d] [-k filename] [hostname:]product-code special

OPTIONS
  -d  Specifies that the gendisk is to create a distribution disk in direct
      CD format.  Direct CD format means that the distribution disk contains
      file systems that are laid out just as the software would be installed
      on the system.

  -k filename
      Specifies an alternate kitcap file to be used instead of the default
      /etc/kitcap file.

  -w  Specifies that the gendisk is to write but not verify the product
      media.

  -v  Specifies that the gendisk is to verify the product media without
      writing it first.

  If neither option appears on the command line, the utility writes and then
  verifies the files in the kit descriptor.  The -d option must be used by
  itself or after the -v and -w options.

DESCRIPTION
  The gendisk utility is used to produce distribution media on removable
  moving-head disks (not floppies).  The utility searches /etc/kitcap for the
  product-code (as provided by the user on the command line), creates a new
  file system on the partition defined in the kit description, mounts the
  disk, transfers files and subsets as described in the kitcap kit
  description, uses sum(1) to verify files for accuracy in transfer, and then
  unmounts the file system.  The gendisk utility can create multiple
  directories on the disk for separate products, and can also combine
  multiple products into one product, all controlled by /etc/kitcap.

  The optional hostname: argument is the name of a remote TCP/IP network
  machine that contains the kitcap file.  The utility searches /etc/kitcap on
  the remote machine for the product-code and uses it for creating the media.
  The colon (:) is a required delimiter for TCP/IP networks, and space is
  permitted between the colon and the product-code. For example, if the
  product code is ULT-4.2-V-BW, and the kitcap file to be used is on node
  mynode, the proper syntax for this option is:

       mynode:ULT-4.2-V-BW

  The product-code is a user defined code.  It can be any set of numbers or
  letters, and is usually formed in a way to have some meaning as to the
  product that it describes.  For example, if the product's name is MYP and
  its version is 1, a proper product-code for that product might be MYP010.

  The special argument indicates that the device is a special device such as
  /dev/rrz1a. The actual partition that the utility will write the files on
  is defined in the kitcap description for the product-code that is being
  used.	 Therefore, it makes no difference what partition is appended to the
  special device file used on the command line.

RESTRICTIONS
  You must be a superuser to run this program.	If the optional host name is
  used, you must be able to access files on the remote host as superuser.

  If the optional host name is not used, you can access the files used by
  gendisk only if the local hostname is added to the local /.rhosts file, as
  follows:

       hostname root

  The gendisk command asks whether you want to clean the whole disk before
  writing to it.  If you answer affirmatively, gendisk erases the entire
  contents of the disk and writes a new disk label using default information.

FILES
  /dev/rz?a
      Device special files

  /etc/kitcap
      Kit descriptor database

SEE ALSO
  Commands: gentapes(1), sum(1)

  Files: kitcap(4)

  Guide to Preparing Product Kits