ppdmgr(1m) - osol9

1ppdmgr(1M)              System Administration Commands              ppdmgr(1M)
2
3
4

NAME

6       ppdmgr - utility for managing PPD files
7

SYNOPSIS

9       ppdmgr -a ppd_filename_path [-L label] [-R ppd_repository_name] [-w]
10
11
12       ppdmgr -r [-L label] [-R ppd_repository_name]
13
14
15       ppdmgr -u [-L label] [-R ppd_repository_name]
16
17

DESCRIPTION

19       The  PPD  File  Manager  adds  PPD files to the print system's PPD file
20       repositories. When changes in the PPD file repositories are made by the
21       utility,  they  are  reflected in the Solaris Print Manager (see print‐
22       mgr(1M)) GUI printer  driver  field  when  adding  or  modifying  local
23       attached or network attached printers.
24
25
26       Multiple  PPD  file  repositories  may be available. PPD files that are
27       supplied with the system are available in the "system" repository.  PPD
28       files  that are supplied by third party vendors may be available in the
29       "vendor" repository. PPD files that are supplied by system  administra‐
30       tors may be available in the "admin" repository, and PPD files that are
31       added using this utility are available in the "user"  repository.  When
32       this utility is used to update or rebuild printer information reflected
33       in the printmgr(1M), the special reserved repository name "all" can  be
34       used to specify all of the available PPD file repositories.
35
36
37       PPD  files  are  grouped under a user-provided "label" within the print
38       system's PPD file repository to allow easier  selection  of  a  printer
39       driver  through the printmgr GUI. The special reserved label name "all"
40       can be used to specify all of the available labels in a PPD file repos‐
41       itory.  The  results  are undefined if a label name contains characters
42       that are not in the portable filename character set or if a label  name
43       starts  with  a  hyphen  (-). A label name may not contain a semi-colon
44       (:).
45

OPTIONS

47       The following subcommand are supported:
48
49       -a ppd_file_path
50
51           Adds a copy of ppd_file_path to  the  system  under  the  specified
52           label  in the specified repository, where ppd_file_path is the full
53           path and file name to the PPD file. The utility accepts a valid PPD
54           file with either a .ppd or .ppd.gz (gzipped) extension.
55
56
57       -L label
58
59           Specifies a label to group PPD files under. When specified with the
60           -a option, the default label is "user". When specified with the  -r
61           or  -u  option,  the  default  label  is  "all".  The following are
62           reserved labels:
63
64           caches          may never be specified
65
66
67           ppdcache        may never be specified
68
69
70           manufaliases    may never be specified
71
72
73           all             applies the specified action to  all  labels  in  a
74                           repository,  and  may only be specified with the -r
75                           or -u option.
76
77
78           SUNW*           anything starting with SUNW is reserved and  should
79                           not be specified with the -a option.
80
81
82
83       -R repository_name
84
85           Specifies the name of a PPD file repository representing one of the
86           PPD file installation locations. Possible repository names include:
87           "user", "admin", "vendor", "system", and "all".
88
89           The  repository name "all" signifies all of the possible repository
90           names. The default repository name is "user". Only  the  "user"  or
91           "admin" repository may be specified with the -a option.
92
93
94       -r
95
96           Rebuilds the cache information for the specified label in the spec‐
97           ified repository.
98
99
100       -u
101
102           Updates the cache information for the specified label in the speci‐
103           fied repository.
104
105
106       -w
107
108           Write  the  full  path  of  the added PPD file. This option is only
109           valid with the -a option. Otherwise, this option is ignored.
110
111

EXAMPLES

113       Example 1 Adding a copy of a PPD file to the repository
114
115
116       The following commands add a copy of a PPD file to the  "user"  reposi‐
117       tory under the "user" label:
118
119
120         # ppdmgr -a /net/somesystem/ppdfiles/ppdfile.ppd
121
122
123
124
125       or
126
127
128         # ppdmgr -a /net/somesystem/ppdfiles/ppdfile.ppd -L user
129
130
131
132
133       The  following  command adds a copy of a PPD file to the "user" reposi‐
134       tory under the "Photo" label and write the full path of the added  copy
135       to standard output:
136
137
138         # ppdmgr -a /net/somesystem/ppdfiles/ppdfile.ppd -L "Photo" -w
139
140
141
142       Example 2 Updating the cache for the PPD files
143
144
145       The  following  commands  update  the cache for the PPD files under the
146       "all" labels in the "user" repository:
147
148
149          # ppdmgr -u
150
151
152
153
154       or
155
156
157          # ppdmgr -u -R user -L all
158
159
160
161
162       The following command updates the cache for the  PPD  files  under  the
163       "photo" label in the "user" repository:
164
165
166          # ppdmgr -u -R user -L Photo
167
168
169
170       Example 3 Rebuilding the cache for the PPD files
171
172
173       The  following  command  rebuilds the cache for the PPD files under the
174       "Photo" label in the "user" repository:
175
176
177         # ppdmgr -r -R user -L Photo
178
179
180

EXIT STATUS

182       The following exit values are returned:
183
184       0     Successful completion.
185
186
187       >0    An error occurred.
188
189

ATTRIBUTES

191       See attributes(5) for descriptions of the following attributes:
192
193
194
195
196       ┌─────────────────────────────┬─────────────────────────────┐
197       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
198       ├─────────────────────────────┼─────────────────────────────┤
199       │Availability                 │SUNWpsr                      │
200       ├─────────────────────────────┼─────────────────────────────┤
201       │Interface Stability          │Committed                    │
202       └─────────────────────────────┴─────────────────────────────┘
203