Manual Pages for UNIX Operating System command usage for man pkgchk

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



SunOS 5.11          Last change: 30 Oct 2007                    1






System Administration Commands                         pkgchk(1M)



         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  pack-
         age,  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 or  from  stdin  (-)
         and  compare this list against the installation software
         database or the indicated pkgmap file. Path  names  that
         are not contained in file or stdin 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



SunOS 5.11          Last change: 30 Oct 2007                    2






System Administration Commands                         pkgchk(1M)



         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 whitespace, if the list is quoted).

         To specify a path that includes a comma,  you  must  use
         the -i option, described above. See EXAMPLES.


     -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. See the note about paths that  con-
         tain commas in the description of -p.


     -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 informa-
         tion files, are relocated to a directory  tree  starting
         in  the specified root_path. The root_path may be speci-
         fied when installing to a  client  from  a  server  (for
         example, /export/root/client1).

         Note -

           The root file system of any non-global zones must  not
           be  referenced with the -R option. Doing so might dam-
           age the global zone's file  system,  might  compromise
           the  security of the global zone, and might damage the
           non-global zone's file system. See zones(5).



SunOS 5.11          Last change: 30 Oct 2007                    3






System Administration Commands                         pkgchk(1M)



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


     -x

         Search exclusive directories, looking  for  files  which
         exist that are not in the installation software database
         or the indicated pkgmap file.


     -Y category

         Check packages based on the value of the CATEGORY param-
         eter  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,
         an asterisk must be surrounded 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






SunOS 5.11          Last change: 30 Oct 2007                    4






System Administration Commands                         pkgchk(1M)



     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



     Example 3 Specifying a Path That Contains a Comma


     Assume you want to specify the path:


       /platform/SUNW,Netra-T12/lib




     List this path in a file. Here is one way in which  you  can
     do that:


       example% echo "/platform/SUNW,Netra-T12/lib" > /tmp/p




     You can then enter:


       example% pkgchk -i /tmp/p -l
       Pathname: /platform/SUNW,Netra-T12/lib
       Type: directory
       Expected mode: 0755
       Expected owner: root
       Expected group: bin
       Referenced by the following packages:
               SUNWcar
       Current status: installed




SunOS 5.11          Last change: 30 Oct 2007                    5






System Administration Commands                         pkgchk(1M)



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                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     pkginfo(1), pkgtrans(1), pkgadd(1M), pkgask(1M),  pkgrm(1M),
     pkginfo(4), attributes(5), largefile(5)


NOTES
     Package commands are largefile(5)-aware. They  handle  files
     larger  than 2 GB in the same way they handle smaller files.
     In their current  implementations,  pkgadd(1M),  pkgtrans(1)
     and  other  package commands can process a datastream of  up
     to 4 GB.




















SunOS 5.11          Last change: 30 Oct 2007                    6