unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

cdtoc(4)                         File Formats                         cdtoc(4)



NAME
       cdtoc - CD-ROM table of contents file

DESCRIPTION
       The table of contents file, .cdtoc, is an ASCII file that describes the
       contents of a CD-ROM or other software distribution media.  It  resides
       in  the  top-level directory of the file system on a slice of a CD-ROM.
       It is independent of file system format, that is, the  file  system  on
       the slice can be either UFS or HSFS.

       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 parame-
       ter must appear first in the list of parameters for each product speci-
       fied. 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  con-
                               tain  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.6/Product.  The
                               number  of  path components in the name is lim-
                               ited only by the  system's  maximum  path  name
                               length,  which  is  1024  ASCII characters. Any
                               single component is limited to 256 ASCII  char-
                               acters. This value cannot contain white space.



       The  lengths  of  the  values of PRODNAME and PRODVERS are further con-
       strained by the fact that  the  initial  install  programs  concatenate
       these  values  to produce the full product name. For unbundled products
       the combined length of the values of PRODNAME  and  PRODVERS  must  not
       exceed 256 ASCII characters.

       When  you  install  OS services with Solstice Host Manager, directories
       for diskless clients are created by constructing names derived  from  a
       concatenation of the values of PRODNAME, PRODVERS, and client architec-
       ture, for example, /export/exec/Solaris_2.x_sparc.all/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 install programs use the value of the PRODDIR macro in  the
       .cdtoc file to indicate where packages can be found.

EXAMPLES
       Example 1: Sample of .cdtoc file.

       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.6 includes the following .cdtoc file:

               PRODNAME=Solaris
               PRODVERS=2.6
               PRODDIR=Solaris_2.6/Product


       This file corresponds to the following directory layout on slice  0  of
       the Solaris 2.6 product CD:

               /.cdtoc
               /Solaris_2.6/Product
                    ./SUNWaccr
                    ./SUNWaccu
                    ./SUNWadmap
                    .
                    .
                    .
                    ./SUNWutool


SEE ALSO
       clustertoc(4), packagetoc(4), pkginfo(4)



SunOS 5.10                       14 Sept 2004                         cdtoc(4)