]>
Commit | Line | Data |
---|---|---|
94436c5a MS |
1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
2 | <html> | |
3 | <!-- SECTION: Man Pages --> | |
4 | <head> | |
5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
6 | <title>cupsaddsmb(8)</title> | |
7 | </head> | |
8 | <body> | |
9 | <h1 class="title">cupsaddsmb(8)</h1> | |
10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
11 | cupsaddsmb - export printers to samba for windows clients | |
12 | ||
13 | <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> | |
14 | <b>cupsaddsmb | |
15 | </b>[ -H | |
16 | <i>samba-server | |
17 | </i>] [ -U | |
18 | <i>samba-user[%samba-password] | |
19 | </i>] [ -h | |
20 | <i>cups-server[:port] | |
21 | </i>] [ -v ] -a | |
22 | <br> | |
23 | <b>cupsaddsmb | |
24 | </b>[ -H | |
25 | <i>samba-server | |
26 | </i>] [ -U | |
27 | <i>samba-user[%samba-password] | |
28 | </i>] [ -h | |
29 | <i>cups-server[:port] | |
30 | </i>] [ -v ] printer [ ... printer ] | |
31 | ||
32 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> | |
33 | <i>cupsaddsmb</i> exports printers to the SAMBA software (version | |
34 | 2.2.0 or higher) for use with Windows clients. Depending on the | |
35 | SAMBA configuration, you may need to provide a password to | |
36 | export the printers. This program requires the Windows printer | |
37 | driver files described below. | |
38 | ||
39 | <h2 class="title"><a name="OPTIONS">Options</a></h2> | |
40 | <i>cupsaddsmb</i> supports the following options: | |
41 | <dl> | |
42 | <dt>-H samba-server | |
43 | </dt> | |
44 | <dd></dd> | |
45 | <dd>Specifies the SAMBA server which defaults to the CUPS server. | |
46 | </dd> | |
47 | <dt>-U samba-user[%samba-password] | |
48 | </dt> | |
49 | <dd></dd> | |
50 | <dd>Specifies the SAMBA print admin username which defaults to your | |
51 | current username. If the username contains a percent (%) | |
52 | character, then the text following the percent is treated as the | |
53 | SAMBA password to use. | |
54 | </dd> | |
55 | <dt>-a | |
56 | </dt> | |
57 | <dd></dd> | |
58 | <dd>Exports all known printers. Otherwise only the named printers are | |
59 | exported. | |
60 | </dd> | |
61 | <dt>-h cups-server[:port] | |
62 | </dt> | |
63 | <dd></dd> | |
64 | <dd>Specifies a different CUPS server to use. | |
65 | </dd> | |
66 | <dt>-v | |
67 | </dt> | |
68 | <dd></dd> | |
69 | <dd>Specifies that verbose information should be shown. This is | |
70 | useful for debugging SAMBA configuration problems. | |
71 | ||
72 | </dd> | |
73 | </dl> | |
74 | <h2 class="title"><a name="SAMBA_CONFIGURATION">Samba Configuration</a></h2> | |
75 | <i>cupsaddsmb</i> uses the new RPC-based printing support in | |
76 | SAMBA 2.2.x to provide printer drivers and PPD files to Windows | |
77 | client machines. In order to use this functionality, you must | |
78 | first configure the SAMBA <i>smb.conf(5)</i> file to support | |
79 | printing through CUPS and provide a printer driver download | |
80 | share, as follows: | |
81 | <pre> | |
82 | ||
83 | [global] | |
84 | load printers = yes | |
85 | printing = cups | |
86 | printcap name = cups | |
87 | ||
88 | [printers] | |
89 | comment = All Printers | |
90 | path = /var/spool/samba | |
91 | browseable = no | |
92 | public = yes | |
93 | guest ok = yes | |
94 | writable = no | |
95 | printable = yes | |
96 | ||
97 | [print$] | |
98 | comment = Printer Drivers | |
99 | path = /etc/samba/drivers | |
100 | browseable = yes | |
101 | guest ok = no | |
102 | read only = yes | |
103 | write list = root | |
104 | </pre> | |
105 | <p>This configuration assumes a FHS-compliant installation of | |
106 | SAMBA; adjust the [printers] and [print$] share paths | |
107 | accordingly on your system as needed. | |
108 | ||
109 | <h2 class="title"><a name="MICROSOFT_POSTSCRIPT_DRIVERS_FOR_WINDOWS">Microsoft Postscript Drivers For Windows</a></h2> | |
110 | The base driver for Windows 2000 and higher is the Microsoft | |
111 | PostScript driver, which is available on any system running | |
112 | Windows 2000 or higher in the | |
113 | %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder for 32-bit | |
114 | drivers and | |
115 | %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit | |
116 | drivers. | |
ffa2ca90 | 117 | <p>However, currently only Windows 2000 and higher is supported by the Microsoft |
94436c5a MS |
118 | driver, so you will also need to get the Adobe driver to support |
119 | Windows 95, 98, and Me clients. The Adobe and Microsoft drivers | |
120 | for Windows 2000 are identical. | |
121 | <p>Once you have extracted the driver files, copy the 32-bit drivers | |
122 | to the <i>/usr/share/cups/drivers</i> directory and the 64-bit | |
123 | drivers to the <i>/usr/share/cups/drivers/x64</i> directory exactly | |
124 | as named below: | |
125 | <pre> | |
126 | ||
127 | [Windows 2000 and higher] | |
128 | ps5ui.dll | |
129 | pscript.hlp | |
130 | pscript.ntf | |
131 | pscript5.dll | |
132 | </pre> | |
133 | <p><b>Note:</b> Unlike Windows, case is significant - make sure that | |
134 | you use the lowercase filenames shown above, otherwise | |
135 | <i>cupsaddsmb</i> will fail to export the drivers. | |
136 | ||
94436c5a MS |
137 | <h2 class="title"><a name="ADOBE_POSTSCRIPT_DRIVERS_FOR_WINDOWS_95,_98,_AND_ME">Adobe Postscript Drivers For Windows 95, 98, And Me</a></h2> |
138 | <i>cupsaddsmb</i> can use the Adobe PostScript printer driver for | |
139 | Windows 95, 98, and ME, which are available for download from the | |
140 | Adobe web site (<a href='http://www.adobe.com).'>http://www.adobe.com).</a> | |
141 | <p>The Adobe driver does not support the page-label, job-billing, or | |
142 | job-hold-until options. | |
143 | <p>Once you have installed the driver on a Windows system, copy the | |
144 | following files to the <i>/usr/share/cups/drivers</i> directory | |
145 | exactly as named below: | |
146 | <pre> | |
147 | ||
148 | [Windows 95, 98, and Me] | |
149 | ADFONTS.MFM | |
150 | ADOBEPS4.DRV | |
151 | ADOBEPS4.HLP | |
152 | ICONLIB.DLL | |
153 | PSMON.DLL | |
154 | </pre> | |
155 | <p><b>Note:</b> Unlike Windows, case is significant - make sure that | |
156 | you use the UPPERCASE filenames shown above, otherwise | |
157 | <i>cupsaddsmb</i> will fail to export the drivers. | |
158 | ||
159 | <h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2> | |
160 | Getting the full set of Windows driver files should be easier. | |
161 | ||
162 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> | |
163 | <i>smbd(8)</i>, <i>smb.conf(5)</i>, | |
164 | <a href='http://localhost:631/help'>http://localhost:631/help</a> | |
1523f10d MS |
165 | <br> |
166 | <a href='http://www.cups.org/windows/'>http://www.cups.org/windows/</a> | |
94436c5a MS |
167 | |
168 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> | |
169 | Copyright 2007-2013 by Apple Inc. | |
170 | ||
171 | </body> | |
172 | </html> |