The description lines

For each deliverable object, you must create one description line that consists of several fields describing the object. This entry describes such information as mode, owner, and group for the object. You can also use this entry to accomplish the following tasks:

• You can override the pkgmk(C) command's placement of an object on a multiple-part package. See ``10. Distributing packages over multiple volumes'' for more details.

• You can place objects into classes. See ``3. Placing objects into classes'' for details.

• You can tell pkgmk(C) where to find an object in your development directory structure and map that name to the correct placement on the installation machine. See ``Mapping development pathnames to installation pathnames'' for details.

• You can define an object as relocatable. See ``Defining collectively relocatable objects'' and ``Defining individually relocatable objects'' for details.

• You can define links. See ``9. Creating the prototype file'' for details.

The generic format of the descriptive line is:

   [ part ] ftype class pathname [ major minor ] [ mode owner group ]

part

Designates the part in which an object should be placed. A package can be divided into a number of parts. A part is a collection of files and is the atomic unit by which a package is processed. A developer can choose the criteria for grouping files into a part (for example, by class). If not defined, pkgmk(C) decides in which part the object will be placed.

ftype

Designates the file type of an object. Example file types are f (a standard executable or data file), d (a directory), l (a linked file), and i (a package information file). (Refer to the prototype(F) manual page for a complete list of file types.)

class

Defines the class to which an object belongs. All objects must belong to a class. If the object belongs to no special class, this field should be defined as none.

pathname

Defines the pathname which an object should have on the installation machine. If you do not begin this name with a slash, the object is considered to be relocatable. You can use the form path1=path2 to map the location of an object on your development machine to the pathname it should have when installed on an installation machine.

When a package is stored on an installation medium with an s5 filesystem, each member of the pathname is truncated to 14 characters. When the package is installed on the installation machine with a filesystem that supports longer file names, such as sfs or ufs filesystems, the files are restored with their original pathname length. However, on the s5 filesystem, the pathnames remain truncated.

major/minor

Defines the major and minor numbers for a block or character special device.

mode/owner/group

Defines the mode, owner, and group for an object. The mode, owner, and group must be defined or packaging will fail. If not defined, the defaults defined with the default command are assigned.

Here is an example of this file with only description lines:

   i pkginfo
   i request
   d bin /ncmpbin 0755 root other
   f bin /ncmpbin/dired=/usr/ncmp/bin/dired 0755 root other
   f bin /ncmpbin/less=/usr/ncmp/bin/less 0755 root other
   f bin /ncmpbin/ttype=/usr/ncmp/bin/ttype 0755 root other