Manual Pages for UNIX Operating System command usage for man contents

File Formats                                          contents(4)



NAME
     contents - list of files and associated packages

SYNOPSIS
     /var/sadm/install/contents


DESCRIPTION
     The file /var/sadm/install/contents is a source of  informa-
     tion  about  the packages installed on the system. This file
     must never be edited directly. Always use  the  package  and
     patch  commands  (see  SEE ALSO) to make changes to the con-
     tents file.


     Each entry in the contents file is a single line. Fields  in
     each entry are separated by a single space character.


     Two major styles of entries exist, old style and new  style.
     The following is the format of an old-style entry:

       ftype class path package(s)



     The following is the general format of a new-style entry:

       path[=rpath] ftype class [ftype-optional-fields] package(s)



     New-style entries differ for each ftype.  The  ftype  desig-
     nates  the entry type, as specified in pkgmap(4). The format
     for new-style entries, for each ftype, is as follows:

       ftype s: path=rpath s class package
       ftype l: path l class package
       ftype d: path d class mode owner group package(s)
       ftype b: path b class major minor mode owner group package
       ftype c: path c class major minor mode owner group package
       ftype f: path f class mode owner group size cksum modtime package
       ftype x: path x class mode owner group package
       ftype v: path v class mode owner group size cksum modtime package
       ftype e: path e class mode owner group size cksum modtime package



     A significant distinction between old- and new-style entries
     is  that the former do not begin with a slash (/) character,
     while the latter (new-style) always  do.  For  example,  the
     following are old-style entries:



SunOS 5.11          Last change: 20 Dec 2007                    1






File Formats                                          contents(4)



       d none /dev SUNWcsd
       e passwd /etc/passwd SUNWcsr



     The following are new-style entries:

       /dev d none 0755 root sys SUNWcsr SUNWcsd
       /etc/passwd e passwd 0644 root sys 580 48299 1077177419 SUNWcsr



     The following are the descriptions of  the  fields  in  both
     old- and new-style entries.

     path       The absolute path of the  node  being  described.
                For  ftype s (indicating a symbolic link) this is
                the indirect pointer (link) name.


     rpath      The relative path to the real file  or  linked-to
                directory name.


     ftype      A one-character field that  indicates  the  entry
                type (see pkgmap(4)).


     class      The installation class to which the file  belongs
                (see pkgmap(4)).


     package    The package associated with this entry. For ftype
                d  (directory)  more  than  one  package  can  be
                present.


     mode       The octal mode of the file (see pkgmap(4)).


     owner      The owner of the file (see pkgmap(4)).


     group      The  group  to  which  the  file   belongs   (see
                pkgmap(4)).


     major      The major device number (see pkgmap(4)).


     minor      The minor device number (see pkgmap(4)).




SunOS 5.11          Last change: 20 Dec 2007                    2






File Formats                                          contents(4)



     size       The actual size of the file in bytes as  reported
                by sum (see pkgmap(4)).


     cksum      The  checksum   of   the   file   contents   (see
                pkgmap(4)).


     modtime    The time of last modification (see pkgmap(4)).


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|


SEE ALSO
     patchadd(1M), pkgadd(1M), pkgadm(1M), pkgchk(1M), pkgmap(4),
     attributes(5)

NOTES
     As    shown    above,    the    interface    stability    of
     /var/sadm/install/contents   is   Uncommitted   (see  attri-
     butes(5)). It is common practice  to  use  this  file  in  a
     read-only  manner  to  determine which files belong to which
     packages installed on a system. While  this  file  has  been
     present  for  many releases of the Solaris operating system,
     it might not be present in future releases. The  fully  sup-
     ported  way to obtain information from the installed package
     database is through pkgchk(1M).  It  is  highly  recommended
     that  you  use  pkgchk  rather  than relying on the contents
     file.













SunOS 5.11          Last change: 20 Dec 2007                    3