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