cupsaddsmb(8)                    Apple Inc.                    cupsaddsmb(8)

NAME         top

       cupsaddsmb - export printers to samba for windows clients

SYNOPSIS         top

       cupsaddsmb [ -H samba-server ] [ -U samba-user[%samba-password] ] [
       -h cups-server[:port] ] [ -v ] -a
       cupsaddsmb [ -H samba-server ] [ -U samba-user[%samba-password] ] [
       -h cups-server[:port] ] [ -v ] printer [ ...  printer ]

DESCRIPTION         top

       The cupsaddsmb program exports printers to the SAMBA software
       (version 2.2.0 or higher) for use with Windows clients.  Depending on
       the SAMBA configuration, you may need to provide a password to export
       the printers.  This program requires the Windows printer driver files
       described below.

       cupsaddsmb uses the RPC-based printing support in SAMBA to provide
       printer drivers and PPD files to Windows client machines.  In order
       to use this functionality, you must first configure the SAMBA
       smb.conf(5) file to support printing through CUPS and provide a
       printer driver download share, as follows:

            load printers = yes
            printing = cups
            printcap name = cups

            comment = All Printers
            path = /var/spool/samba
            browseable = no
            public = yes
            guest ok = yes
            writable = no
            printable = yes

            comment = Printer Drivers
            path = /etc/samba/drivers
            browseable = yes
            guest ok = no
            read only = yes
            write list = root

       This configuration assumes a FHS-compliant installation of SAMBA;
       adjust the [printers] and [print$] share paths accordingly on your
       system as needed.

       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.

       Copy the 32-bit drivers to the /usr/share/cups/drivers directory and
       the 64-bit drivers to the /usr/share/cups/drivers/x64 directory
       exactly as named below:


       Note: Unlike Windows, case is significant - make sure that you use
       the lowercase filenames shown above, otherwise cupsaddsmb will fail
       to export the drivers.

OPTIONS         top

       cupsaddsmb supports the following options:

       -H samba-server
            Specifies the SAMBA server which defaults to the CUPS server.

       -U samba-user[%samba-password]
            Specifies the SAMBA print admin username which defaults to your
            current username.  If the username contains a percent (%)
            character, then the text following the percent is treated as the
            SAMBA password to use.

       -a   Exports all known printers.  Otherwise only the named printers
            are exported.

       -h cups-server[:port]
            Specifies a different CUPS server to use.

       -v   Specifies that verbose information should be shown.  This is
            useful for debugging SAMBA configuration problems.

SEE ALSO         top

       rpcclient(1), smbclient(1), smbd(8), smb.conf(5), CUPS Online Help

COPYRIGHT         top

       Copyright © 2007-2018 by Apple Inc.

COLOPHON         top

       This page is part of the CUPS (a standards-based, open source
       printing system) project.  Information about the project can be found
       at ⟨⟩.  If you have a bug report for this manual
       page, see ⟨⟩.  This page was obtained from the
       project's upstream Git repository ⟨⟩ on
       2018-10-29.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-10-25.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

11 June 2014                        CUPS                       cupsaddsmb(8)