]> git.ipfire.org Git - thirdparty/cups.git/blame - man/cupsaddsmb.man.in
Merge pull request #5112 from paulmenzel/remove-libgcrypt-detection
[thirdparty/cups.git] / man / cupsaddsmb.man.in
CommitLineData
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
15cupsaddsmb \- 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
51The \fBcupsaddsmb\fR program exports printers to the SAMBA software (version 2.2.0 or higher) for use with Windows clients.
52Depending on the SAMBA configuration, you may need to provide a password to export the printers.
53This 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.
56In order to use this functionality, you must first configure the SAMBA
57.BR smb.conf (5)
58file to support printing through CUPS and provide a printer driver download
ef416fc2 59share, 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
85This 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
87The 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 89Copy 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
103Specifies the SAMBA server which defaults to the CUPS server.
104.TP 5
105\fB\-U \fIsamba-user\fR[\fB%\fIsamba-password\fR]
106Specifies the SAMBA print admin username which defaults to your current username.
107If 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
110Exports all known printers.
111Otherwise only the named printers are exported.
112.TP 5
113\fB\-h \fIcups-server\fR[\fB:\fIport\fR]
114Specifies a different CUPS server to use.
115.TP 5
116.B \-v
117Specifies that verbose information should be shown.
118This 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),
124CUPS Online Help (http://localhost:631/help)
ef416fc2 125.SH COPYRIGHT
bd5a2f28 126Copyright \[co] 2007-2017 by Apple Inc.