[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    pkgchk(1M) manual page Table of Contents

Name

pkgchk - check accuracy of installation

Synopsis

pkgchk [ -l | -acfnqvx ] [ -p path [, ... ]] [ -i file ] [ [ pkginst [,... ]] | [ -m pkgmap [ -e envfile ]]]
pkgchk -d device [ -f ] [ -l | -v ] [ -p path [, ... ]] [ -i file ] [ pkginst[ ... ]]

Availability

SUNWcsu

Description

pkgchk checks the accuracy of installed files or, by using the -l option, displays information about package files. pkgchk checks the integrity of directory structures and files. Discrepancies are written to standard error along with a detailed explanation of the problem.

The first synopsis defined above is used to list or check the contents and/or attributes of objects that are currently installed on the system, or in the indicated pkgmap. Package names may be listed on the command line, or by default, the entire contents of a machine will be checked.

The second synopsis is used to list or check the contents of a package which has been spooled on the specified device, but not installed. Note that attributes cannot be checked for spooled packages.

Options

The following options are supported:
-a
Audit the file attributes only and do not check file contents. Default is to check both.
-c
Audit the file contents only and do not check file attributes. Default is to check both.
-d device
Specify the device on which a spooled package resides. device can be a directory path name or the identifiers for tape, floppy disk or removable disk (for example, /var/tmp or /dev/diskette).
-e envfile
Request that the pkginfo file named as envfile be used to resolve parameters noted in the specified pkgmap file.
-f
Correct file attributes if possible. If used with the -x option, this option removes hidden files. When pkgchk is invoked with this option it creates directories, named pipes, links and special devices if they do not already exist. If the -d option calls out an uninstalled package, the -f option will only take effect if the package is in directory (not stream) format. All file attributes will be set to agree with the entries in the pkgmap file except that setuid, setgid and sticky bits will not be set in the mode.
-i file
Read a list of path names from file and compares this list against the installation software database or the indicated pkgmap file. Path names which are not contained in file are not checked.
-l
List information on the selected files that make up a package. This option is not compatible with the -a, -c, -f, -g, and -v options.
-m pkgmap
Check the package against the package map file pkgmap.
-n
Do not check volatile or editable files. This should be used for most post-installation checking.
-p path
Only check the accuracy of the path name or path names listed. path can be one or more path names separated by commas (or by white space, if the list is quoted).
-q
Quiet mode. Do not give messages about missing files.
-v
Verbose mode. Files are listed as processed.
-x
Search exclusive directories, looking for files which exist that are not in the installation software database or the indicated pkgmap file.
pkginst
Specify the package instance or instances to be checked. The format pkginst.* can be used to check all instances of a package. The default is to display all information about all installed packages.

Exit Status

The following exit values are returned:
  1. success.
  2. error has occurred.

See Also

pkginfo(1) , pkgtrans(1) , pkgadd(1M) , pkgask(1M) , pkgrm(1M)


Table of Contents