System Administration Commands pkgchk(1M)
NAME
pkgchk - check package installation accuracy
SYNOPSIS
pkgchk [-l | -acfnqvx] [-i file] [-p path... | -P partial-
path...] [-R root_path] [ [ -m pkgmap [-e envfile]] |
pkginst... | -Y category,category...]
pkgchk -d device [-l | -fv] [-i file] [-M] [-p path...] [-
V fs_file] [pkginst... | -Y category[,category...]]
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 pack-
age 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 package information file
named as envfile be used to resolve parame-
ters noted in the specified pkgmap file.
-f Correct file attributes if possible. If used
with the -x option, this option removes hid-
den 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 com-
pare 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 compa-
tible with the -a, -c, -f, -g, and -v
options.
-m pkgmap Check the package against the package map
file, pkgmap.
-M Instruct pkgchk not to use the
$root_path/etc/vfstab file for determining
the client's mount points. This option
assumes the mount points are correct on the
server and it behaves consistently with
Solaris 2.5 and earlier releases.
-n Do not check volatile or editable files'
contents. This should be used for most
post-installation checking.
-p path Check the accuracy only of the path name or
path names listed. path can be one or more
path names separated by commas (or by whi-
tespace, if the list is quoted).
-P partial-path Check the accuracy of only the partial path
name or path names listed. partial-path can
be one or more partial path names separated
by commas (or by whitespace, if the list is
quoted). This option can be used instead of
-p and is not compatible with the other
option. This option matches any path name
that contains the string contained in the
partial path.
-q Quiet mode. Do not give messages about miss-
ing files.
-R root_path Define the full name of a directory to use
as the root_path. All files, including pack-
age system information files, are relocated
to a directory tree starting in the speci-
fied root_path. The root_path may be speci-
fied when installing to a client from a
server (for example, /export/root/client1).
-v Verbose mode. Files are listed as processed.
-V fs_file Specify an alternative fs_file to map the
client's file systems. For example, used in
situations where the $root_path/etc/vfstab
file is non-existent or unreliable.
-x Search exclusive directories, looking for
files which exist that are not in the ins-
tallation software database or the indicated
pkgmap file.
-Y category Check packages based on the value of the
CATEGORY parameter stored in the installed
or spooled package's pkginfo(4) file.
OPERANDS
pkginst 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.
The asterisk character (*) is a special
character to some shells and may need to be
escaped. In the C-Shell, "*" must be sur-
rounded by single quotes (') or preceded by
a backslash (\);
partial-path A portion of a path, such as a file or
directory name.
EXAMPLES
Example 1: Using pkgchk for Displaying Package Installation
Information
The following example displays package installation informa-
tion for /usr/bin/ls:
example% pkgchk -l -p /usr/bin/ls
Example 2: Checking on Java Font Properties
The following example displays package installation informa-
tion for all Java font properties installed on the system.
example% pkgchk -l -P font.properties
EXIT STATUS
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
pkginfo(1), pkgtrans(1), pkgadd(1M), pkgask(1M), pkgrm(1M),
pkginfo(4), attributes( 5)
Application Packaging Developer's Guide
|
|
