1cupsaddsmb(8) Apple Inc. cupsaddsmb(8)
2
3
4
6 cupsaddsmb - export printers to samba for windows clients
7
8
10 cupsaddsmb [ -H samba-server ] [ -U samba-user[%samba-password] ] [ -h
11 cups-server[:port] ] [ -v ] -a
12 cupsaddsmb [ -H samba-server ] [ -U samba-user[%samba-password] ] [ -h
13 cups-server[:port] ] [ -v ] printer [ ... printer ]
14
16 The cupsaddsmb program exports printers to the SAMBA software (version
17 2.2.0 or higher) for use with Windows clients. Depending on the SAMBA
18 configuration, you may need to provide a password to export the print‐
19 ers. This program requires the Windows printer driver files described
20 below.
21
22 SAMBA CONFIGURATION
23 cupsaddsmb uses the RPC-based printing support in SAMBA to provide
24 printer drivers and PPD files to Windows client machines. In order to
25 use this functionality, you must first configure the SAMBA smb.conf(5)
26 file to support printing through CUPS and provide a printer driver
27 download share, as follows:
28
29 [global]
30 load printers = yes
31 printing = cups
32 printcap name = cups
33
34 [printers]
35 comment = All Printers
36 path = /var/spool/samba
37 browseable = no
38 public = yes
39 guest ok = yes
40 writable = no
41 printable = yes
42
43 [print$]
44 comment = Printer Drivers
45 path = /etc/samba/drivers
46 browseable = yes
47 guest ok = no
48 read only = yes
49 write list = root
50
51 This configuration assumes a FHS-compliant installation of SAMBA;
52 adjust the [printers] and [print$] share paths accordingly on your sys‐
53 tem as needed.
54
55 MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
56 The base driver for Windows 2000 and higher is the Microsoft PostScript
57 driver, which is available on any system running Windows 2000 or higher
58 in the %WINDIR%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder for 32-bit driv‐
59 ers and %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit driv‐
60 ers.
61
62 Copy the 32-bit drivers to the /usr/share/cups/drivers directory and
63 the 64-bit drivers to the /usr/share/cups/drivers/x64 directory exactly
64 as named below:
65
66 ps5ui.dll
67 pscript.hlp
68 pscript.ntf
69 pscript5.dll
70
71 Note: Unlike Windows, case is significant - make sure that you use the
72 lowercase filenames shown above, otherwise cupsaddsmb will fail to
73 export the drivers.
74
76 cupsaddsmb supports the following options:
77
78 -H samba-server
79 Specifies the SAMBA server which defaults to the CUPS server.
80
81 -U samba-user[%samba-password]
82 Specifies the SAMBA print admin username which defaults to your
83 current username. If the username contains a percent (%) charac‐
84 ter, then the text following the percent is treated as the SAMBA
85 password to use.
86
87 -a Exports all known printers. Otherwise only the named printers are
88 exported.
89
90 -h cups-server[:port]
91 Specifies a different CUPS server to use.
92
93 -v Specifies that verbose information should be shown. This is use‐
94 ful for debugging SAMBA configuration problems.
95
97 rpcclient(1), smbclient(1), smbd(8), smb.conf(5), CUPS Online Help
98 (http://localhost:631/help)
99
101 Copyright © 2007-2017 by Apple Inc.
102
103
104
10511 June 2014 CUPS cupsaddsmb(8)