]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
e4e5666b | 2 | .\" "$Id$" |
ef416fc2 | 3 | .\" |
321d8d57 | 4 | .\" cupsaddsmb man page for CUPS. |
ef416fc2 | 5 | .\" |
0fa6c7fa | 6 | .\" Copyright 2007-2013 by Apple Inc. |
ef416fc2 | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
8 | .\" | |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
ef416fc2 | 14 | .\" |
ffa2ca90 | 15 | .TH cupsaddsmb 8 "CUPS" "8 July 2013" "Apple Inc." |
ef416fc2 | 16 | .SH NAME |
17 | cupsaddsmb \- export printers to samba for windows clients | |
89d46774 | 18 | |
ef416fc2 | 19 | .SH SYNOPSIS |
20 | .B cupsaddsmb | |
21 | [ -H | |
22 | .I samba-server | |
23 | ] [ -U | |
24 | .I samba-user[%samba-password] | |
25 | ] [ -h | |
bd7854cb | 26 | .I cups-server[:port] |
ef416fc2 | 27 | ] [ -v ] -a |
28 | .br | |
29 | .B cupsaddsmb | |
30 | [ -H | |
31 | .I samba-server | |
32 | ] [ -U | |
33 | .I samba-user[%samba-password] | |
34 | ] [ -h | |
bd7854cb | 35 | .I cups-server[:port] |
ef416fc2 | 36 | ] [ -v ] printer [ ... printer ] |
89d46774 | 37 | |
ef416fc2 | 38 | .SH DESCRIPTION |
39 | \fIcupsaddsmb\fR exports printers to the SAMBA software (version | |
40 | 2.2.0 or higher) for use with Windows clients. Depending on the | |
41 | SAMBA configuration, you may need to provide a password to | |
42 | export the printers. This program requires the Windows printer | |
43 | driver files described below. | |
89d46774 | 44 | |
bd7854cb | 45 | .SH OPTIONS |
46 | \fIcupsaddsmb\fR supports the following options: | |
47 | .TP 5 | |
48 | -H samba-server | |
49 | .br | |
50 | Specifies the SAMBA server which defaults to the CUPS server. | |
51 | .TP 5 | |
52 | -U samba-user[%samba-password] | |
53 | .br | |
54 | Specifies the SAMBA print admin username which defaults to your | |
55 | current username. If the username contains a percent (%) | |
56 | character, then the text following the percent is treated as the | |
57 | SAMBA password to use. | |
58 | .TP 5 | |
59 | -a | |
60 | .br | |
61 | Exports all known printers. Otherwise only the named printers are | |
62 | exported. | |
63 | .TP 5 | |
64 | -h cups-server[:port] | |
80ca4592 | 65 | .br |
bd7854cb | 66 | Specifies a different CUPS server to use. |
67 | .TP 5 | |
68 | -v | |
80ca4592 | 69 | .br |
bd7854cb | 70 | Specifies that verbose information should be shown. This is |
71 | useful for debugging SAMBA configuration problems. | |
89d46774 | 72 | |
ef416fc2 | 73 | .SH SAMBA CONFIGURATION |
74 | \fIcupsaddsmb\fR uses the new RPC-based printing support in | |
75 | SAMBA 2.2.x to provide printer drivers and PPD files to Windows | |
76 | client machines. In order to use this functionality, you must | |
bd7854cb | 77 | first configure the SAMBA \fIsmb.conf(5)\fR file to support |
ef416fc2 | 78 | printing through CUPS and provide a printer driver download |
79 | share, as follows: | |
80 | .nf | |
81 | ||
82 | [global] | |
83 | load printers = yes | |
84 | printing = cups | |
85 | printcap name = cups | |
86 | ||
87 | [printers] | |
88 | comment = All Printers | |
89 | path = /var/spool/samba | |
90 | browseable = no | |
91 | public = yes | |
92 | guest ok = yes | |
93 | writable = no | |
94 | printable = yes | |
ef416fc2 | 95 | |
96 | [print$] | |
97 | comment = Printer Drivers | |
98 | path = /etc/samba/drivers | |
99 | browseable = yes | |
100 | guest ok = no | |
101 | read only = yes | |
102 | write list = root | |
103 | .fi | |
104 | .LP | |
105 | 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 | .SH MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS | |
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 | |
355e94dc MS |
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. | |
ef416fc2 | 117 | .LP |
ffa2ca90 | 118 | However, currently only Windows 2000 and higher is supported by the Microsoft |
ef416fc2 | 119 | driver, so you will also need to get the Adobe driver to support |
120 | Windows 95, 98, and Me clients. The Adobe and Microsoft drivers | |
121 | for Windows 2000 are identical. | |
122 | .LP | |
355e94dc | 123 | Once you have extracted the driver files, copy the 32-bit drivers |
ffa2ca90 MS |
124 | to the \fI/usr/share/cups/drivers\fR directory and the 64-bit |
125 | drivers to the \fI/usr/share/cups/drivers/x64\fR directory exactly | |
355e94dc | 126 | as named below: |
ef416fc2 | 127 | .nf |
128 | ||
129 | [Windows 2000 and higher] | |
130 | ps5ui.dll | |
131 | pscript.hlp | |
132 | pscript.ntf | |
133 | pscript5.dll | |
134 | .fi | |
89d46774 | 135 | .LP |
136 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
137 | you use the lowercase filenames shown above, otherwise | |
138 | \fIcupsaddsmb\fR will fail to export the drivers. | |
ef416fc2 | 139 | |
bd7854cb | 140 | .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME |
ef416fc2 | 141 | \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for |
bd7854cb | 142 | Windows 95, 98, and ME, which are available for download from the |
143 | Adobe web site (http://www.adobe.com). | |
ef416fc2 | 144 | .LP |
bd7854cb | 145 | The Adobe driver does not support the page-label, job-billing, or |
146 | job-hold-until options. | |
ef416fc2 | 147 | .LP |
89d46774 | 148 | Once you have installed the driver on a Windows system, copy the |
149 | following files to the \fI@CUPS_DATADIR@/drivers\fR directory | |
150 | exactly as named below: | |
ef416fc2 | 151 | .nf |
152 | ||
153 | [Windows 95, 98, and Me] | |
154 | ADFONTS.MFM | |
155 | ADOBEPS4.DRV | |
156 | ADOBEPS4.HLP | |
157 | ICONLIB.DLL | |
158 | PSMON.DLL | |
159 | .fi | |
89d46774 | 160 | .LP |
161 | \fBNote:\fR Unlike Windows, case is significant - make sure that | |
162 | you use the UPPERCASE filenames shown above, otherwise | |
163 | \fIcupsaddsmb\fR will fail to export the drivers. | |
164 | ||
2abf387c | 165 | .SH KNOWN ISSUES |
355e94dc | 166 | Getting the full set of Windows driver files should be easier. |
2abf387c | 167 | |
ef416fc2 | 168 | .SH SEE ALSO |
bd7854cb | 169 | \fIsmbd(8)\fR, \fIsmb.conf(5)\fR, |
170 | http://localhost:631/help | |
89d46774 | 171 | |
ef416fc2 | 172 | .SH COPYRIGHT |
0fa6c7fa | 173 | Copyright 2007-2013 by Apple Inc. |
ef416fc2 | 174 | .\" |
e4e5666b | 175 | .\" End of "$Id$". |
ef416fc2 | 176 | .\" |