ppdmgr(1M) System Administration Commands ppdmgr(1M)NAMEppdmgr - utility for managing PPD files
SYNOPSISppdmgr-a ppd_filename_path [-L label] [-R ppd_repository_name] [-w]
ppdmgr-r [-L label] [-R ppd_repository_name]
ppdmgr-u [-L label] [-R ppd_repository_name]
DESCRIPTION
The PPD File Manager adds PPD files to the print system's PPD file
repositories. When changes in the PPD file repositories are made by the
utility, they are reflected in the Solaris Print Manager (see print‐
mgr(1M)) GUI printer driver field when adding or modifying local
attached or network attached printers.
Multiple PPD file repositories may be available. PPD files that are
supplied with the system are available in the "system" repository. PPD
files that are supplied by third party vendors may be available in the
"vendor" repository. PPD files that are supplied by system administra‐
tors may be available in the "admin" repository, and PPD files that are
added using this utility are available in the "user" repository. When
this utility is used to update or rebuild printer information reflected
in the printmgr(1M), the special reserved repository name "all" can be
used to specify all of the available PPD file repositories.
PPD files are grouped under a user-provided "label" within the print
system's PPD file repository to allow easier selection of a printer
driver through the printmgr GUI. The special reserved label name "all"
can be used to specify all of the available labels in a PPD file repos‐
itory. The results are undefined if a label name contains characters
that are not in the portable filename character set or if a label name
starts with a hyphen (-). A label name may not contain a semi-colon
(:).
OPTIONS
The following subcommand are supported:
-a ppd_file_path
Adds a copy of ppd_file_path to the system under the specified
label in the specified repository, where ppd_file_path is the full
path and file name to the PPD file. The utility accepts a valid PPD
file with either a .ppd or .ppd.gz (gzipped) extension.
-L label
Specifies a label to group PPD files under. When specified with the
-a option, the default label is "user". When specified with the -r
or -u option, the default label is "all". The following are
reserved labels:
caches may never be specified
ppdcache may never be specified
manufaliases may never be specified
all applies the specified action to all labels in a
repository, and may only be specified with the -r
or -u option.
SUNW* anything starting with SUNW is reserved and should
not be specified with the -a option.
-R repository_name
Specifies the name of a PPD file repository representing one of the
PPD file installation locations. Possible repository names include:
"user", "admin", "vendor", "system", and "all".
The repository name "all" signifies all of the possible repository
names. The default repository name is "user". Only the "user" or
"admin" repository may be specified with the -a option.
-r
Rebuilds the cache information for the specified label in the spec‐
ified repository.
-u
Updates the cache information for the specified label in the speci‐
fied repository.
-w
Write the full path of the added PPD file. This option is only
valid with the -a option. Otherwise, this option is ignored.
EXAMPLES
Example 1 Adding a copy of a PPD file to the repository
The following commands add a copy of a PPD file to the "user" reposi‐
tory under the "user" label:
# ppdmgr-a /net/somesystem/ppdfiles/ppdfile.ppd
or
# ppdmgr-a /net/somesystem/ppdfiles/ppdfile.ppd -L user
The following command adds a copy of a PPD file to the "user" reposi‐
tory under the "Photo" label and write the full path of the added copy
to standard output:
# ppdmgr-a /net/somesystem/ppdfiles/ppdfile.ppd -L "Photo" -w
Example 2 Updating the cache for the PPD files
The following commands update the cache for the PPD files under the
"all" labels in the "user" repository:
# ppdmgr-u
or
# ppdmgr-u -R user -L all
The following command updates the cache for the PPD files under the
"photo" label in the "user" repository:
# ppdmgr-u -R user -L Photo
Example 3 Rebuilding the cache for the PPD files
The following command rebuilds the cache for the PPD files under the
"Photo" label in the "user" repository:
# ppdmgr-r -R user -L Photo
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWpsr │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOprintmgr(1M), attributes(5)SunOS 5.10 24 Jan 2008 ppdmgr(1M)