DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

cdmt.config(CDMT)


cdmt.config -- specify default CDMT configuration

Description

The optional configuration file, cdmt.config defines the default CDMT configuration.

The following records can be defined in cdmt.config; all records are optional:


MACROS
Define macros to use for macro substitution in attribute values.

The syntax for MACROS is:

MACROS:
 
macroName = macroValue
macroName = macroValue
macroName = macroValue

 MACROS:
 macroName   =   macroValue
 macroName   =   macroValue
 macroName   =   macroValue
By default, the user's shell environment variables are defined as CDMT macros. If a macro name is both a shell environment variable and defined in the MACROS record, the definition in the MACROS record takes precedence.

Valid macro names consist of letters, digits, and the underscore (_) character, and is denoted in the attribute value by preceding the macro name with the dollar sign ($) character.

You can delimit a macro name using braces ({ }). For example:

PKG_DIR=${CDMT_PKG}/man.pkg

Once you define a macro, you can use it immediately. For example:

MACROS:
CDMT_EXAMPLES = $CDMT_DIR/examples
CDMT_PRODUCT = $CDMT_EXAMPLES/product


COMPONENT_ORDER
Specify the order in which the components appear on the media.

The syntax for COMPONENT_ORDER is:

COMPONENT_ORDER:
 
integer = componentID|componentCode
integer = componentID|componentCode
integer = componentID|componentCode

 COMPONENT_ORDER:
 integer   =   componentID|componentCode
 integer   =   componentID|componentCode
 integer   =   componentID|componentCode
Use this record for increasing seek efficiency on the media, not for installation order; installation order cannot be guaranteed.

Specify the order using integers, beginning with 1 in ascending order.

For example:

COMPONENT_ORDER:
1 = SCO:cdmt::1.0.1
2 = SCO:WServer::4.0
3 = SCO:XClients::1.0

This example specifies that the CDMT component appears first, WServer appears second, and XClients appears third on the media.


NOTE: If you do not specify a number in the order (for example, you did not specify CDMT as first on the media) CDMT assigns an arbitrary number.


CONFIG
Specify general configuration information.

The syntax for CONFIG is:

CONFIG:
 
inputDir = pathname
(default $CDMT_DIR/inputDir)
ssoDir = pathname
(default $CDMT_DIR/sso)
removalPrompt = TRUE | FALSE (default TRUE)
removeFiles = TRUE | FALSE (default TRUE)
compress = TRUE | FALSE (default TRUE)
archiveMedia = TAPE | CD | FLOPPY
(default TAPE)

 CONFIG:
 inputDir        =   pathname
                     (default
                     $CDMT_DIR/inputDir)
 ssoDir          =   pathname
                     (default $CDMT_DIR/sso)
 removalPrompt   =   TRUE | FALSE (default TRUE)
 removeFiles     =   TRUE | FALSE (default TRUE)
 compress        =   TRUE | FALSE (default TRUE)
 archiveMedia    =   TAPE | CD | FLOPPY
                     (default TAPE)

FLOPPY_MEDIA
Specify configuration information for cutting to floppy media.

The syntax for FLOPPY_MEDIA is:

FLOPPY_MEDIA:
 
device = media device name
(default /dev/rfd0135ds18)
volumeSize = volume size in KB (default 1440)
archivesDir = directory where cdmtArchive creates archives (default $CDMT_DIR/archives/FLOPPY)
archiveFormat = format of the archive (default CPIO)
freeSpace = amount of space to leave on filesystem (default 0)
distCode = distribution code
(default ``protoFloppyDist'')
distVersion = distribution version
(default ``1.0'')
paperLabel = volume media label
(default ``Floppy Volume %d'')

 FLOPPY_MEDIA:
 device          =   media device name
                     (default /dev/rfd0135ds18)
 volumeSize      =   volume size in KB (default 1440)
 archivesDir     =   directory where cdmtArchive creates
                     archives (default
                     $CDMT_DIR/archives/FLOPPY)
 archiveFormat   =   format of the archive (default CPIO)
 freeSpace       =   amount of space to leave on
                     filesystem (default 0)
 distCode        =   distribution code
                     (default ``protoFloppyDist'')
 distVersion     =   distribution version
                     (default ``1.0'')
 paperLabel      =   volume media label
                     (default ``Floppy Volume %d'')

TAPE_MEDIA
Specify configuration information for cutting to tape media.

The syntax for TAPE_MEDIA is:

TAPE_MEDIA:
 
