Manual Page Result
0
Command: gendisk | Section: 1 | Source: Digital UNIX | File: gendisk.1.gz
gendisk(1) General Commands Manual gendisk(1)
NAME
gendisk - produce distribution disk media
SYNOPSIS
/usr/bin/gendisk [ -wv ] [ -d ] [ hostname:]product-code special
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 mul-
tiple directories on the disk for separate products, and can also com-
bine 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/kit-
cap 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 ex-
ample, 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: myn-
ode: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 ap-
pended to the special device file used on the command line.
FLAGS
-d Specifies that the gendisk is to create a distribution disk inn
direct CD format. Direct CD format means that the distribution
disk contains file systems that are laid out just as the soft-
ware would be installed on the system.
-w Specifies that the gendisk is to write but not verify the prod-
uct media.
-v Specifies that the gendisk is to verify the product media with-
out writing it first.
If neither flag appears on the command line, the utility writes and
then verifies the files in the kit descriptor. The -d flag must be
used by itself or after the -v and -w flags.
RESTRICTIONS
You must be a superuser to run this program. If the optional hostname
is used, you must be able to access files on the remote host as supe-
ruser.
If the optional hostname 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 be-
fore 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
RELATED INFORMATION
Commands: gentapes(1), sum(1)
File formats: kitcap(4)
Guide to Preparing Product Kits delim off
gendisk(1)