NAME

loadimg − CD-ROM test image loader

SYNOPSIS

loadimg [-f imagesource] diskdev
loadimg -t [-f imagesource]

SUMMARY

loadimg is designed to be used as a test tool for CD-ROM images created by fsgen. The program loads an entire CD-ROM image onto a raw disk device where it can be examined as if it was recorded on a CD-ROM (but read-write). The intent is to allow examination of CD-ROM images that were prepared on tape.  The loadimg program requires a scratch disk drive of sufficient size to hold the supplied image. 

DESCRIPTION

The loadimg program normally requires only one argument, diskdev, or the destination disk drive.  The raw disk device of the target disk drive should be supplied.  The entire disk drive is used to load the supplied CD-ROM image; the original contents of the disk is entirely destroyed.  Since access to the raw disk devices is usually restricted to root, this program must be run as Superuser. 

An optional -t argument, provides a slice-table dump from the source image.  If the -t option is used, no attempt is made to copy the image and it is not necessary to supply a diskdev argument. 

The loadimg program assumes a default image source of the tape drive /dev/rmt/ctape.  If the source image is in another location, use the -f option to supply a new source path.  For example, to load an image from tape to the second disk drive on the first SCSI bus on an MVME328 disk controller, the command is:

$ loadimg -f /dev/rmt/r40t /dev/rdsk/m328_c0d2s7

or

$ loadimg /dev/rdsk/m328_c0d2s7

The loadimg program checks to see that the source image will fit on the supplied drive before copying the image.  It also checks that both the source image and the target disk drive have valid initial formats, and that both have valid Motorola Volume Identification blocks (VIDs).  For this reason, the target disk drive must have been correctly formatted and the CD-ROM image must begin with a MOTVID slice (see the fsgen (1) utility). 

The loadimg utility preserves the initial contents of the VID block on the target disk drive except for those fields that indicate bootloader address and root file system offset.  The target disks slice table are replaced with the source image´s slice table except for slice 7 (the entire disk).  If the target disk drive needs to be returned to normal use, run the fmthard and prtvtoc utilities to reslice the disk and build the required file systems. 

WARNINGS AND DIAGNOSTICS.

While running, various progress messages are printed, along with a slice table dump for the source image.  If either the source image or the target disk drive are found not to have a valid VID block, the loadimg program aborts.  Also, if the source image is found to be too big to fit on the target disk, the copy is not performed. 

loadimg always terminates with a zero exit value unless an error is encountered.  The exit value is picked from the common set of exit values used by the CD-ROM tools.  These exit values are listed in the following table:
 

SEE ALSO

fsgen(1), fscoll(1). 
CD-ROM Image Generation Tools User’s Guide
 

  —  Motorola, Inc.