]>
Commit | Line | Data |
---|---|---|
1 | .\" | |
2 | .\" cupsaddsmb man page for CUPS. | |
3 | .\" | |
4 | .\" Copyright 2007-2014 by Apple Inc. | |
5 | .\" Copyright 1997-2006 by Easy Software Products. | |
6 | .\" | |
7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. | |
8 | .\" | |
9 | .TH cupsaddsmb 8 "CUPS" "11 June 2014" "Apple Inc." | |
10 | .SH NAME | |
11 | cupsaddsmb \- export printers to samba for windows clients | |
12 | ||
13 | .SH SYNOPSIS | |
14 | .B cupsaddsmb | |
15 | [ | |
16 | .B \-H | |
17 | .I samba-server | |
18 | ] [ | |
19 | .B \-U | |
20 | .I samba-user[%samba-password] | |
21 | ] [ | |
22 | .B \-h | |
23 | .I cups-server[:port] | |
24 | ] [ | |
25 | .B \-v | |
26 | ] | |
27 | .B \-a | |
28 | .br | |
29 | .B cupsaddsmb | |
30 | [ | |
31 | .B \-H | |
32 | .I samba-server | |
33 | ] [ | |
34 | .B \-U | |
35 | .I samba-user[%samba-password] | |
36 | ] [ | |
37 | .B \-h | |
38 | .I cups-server[:port] | |
39 | ] [ | |
40 | .B \-v | |
41 | ] | |
42 | .I printer | |
43 | [ ... | |
44 | .I printer | |
45 | ] | |
46 | .SH DESCRIPTION | |
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 | |
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 | |
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 | |
79 | ||
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. | |
84 | .LP | |
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: | |
86 | .nf | |
87 | ||
88 | ps5ui.dll | |
89 | pscript.hlp | |
90 | pscript.ntf | |
91 | pscript5.dll | |
92 | ||
93 | .fi | |
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. | |
115 | .SH SEE ALSO | |
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) | |
121 | .SH COPYRIGHT | |
122 | Copyright \[co] 2007-2017 by Apple Inc. |