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