gentapes [-w -v] [hostname:] product-code special

The -w option specifies that gentapes writes to the tape without verifying it; the -v option specifies that the command verifies a tape without writing to it first. If you specify neither option, gentapes writes the tape, rewinds it, and verifies its contents.

Note

The gendisk utility supports diskettes but does not support creation of a chained diskette kit. A kit written to diskette must fit on a single diskette or be packaged as a set of kits on separate diskettes.

The syntax of the gendisk command is as follows:

gendisk [-w -v ] [-d] [hostname:] product-code special

The -w option specifies that gendisk writes to the disk without verifying it; the -v option specifies that the command verifies a disk without writing to it first. If you specify neither option, gendisk writes the disk and verifies its contents.

The optional hostname argument is the name of a remote TCP/IP network machine that contains the /etc/kitcap file. The gendisk 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. If you do not specify a hostname, gendisk looks on your own system. You can use NFS file sharing to mount the kit files remotely on a system with the required disk drive.

The product-code is a user-defined code that describes the product. It should match the product name specified in the kitcap record, which is usually a concatenation of the NAME and VERS fields of the key file.

The special argument is the name of the device special file for the disk device, such as /dev/rrz1a.

You can use gendisk to produce kits in either tar or DCD format, depending on whether you use the -d option.

% gendisk ESA100 /dev/rz0c

Note

When testing a DCD kit, be sure to reference the kit media at its mount point. For instance, if you decide to use a spare disk partition for creating a media master area, you must reference your kit to the mount point of the device.

To create a kit on diskette for the /dev/edgd product, you would perform the following steps:

1. Place the diskette in the drive and format it, as follows:

   # fddisk -fmt /dev/rfd0c
   Disk type: 3.50 inch, HD (1.44MB)
   Number of sectors pertrack: 18
   Number of surfaces:   2
   Number of cylinders: 80
   Sector size:  512
   Interleave factor:  2:4
   Formatting disk...
     Percentage complete: Format complete, checking...
   Quick check of disk passes OK.

2. Write a disk label to the diskette:

   # disklabel -wr fd0 rx23

3. Run the gendisk utility to move the kit onto the diskette. In this example, the system name is visier.

   ---

   Warning

   Always answer n when the utility asks if you want to clean the diskette. Otherwise, gendisk replaces the current disk label with a default label.

   ---

   # gendisk -d EDG100 /dev/rfd0c
   Generating EDG100 Kit from visier on /dev/rfd0c
   
   WARNING:  this will remove any information stored in 
   /dev/rfd0c
   
   Are you sure you want to do this? (y/n): y
   
   Do you want to clean the entire disk first? (y/n): n
   Preparing /dev/rfd0c (floppy)
   done.
   
   Checking /dev/rfd0c
   /sbin/usf_fdck /dev/rfd0c
   ** /dev/rfd0c
   File system unmounted cleanly - no fsck needed
   
   Mounting /dev/rfd0c on /usr/tmp/cd_mdt8344
   
   Writing Images (dd=/).
   
   	Image instctrl...done.
   	Image EDGSTATIC100...done.
   
   Verifying Images (dd=/).
   
   	Image instctrl...done.
   	Image EDGSTATIC100...done.
   
   Kit EDG100 done.
   
   Cleaning up working directories.
   Unmounting /dev/rfd0c

4. Mount the diskette in preparation for making foreign device kit modifications:

   # mount /dev/fd0c /mnt
   
   # cd /mnt

5. Create the kitname.kk file:

   # touch ./instctrl/EDGSTATIC100.kk

6. Create the /sys/BINARY and /etc directories on the diskette:

   # mkdir -p ./sys/BINARY
   
   # mkdir ./etc

7. Copy the name.kit file from the kit-building area to the diskette:

   # cp /kit_area/edgd.kit ./

8. Create a link from the driver's module file in the kit area to the /sys/BINARY directory:

   # cd ./sys/BINARY
   
   # ln -s ../../usr/opt/EDG100/edgd.mod ./edgd.mod

9. Create a link from the sysconfigtab database file in the product area to /etc/sysconfigtab:

   # cd ../../etc
   
   # ln -s ../usr/opt/EDG100/sysconfigtab ./sysconfigtab
   
   # cd /

10. Move the instctrl directory to an empty directory. (The gendisk utility places the instctrl directory in the top-level directory, by default. To support RIS installation, you must move the instctrl directory to an empty directory. Otherwise, the RIS utility cannot recognize the kit.) For example:

    # mkdir -p /mnt/ALPHA/EDGSTATIC100
    
    # mv /mnt/instctrl /mnt/ALPHA/EDGSTATIC100

11. Unmount the diskette:

    # umount /mnt

To create the /dev/edgd kit on CD-ROM media, perform steps 3 through 11 and use a hard disk as the target instead of a diskette. The hard disk serves as the master for the kit. You can then burn the kit onto the CD-ROM, following the instructions that come with your CD-ROM device.