cupsaddsmb(8)		    Easy Software Products		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  configu-
       ration,	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 functionality, 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

	   [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  %WINDOWS%\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 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 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 supported 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 "drivers" directory
       in  the	CUPS  data  directory  (usually /usr/share/cups) and copy the
       files exactly as named below:

	   [Windows 2000 and higher]
	   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/documenta-
       tion.html

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



19 August 2004		 Common UNIX Printing System		cupsaddsmb(8)

UNIX/Linux commands referenced on this page:

1. which
2. as
3. write