Man Pages

---

Back to Software Index  Manpage Top Level

Name

Description

Each entry in the .cdtoc file is a line that establishes the value of a parameter in the following form:

PARAM=value

Blank lines and comments (lines preceded by a pound-sign, ‘‘#’’) are also allowed in the file. Parameters are grouped by product, with the beginning of a product defined by a line of the form:

PRODNAME=value

Each product is expected to consist of one or more software packages that are stored together in a subdirectory on the distribution media. There can be any number of products described within the file. There is no required order in which the parameters must be specified, except that the parameters must be grouped by product and the PRODNAME parameter must appear first in the list of parameters for each product specified. Each parameter is described below. All of the parameters are required for each product.

PRODNAME

The full name of the product. This must be unique within the .cdtoc file and is preferably unique across all possible products. This value may contain white space. The length of this value is limited to 256 ASCII characters; other restrictions may apply (see below).

PRODVERS

The version of the product. The value can contain any combination of letters, numbers, or other characters. This value may contain white space. The length of this value is limited to 256 ASCII characters; other restrictions may apply (see below).

PRODDIR

The name of the top-level directory containing the product. This name should be relative to the top-level directory of the distribution media, for example, Solaris_2.4. The number of path components in the name is limited only by the system’s maximum path name length, which is 1024 ASCII characters. Any single component is limited to 256 ASCII characters. This value cannot contain white space.

The lengths of the values of PRODNAME and PRODVERS are further constrained by the fact that the initial install programs and swmtool(1M) concatenate these values to produce the full product name. swmtool concatenates the two values (inserting a space) to produce the name displayed in its software selection menu, for example, Solaris 2.4. For unbundled products the combined length of the values of PRODNAME and PRODVERS must not exceed 256 ASCII characters.

During installation of the bundled OS release, directories for diskless and dataless client usr and platform file systems are created by constructing names derived from a concatenation of the values of PRODNAME, PRODVERS, and client architecture, for example, /export/exec/kvm/Solaris_2.x_sparc.sun4c/usr/platform. The length of the component containing the product name and version must not exceed 256 ASCII characters. Thus, for products corresponding to bundled OS releases (for example, Solaris 2.4), the values of PRODNAME and PRODVERS are effectively restricted to lengths much less than 256.

The initial installation programs, swm and swmtool, use the value of the PRODDIR macro in the .cdtoc file to indicate where packages can be found.

Examples

Here is a sample .cdtoc file:

#
# .cdtoc file -- Online product family CD
#
PRODNAME=Online DiskSuite
PRODVERS=2.0
PRODDIR=Online_DiskSuite_2.0
#
PRODNAME=Online Backup
PRODVERS=2.0
PRODDIR=Online_Backup_2.0

This example corresponds to the following directory layout on a CD-ROM partition:

/.cdtoc
/Online_DiskSuite_2.0
    ./SUNWmddr.c
    ./SUNWmddr.m
    ./SUNWmddu
/Online_Backup_2.0
    ./SUNWhsm

The bundled release of Solaris 2.x includes the following .cdtoc file:

PRODNAME=Solaris
PRODVERS=2.x
PRODDIR=Solaris_2.x

This file corresponds to the following directory layout on slice 0 of the Solaris 2.xproduct CD:

/.cdtoc
/Solaris_2.x
    ./SUNWaccr
    ./SUNWaccu
    ./SUNWadmap
    .
    .
    .
    ./SUNWutool

See Also

Table of Contents

• Name
• Description
• Examples
• See Also