cupsaddsmb(8)

NAME
       cupsaddsmb - export printers to samba for windows clients

SYNOPSIS
       cupsaddsmb  [  -H  samba-server  ]  [ -U samba-user ] [ -h
       cups-server ] [ -v ] -a
       cupsaddsmb [ -H samba-server ] [  -U  samba-user  ]  [  -h
       cups-server ] [ -v ] printer [ ... printer ]

DESCRIPTION
       cupsaddsmb 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.

       The -H option specifies the SAMBA server which defaults to
       the CUPS server.

       The -U option specifies the  SAMBA  print  admin  username
       which defaults to your current username.

       The  -a  option exports all known printers. Otherwise only
       the named printers are exported.

       The -h option specifies a different CUPS server to use.

       The -v option specifies that verbose information should be
       shown  and  is  useful  for  debugging SAMBA configuration
       problems.

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

           [global]
            load printers = yes
            printing = cups
            printcap name = cups

           [printers]
            comment = All Printers
            path = /var/spool/samba
            browseable = no
            public = yes
            guest ok = yes
            writable = no
            printable = yes
            printer admin = root




19 August 2004     Common UNIX Printing System                  1





cupsaddsmb(8)         Easy Software Products        cupsaddsmb(8)


           [print$]
            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.


MICROSOFT POSTSCRIPT DRIVERS FOR WINDOWS
       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  %WIN-
       DOWS%\SYSTEM32\SPOOL\DRIVERS\W32X86\3 folder.

       The CUPS printer driver is preferred  over  the  Microsoft
       driver  since it supports the page-label, job-billing, and
       job-hold-until options fully  on  all  printers.  However,
       currently only Windows 2000 and higher is supported by the
       Microsoft driver, so you will also need to get  the  Adobe
       driver  to  support  Windows  95,  98, and Me clients. The
       Adobe and Microsoft drivers for Windows 2000  are  identi-
       cal.

       Once  you  have  extracted  the  driver  files,  create  a
       "drivers" directory in the CUPS  data  directory  (usually
       /usr/share/cups)  and  copy  the  files  exactly  as named
       below:

           [Windows 2000 and higher]
           ps5ui.dll
           pscript.hlp
           pscript.ntf
           pscript5.dll


CUPS POSTSCRIPT DRIVERS FOR WINDOWS
       cupsaddsmb can use the CUPS v6 PostScript  printer  driver
       for Windows, which is available for download from the CUPS
       web site.

       The CUPS printer driver is preferred over  the  Adobe  and
       Microsoft  drivers  since it supports the page-label, job-
       billing, and job-hold-until options fully on all printers.
       However,  currently  only  Windows 2000 and higher is sup-
       ported by the CUPS driver, so you will also  need  to  get
       the  Adobe  driver  to  support  Windows  95,  98,  and Me
       clients.

       Once  you  have  extracted  the  driver  files,  create  a



19 August 2004     Common UNIX Printing System                  2





cupsaddsmb(8)         Easy Software Products        cupsaddsmb(8)


       "drivers"  directory  in  the CUPS data directory (usually
       /usr/share/cups) and  copy  the  files  exactly  as  named
       below:

           [Windows 2000 and higher]
           cups6.ini
           cupsui6.dll
           cupsdrv6.dll
           ps5ui.dll
           pscript.hlp
           pscript.ntf
           pscript5.dll


ADOBE POSTSCRIPT DRIVERS FOR WINDOWS
       cupsaddsmb can use the Adobe PostScript printer driver for
       Windows, which are available for download from  the  Adobe
       web site (http://www.adobe.com).

       The  CUPS  printer  driver  is  preferred  over  the Adobe
       drivers since they support  the  page-label,  job-billing,
       and  job-hold-until options fully on all printers. You can
       use the Adobe drivers for Windows 9x and the CUPS  drivers
       for  Windows  2000  and  higher.  The  Adobe and Microsoft
       drivers for Windows 2000 are identical.

       Once  you  have  extracted  the  driver  files,  create  a
       "drivers"  directory  in  the CUPS data directory (usually
       /usr/share/cups) and  copy  the  files  exactly  as  named
       below:

           [Windows 95, 98, and Me]
           ADFONTS.MFM
           ADOBEPS4.DRV
           ADOBEPS4.HLP
           ICONLIB.DLL
           PSMON.DLL

SEE ALSO
       CUPS         Software        Administrators        Manual,
       http://localhost:631/documentation.html

COPYRIGHT
       Copyright 1993-2005 by Easy Software Products, All  Rights
       Reserved.












19 August 2004     Common UNIX Printing System                  3