]>
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 | .\" |
e3101897 | 7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. |
ef416fc2 | 8 | .\" |
bf1bc4c6 | 9 | .TH cupsaddsmb 8 "CUPS" "11 June 2014" "Apple Inc." |
ef416fc2 | 10 | .SH NAME |
11 | cupsaddsmb \- export printers to samba for windows clients | |
89d46774 | 12 | |
ef416fc2 | 13 | .SH SYNOPSIS |
14 | .B cupsaddsmb | |
bf1bc4c6 MS |
15 | [ |
16 | .B \-H | |
ef416fc2 | 17 | .I samba-server |
bf1bc4c6 MS |
18 | ] [ |
19 | .B \-U | |
ef416fc2 | 20 | .I samba-user[%samba-password] |
bf1bc4c6 MS |
21 | ] [ |
22 | .B \-h | |
bd7854cb | 23 | .I cups-server[:port] |
bf1bc4c6 MS |
24 | ] [ |
25 | .B \-v | |
26 | ] | |
27 | .B \-a | |
ef416fc2 | 28 | .br |
29 | .B cupsaddsmb | |
bf1bc4c6 MS |
30 | [ |
31 | .B \-H | |
ef416fc2 | 32 | .I samba-server |
bf1bc4c6 MS |
33 | ] [ |
34 | .B \-U | |
ef416fc2 | 35 | .I samba-user[%samba-password] |
bf1bc4c6 MS |
36 | ] [ |
37 | .B \-h | |
bd7854cb | 38 | .I cups-server[:port] |
bf1bc4c6 MS |
39 | ] [ |
40 | .B \-v | |
41 | ] | |
42 | .I printer | |
43 | [ ... | |
44 | .I printer | |
45 | ] | |
ef416fc2 | 46 | .SH DESCRIPTION |
bf1bc4c6 MS |
47 | The \fBcupsaddsmb\fR program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients. |
48 | Depending on the SAMBA configuration, you may need to provide a password to export the printers. | |
49 | This program requires the Windows printer driver files described below. | |
50 | .SS SAMBA CONFIGURATION | |
51 | \fBcupsaddsmb\fR uses the RPC-based printing support in SAMBA to provide printer drivers and PPD files to Windows client machines. | |
52 | In order to use this functionality, you must first configure the SAMBA | |
53 | .BR smb.conf (5) | |
54 | file to support printing through CUPS and provide a printer driver download | |
ef416fc2 | 55 | share, as follows: |
56 | .nf | |
57 | ||
58 | [global] | |
59 | load printers = yes | |
60 | printing = cups | |
61 | printcap name = cups | |
62 | ||
63 | [printers] | |
64 | comment = All Printers | |
65 | path = /var/spool/samba | |
66 | browseable = no | |
67 | public = yes | |
68 | guest ok = yes | |
69 | writable = no | |
70 | printable = yes | |
ef416fc2 | 71 | |
72 | [print$] | |
73 | comment = Printer Drivers | |
74 | path = /etc/samba/drivers | |
75 | browseable = yes | |
76 | guest ok = no | |
77 | read only = yes | |
78 | write list = root | |
ef416fc2 | 79 | |
bf1bc4c6 MS |
80 | .fi |
81 | This configuration assumes a FHS-compliant installation of SAMBA; adjust the [printers] and [print$] share paths accordingly on your system as needed. | |
82 | .SS MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS | |
83 | 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 | 84 | .LP |
bf1bc4c6 | 85 | 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 | 86 | .nf |
87 | ||
ef416fc2 | 88 | ps5ui.dll |
89 | pscript.hlp | |
90 | pscript.ntf | |
91 | pscript5.dll | |
ef416fc2 | 92 | |
ef416fc2 | 93 | .fi |
bf1bc4c6 MS |
94 | \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. |
95 | .SH OPTIONS | |
96 | \fBcupsaddsmb\fR supports the following options: | |
97 | .TP 5 | |
98 | \fB\-H \fIsamba-server\fR | |
99 | Specifies the SAMBA server which defaults to the CUPS server. | |
100 | .TP 5 | |
101 | \fB\-U \fIsamba-user\fR[\fB%\fIsamba-password\fR] | |
102 | Specifies the SAMBA print admin username which defaults to your current username. | |
103 | If the username contains a percent (%) character, then the text following the percent is treated as the SAMBA password to use. | |
104 | .TP 5 | |
105 | .B \-a | |
106 | Exports all known printers. | |
107 | Otherwise only the named printers are exported. | |
108 | .TP 5 | |
109 | \fB\-h \fIcups-server\fR[\fB:\fIport\fR] | |
110 | Specifies a different CUPS server to use. | |
111 | .TP 5 | |
112 | .B \-v | |
113 | Specifies that verbose information should be shown. | |
114 | This is useful for debugging SAMBA configuration problems. | |
ef416fc2 | 115 | .SH SEE ALSO |
bf1bc4c6 MS |
116 | .BR rpcclient (1), |
117 | .BR smbclient (1), | |
118 | .BR smbd (8), | |
119 | .BR smb.conf (5), | |
120 | CUPS Online Help (http://localhost:631/help) | |
ef416fc2 | 121 | .SH COPYRIGHT |
bd5a2f28 | 122 | Copyright \[co] 2007-2017 by Apple Inc. |