]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
bf1bc4c6 | 2 | .\" cupsaddsmb man page for CUPS. |
ef416fc2 | 3 | .\" |
bf1bc4c6 MS |
4 | .\" Copyright 2007-2014 by Apple Inc. |
5 | .\" Copyright 1997-2006 by Easy Software Products. | |
ef416fc2 | 6 | .\" |
bf1bc4c6 MS |
7 | .\" These coded instructions, statements, and computer programs are the |
8 | .\" property of Apple Inc. and are protected by Federal copyright | |
9 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
10 | .\" which should have been included with this file. If this file is | |
11 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
ef416fc2 | 12 | .\" |
bf1bc4c6 | 13 | .TH cupsaddsmb 8 "CUPS" "11 June 2014" "Apple Inc." |
ef416fc2 | 14 | .SH NAME |
15 | cupsaddsmb \- export printers to samba for windows clients | |
89d46774 | 16 | |
ef416fc2 | 17 | .SH SYNOPSIS |
18 | .B cupsaddsmb | |
bf1bc4c6 MS |
19 | [ |
20 | .B \-H | |
ef416fc2 | 21 | .I samba-server |
bf1bc4c6 MS |
22 | ] [ |
23 | .B \-U | |
ef416fc2 | 24 | .I samba-user[%samba-password] |
bf1bc4c6 MS |
25 | ] [ |
26 | .B \-h | |
bd7854cb | 27 | .I cups-server[:port] |
bf1bc4c6 MS |
28 | ] [ |
29 | .B \-v | |
30 | ] | |
31 | .B \-a | |
ef416fc2 | 32 | .br |
33 | .B cupsaddsmb | |
bf1bc4c6 MS |
34 | [ |
35 | .B \-H | |
ef416fc2 | 36 | .I samba-server |
bf1bc4c6 MS |
37 | ] [ |
38 | .B \-U | |
ef416fc2 | 39 | .I samba-user[%samba-password] |
bf1bc4c6 MS |
40 | ] [ |
41 | .B \-h | |
bd7854cb | 42 | .I cups-server[:port] |
bf1bc4c6 MS |
43 | ] [ |
44 | .B \-v | |
45 | ] | |
46 | .I printer | |
47 | [ ... | |
48 | .I printer | |
49 | ] | |
ef416fc2 | 50 | .SH DESCRIPTION |
bf1bc4c6 MS |
51 | The \fBcupsaddsmb\fR program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients. |
52 | Depending on the SAMBA configuration, you may need to provide a password to export the printers. | |
53 | This program requires the Windows printer driver files described below. | |
54 | .SS SAMBA CONFIGURATION | |
55 | \fBcupsaddsmb\fR uses the RPC-based printing support in SAMBA to provide printer drivers and PPD files to Windows client machines. | |
56 | In order to use this functionality, you must first configure the SAMBA | |
57 | .BR smb.conf (5) | |
58 | file to support printing through CUPS and provide a printer driver download | |
ef416fc2 | 59 | share, as follows: |
60 | .nf | |
61 | ||
62 | [global] | |
63 | load printers = yes | |
64 | printing = cups | |
65 | printcap name = cups | |
66 | ||
67 | [printers] | |
68 | comment = All Printers | |
69 | path = /var/spool/samba | |
70 | browseable = no | |
71 | public = yes | |
72 | guest ok = yes | |
73 | writable = no | |
74 | printable = yes | |
ef416fc2 | 75 | |
76 | [print$] | |
77 | comment = Printer Drivers | |
78 | path = /etc/samba/drivers | |
79 | browseable = yes | |
80 | guest ok = no | |
81 | read only = yes | |
82 | write list = root | |
ef416fc2 | 83 | |
bf1bc4c6 MS |
84 | .fi |
85 | This configuration assumes a FHS-compliant installation of SAMBA; adjust the [printers] and [print$] share paths accordingly on your system as needed. | |
86 | .SS MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS | |
87 | The base driver for Windows 2000 and higher is the Microsoft PostScript driver, which is available on any system running Windows 2000 or higher in the %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\W32X86\\3 folder for 32-bit drivers and %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\X64\\3 folder for 64-bit drivers. | |
ef416fc2 | 88 | .LP |
bf1bc4c6 | 89 | Copy the 32-bit drivers to the \fI/usr/share/cups/drivers\fR directory and the 64-bit drivers to the \fI/usr/share/cups/drivers/x64\fR directory exactly as named below: |
ef416fc2 | 90 | .nf |
91 | ||
ef416fc2 | 92 | ps5ui.dll |
93 | pscript.hlp | |
94 | pscript.ntf | |
95 | pscript5.dll | |
ef416fc2 | 96 | |
ef416fc2 | 97 | .fi |
bf1bc4c6 MS |
98 | \fBNote:\fR Unlike Windows, case is significant - make sure that you use the lowercase filenames shown above, otherwise \fBcupsaddsmb\fR will fail to export the drivers. |
99 | .SH OPTIONS | |
100 | \fBcupsaddsmb\fR supports the following options: | |
101 | .TP 5 | |
102 | \fB\-H \fIsamba-server\fR | |
103 | Specifies the SAMBA server which defaults to the CUPS server. | |
104 | .TP 5 | |
105 | \fB\-U \fIsamba-user\fR[\fB%\fIsamba-password\fR] | |
106 | Specifies the SAMBA print admin username which defaults to your current username. | |
107 | If the username contains a percent (%) character, then the text following the percent is treated as the SAMBA password to use. | |
108 | .TP 5 | |
109 | .B \-a | |
110 | Exports all known printers. | |
111 | Otherwise only the named printers are exported. | |
112 | .TP 5 | |
113 | \fB\-h \fIcups-server\fR[\fB:\fIport\fR] | |
114 | Specifies a different CUPS server to use. | |
115 | .TP 5 | |
116 | .B \-v | |
117 | Specifies that verbose information should be shown. | |
118 | This is useful for debugging SAMBA configuration problems. | |
ef416fc2 | 119 | .SH SEE ALSO |
bf1bc4c6 MS |
120 | .BR rpcclient (1), |
121 | .BR smbclient (1), | |
122 | .BR smbd (8), | |
123 | .BR smb.conf (5), | |
124 | CUPS Online Help (http://localhost:631/help) | |
ef416fc2 | 125 | .SH COPYRIGHT |
bd5a2f28 | 126 | Copyright \[co] 2007-2017 by Apple Inc. |