pkgchk(1M)




NAME

     pkgchk - check package installation accuracy


SYNOPSIS

     pkgchk  [-l   |   -acfnqvx]    [-i file]   [-p 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 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 package  information  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  compare  this
           list against the installation software database or the
           indicated pkgmap file. Path names which are  not  con-
           tained 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.

     -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 check-
           ing.

     -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.

     -R root_path
           Define the full name of a  directory  to  use  as  the
           root_path.  All files, including package system infor-
           mation files, are relocated to a directory tree start-
           ing  in  the specified root_path. The root_path may be
           specified 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 installation software data-
           base 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 surrounded by single quotes (')  or
           preceded by a backslash (\);


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


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


Man(1) output converted with man2html