device = media device name (default /dev/nrct0)
volumeSize = volume size in KB (default 9000000000)
archivesDir = directory where cdmtArchive creates
archives
(default $CDMT_DIR/archives/TAPE)
distCode = distribution code
(default ``protoTapeDist'')
distVersion = distribution version (default ``1.0'')
paperLabel = volume media label
(default ``Tape Volume %d'')

 TAPE_MEDIA:
 device        =   media device name (default /dev/nrct0)
 volumeSize    =   volume size in KB (default 9000000000)
 archivesDir   =   directory where cdmtArchive creates
                   archives
                   (default $CDMT_DIR/archives/TAPE)
 distCode      =   distribution code
                   (default ``protoTapeDist'')
 distVersion   =   distribution version (default ``1.0'')
 paperLabel    =   volume media label
                   (default ``Tape Volume %d'')

CD_MEDIA
Specify configuration information for cutting to CD media.

The syntax for CD_MEDIA is:

CD_MEDIA:
 
distCode = distribution code
(default ``protoCDDist'')
distVersion = distribution version (default ``1.0'')
paperLabel = volume media label
(default ``CD Volume %d'')

 CD_MEDIA:
 distCode      =   distribution code
                   (default ``protoCDDist'')
 distVersion   =   distribution version (default ``1.0'')
 paperLabel    =   volume media label
                   (default ``CD Volume %d'')
For CD media, cdmtCompress populates the $CDMT_DIR/sso/opt directory with the filesystem image. You can then copy this image to CD.

The following are the definitions for the record attributes:


archivesDir
Specify the directory where cdmtArchive(CDMT) creates the installable archives. The default location is $CDMT_DIR/archives/TAPE or $CDMT_DIR/archives/FLOPPY.

archiveFormat
For floppy media, specify the format of the archive (CPIO or FILESYS). If you specify FILESYS, cdmtArchive creates a filesystem on the floppy and copies the archive to the floppy filesystem. You can mount and unmount a floppy filesystem archive; custom installs the archive in either CPIO or FILESYS format. The default value of archiveFormat is CPIO.

freeSpace
For floppy filesystem archives (created with the ``archiveFormat=FILESYS'' record definition), use freeSpace to tell CDMT to leave empty space on the floppy filesystem. Use this option to add files to the filesystem later. The default value of freeSpace is 0.

inputDir
Specify the directory that contains the CDMT input files. cdmtParse(CDMT) searches inputDir for *.prd files. cdmtParse prepends all references to *.cmpnt and *.pkg files with directory specified by inputDir, unless the references include absolute pathnames. The default value of inputDir is $CDMT_DIR/input.

ssoDir
Specify the directory where cdmtParse creates SSO images of the components. The default value of ssoDir is $CDMT_DIR/sso.

archiveMedia
Specify the type of media for which cdmtArchive should create archives. The default value of archiveMedia is TAPE.

removeFiles
Specify whether the component distribution files in $CDMT_DIR/sso should be removed along with the SSO databases when you run cdmtParse. If these files are not removed, cdmtCompress(CDMT) can compare modification times on the distribution file and the file in $CDMT_DIR/sso and copy the file to $CDMT_DIR/sso only if needed, saving execution time. The default value of removeFiles is TRUE.

removalPrompt
Prompt the user when removing existing files or directories. The default value of removalPrompt is TRUE.

compress
Compress all SSO component files, except those which have the noCompress flag set in the flags attribute. The default value of compress is TRUE.

distCode
Specify the single-word Distribution Code (cdmtFloppyDistribution, cdmtTapeDistribution, or cdmtCDDistribution) of the SSO distribution which identifies the distribution.

distVersion
Specify the Distribution Version, which identifies the version of the distribution (not the product version).

paperLabel
Specify the string which appears as a label on the physical archive media and identifies the volume of the media. The string should be in printf format, including %d, which CDMT replaces with a volume number. The default value of paperLabel is ``Volume %d''.

macroName
Specify the string value to substitute for the macro name.

integer
Specify the order of the componentID.

device
specify the archive media device name. In the case of TAPE, specify a norewind device. The default value of device is /dev/nrct0 for TAPE and /dev/rfd0135ds18 for FLOPPY.

volumeSize
Specify the volume size of the archive media in KB. The default value of volumeSize is 9000000 (9 GB) for TAPE and 1440 for FLOPPY.

Files

$CDMT_DIR/cdmt.config

See also

``Creating custom-installable software distributions'' in Developer's Topics

Standards conformance

cdmt.config is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003