Commands Reference, Volume 5

sysck Command

Purpose

Checks the inventory information during installation and update procedures.

Syntax

sysck { -i | -u } [  -R RootPath ] [  -N ] [ -v ] [  -s SaveFile ] [  -O { r | s | u } ] -f File ProductName { tcbck Flags }

1All of the tcbck command flags are valid with this command.

Description

Attention: The sysck command DOES NOT support checking files that are greater than 2 gigabytes. If a product needs to ship a file that is greater than 2 gigabytes, set size and checksum values in their Fileset.inventory to VOLATILE, so the sysck command will not try to access the file.

Note: All of the tcbck command flags are valid with the sysck command. This feature provides compatibility with Version 3.1. For more information on the tcbck command and a complete listing of its flags, refer to AIX 5L Version 5.2 Commands Reference.

The sysck command checks file definitions against the extracted files from the installation and update media and updates the Software Vital Product Data (SWVPD) database. The sysck command does not recognize the following special characters in file names: `, ', \, ", ^, ( ), |, {}, [], <>,and : . If a file name contains one of these characters, the sysck command fails.

The sysck command is primarily used during the installation and update of software products.

When invoked with the -i flag, the sysck command checks the attributes of an extracted file with its file definitions, updates the SWVPD, and attempts to fix some errors if they exist.

The File parameter is the name of the stanza file that contains the file definitions. An example of such a file is the /etc/security/sysck.cfg file, although the syschk command does not use this file. The sysck command checks the size, links, symlinks, owner, group, and mode attributes of a file for which the type attribute is set to FILE. When invoked with the -v flag as well as the -i flag, sysck also checks the checksum value of a file.

The sysck command updates the file name, product name, type, checksum, and size of each file in the SWVPD database.

To fix errors, the sysck command resets the attribute of the installed or updated file to the defined value in the File stanza file, except for some attributes as described in "Fixing Errors".

When invoked with the -u flag, the sysck command removes the entry from the SWVPD database for each file that is part of the software product ProductName. The sysck command also deletes any hard links and symbolic links for each file, as defined in the SWVPD database.

Flags

sysck -i -s /tmp/save.inv -f /tmp/real.inv bos.rte.shell

Environment Variables

File Definitions

/etc/foo --> /usr/bar

Fixing Errors

To fix errors, the sysck command resets the attribute of the installed or updated file to the defined value defined in the File stanza file except for the following attributes, for which the sysck command acts as described:

Security

Privilege Control: Only the root user can run this command.

Examples

1. A product that uses the installp command to install ships an inventory file in its image. To add the definitions to the inventory database and check permissions, links, checksums, etc., enter:
   sysck -i -f dude.rte.inventory dude.rte
   where dude.rte.inventory would look like the following:

   /usr/bin/dude.exec:
      class = apply,inventory,dude.rte
      owner = bin
      group = bin
      mode = 555
      type = FILE
      size = 2744
      checksum = "04720        3"

2. To remove any links to files for a product that has been removed from the system and remove the files from the inventory database, enter:
   sysck -u -f dude.rte.inventory dude.rte
   

Files

Related Information

The installp command, sum command, tcbck command.