NAME

contents - the installed-software database

SYNOPSIS

/var/sadm/install/contents

DESCRIPTION

The contents file lists every object installed packages own: one line per path name, in sorted path name order. pkgadd(1M), installf(1M) and removef(1M) write it; pkgrm(1M), pkgchk(1M) and pkginfo(1) read it. Edit it only with those tools.

Fields are separated by white space, and there is no quoting: a path name cannot contain a space (the package tools refuse one). A line starting with # is a comment; the tools add one at the end saying when and by what the file was last written.

RECORDS

Every record starts with the path name and the file type, then the installation class, then fields that depend on the type, and ends with the names of the packages that own the object:

f v e	path ftype class mode owner group size cksum modtime pkg...
d x p	path ftype class mode owner group pkg...
c b	path ftype class major minor mode owner group pkg...
s l	path=target ftype class pkg...

ftype

f file, e file the administrator may edit, v file whose contents change (a log), d directory, x exclusive directory accessible only by this package, p named pipe, c and b character and block device, s symbolic link, l hard link

class

the installation class; none unless the package names one (see conffile(5))

mode

the permissions, in octal

owner, group

by name

size, cksum, modtime

the size in bytes, the sum(1) checksum, and the modification time in seconds since 1970; for an e file installed by a class action script these describe the file as it is on disk after the script

pkg

an owning package instance; several names mean the object is shared. A name may carry one status character in front: + ready for installf -f, - ready for removef -f, ! not found, % on a file server's read-only partition; * and ~ are further states the tools accept. A ? stands for a value the tool did not know.

EXAMPLE

/etc/apkg.conf e conffile 0644 root sys 1521 51934 1793368699 APKG
/usr/apkg d none 0755 root sys APKG APKGENG
/usr/bin/apkg=/usr/apkg/bin/apkg s none APKG
/dev/console c none ? ? 0620 root tty core

NOTES

The Amix 2.1 factory file holds a record for a file named TrueType Fonts and a repeated package name, which the stock tools cannot read; contents-fsck(1M) finds and repairs such records.

FILES

/var/sadm/install/contents

this file

SEE ALSO

contents-fsck(1M), pkgchk(1M), installf(1M), pkgmap(5), conffile(5)