System Administration Commands ppdmgr(1M)
NAME
ppdmgr - utility for managing PD files
SYNOPSIS
ppdmgr -a ppdfilenamepath [-L label] [-R ppdrepositoryname] [-w]
ppdmgr -r [-L label] [-R ppdrepositoryname]
ppdmgr -u [-L label] [-R ppdrepositoryname]
DESCRIPTION
The PD File Manager adds PD files to the print system's
PD file repositories. When changes in the PD file reposi-
tories are made by the utility, they are reflected in the
Solaris Print Manager (see printmgr(1M)) GUI printer driver
field when adding or modifying local attached or network
attached printers.
Multiple PD file repositories may be available. PD files
that are supplied with the system are available in the "sys-
tem" repository. PD files that are supplied by third party
vendors may be available in the "vendor" repository. PD
files that are supplied by system administrators may be
available in the "admin" repository, and PD files that are
added using this utility are available in the "user" reposi-
tory. 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 PD file repositories.
PD files are grouped under a user-provided "label" within
the print system's PD 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 PD file repository. 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 ppdfilepath
Adds a copy of ppdfilepath to the system under the
specified label in the specified repository, where
SunOS 5.11 Last change: 9 Mar 2007 1
System Administration Commands ppdmgr(1M)
ppdfilepath is the full path and file name to the PD
file. The utility accepts a valid PD file with either a
.ppd or .ppd.gz (gzipped) extension.
-L label
Specifies a label to group PD files under. When speci-
fied 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 repositoryname
Specifies the name of a PD file repository representing
one of the PD 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 specified repository.
SunOS 5.11 Last change: 9 Mar 2007 2
System Administration Commands ppdmgr(1M)
-u
Updates the cache information for the specified label in
the specified repository.
-w
Write the full path of the added PD file. This option
is only valid with the -a option. Otherwise, this option
is ignored.
EXAMPLES
Example 1 Adding a copy of a PD file to the repository
The following commands add a copy of a PD file to the
"user" repository 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 PD file to the
"user" repository 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 PD files
The following commands update the cache for the PD files
under the "all" labels in the "user" repository:
# ppdmgr -u
SunOS 5.11 Last change: 9 Mar 2007 3
System Administration Commands ppdmgr(1M)
or
# ppdmgr -u -R user -L all
The following command updates the cache for the PD files
under the "photo" label in the "user" repository:
# ppdmgr -u -R user -L Photo
Example 3 Rebuilding the cache for the PD files
The following command rebuilds the cache for the PD 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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 9 Mar 2007 4
System Administration Commands ppdmgr(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWpsr
Interface Stability Committed
SEE ALSO
printmgr(1M), attributes(5)
SunOS 5.11 Last change: 9 Mar 2007 5
|
