How to Update or Rebuild the PPD Cache File by Using the ppdmgr Utility

This procedure describes how to update or rebuild the PPD cache file by using either the -u or the -r option of the ppdmgr utility.

• To update the PPD cache file, use the ppdmgr command with the -u option.

• To rebuild the PPD cache file, use the ppdmgr command with the -r option.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Update or rebuild the PPD cache file to reflect any recent changes.

   # ppdmgr -u | -r [ -R repository ] [ -L label ]

   -u

   Updates the PPD cache file with information about the PPD file, or files, that are assigned to the specified label within the specified repository. The default label is user. The default repository is also user. If no changes are identified, no changes are made to the cache file.

   -r

   Removes the existing PPD cache file, then rebuilds the file with the PPD file information for the PPD file, or files, within the specified label.

   If no label is specified, the default label is user, within the specified repository. If a repository is not specified, the default repository is also user.

   Under normal circumstances, you do not need to request a rebuild of the PPD cache file. Use this option only if you suspect that the PPD cache file has become corrupted.

   -R repository

   Specifies a PPD file repository to update. You can specify one of the following PPD file repositories:

   • admin

   • all (Specifies all available PPD file repositories on a system)

   • system

   • user (default)

   • vendor

   -L label

   Specifies a PPD file label.

   The default label is user. Label names must contain characters that are in the portable file name character set. Label names must not begin with a hyphen (-) or contain a semicolon (:). Label names cannot be a reserved label name.

   The following label names are reserved:

   • caches

   • ppdcache

   • manufaliases

   • all

3. Verify that the PPD file was added by using one of the following methods:

   • Check that the file is displayed in Solaris Print Manager:

     1. Launch Solaris Printer Manager. See How to Start Solaris Print Manager.

     2. Select Modify Printer Attributes (attached or network).

     3. Select the print queue for which you added the PPD file in Step 2 of this procedure.

        If the PPD file that you specified was added successfully, the information is displayed in the Printer Driver field. See Description of the Printer Driver Field in Solaris Print Manager.

   • Use the lpstat command to verify the PPD file was added:

     % lpstat -p printer-name -l

     If the PPD file was added to the system successfully, the PPD file name is included in the PPD field of the lpstat command's output.

Example 9–7 Updating the PPD Cache File by Using the ppdmgr Utility

This example shows how to update the PPD cache file to reflect information from the PPD files that are assigned in all the labels within the user repository.

# ppdmgr -u

This example shows how to update the PPD cache file to reflect information from the PPD files that are assigned in the Photos label within the user repository.

# ppdmgr -u -L Photos

This example shows how to update the PPD cache file to reflect the information from the PPD files that are assigned in all the labels within the admin repository.

# ppdmgr -u -R system

This example shows how to update the PPD cache file to reflect information from the PPD files that are assigned in the Photos label within the admin repository.

# ppdmgr -u -L Photos -R admin