Content-type: text/html Man page of gendisk

gendisk

Section: User Commands (1)
Index Return to Main Contents
 

NAME

gendisk - produces distribution disk media  

SYNOPSIS

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


 

OPTIONS

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. Specifies an alternate kitcap file to be used instead of the default /etc/kitcap file. Specifies that the gendisk is to write but not verify the product media. 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

Device special files Kit descriptor database
 

SEE ALSO

Commands: gentapes(1), sum(1)

Files: kitcap(4)

Guide to Preparing Product Kits


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
RESTRICTIONS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:46 GMT, October 02, 2010