8.9 Microsoft Networking Client printing with Samba

8.9.1 Client access issues

Because a Windows client formats print jobs before sending them to the server, the administrator may want to hide some of the specialty print queues on the server. For example, the queue that converts LF to CRLF for UNIX text printouts would probably not be shared out. To make such queues invisible, the browseable=no option can be turned on in the smb.conf file. Also, the load printers option must be set to no to allow individual printer definitions.

Windows clients that print to Samba print queues on the UNIX system can view and cancel print jobs in the print queue. They cannot pause them, however, which is a difference between Novell and Windows NT Server print queues. They also cannot prioritize print jobs from the print queue window, although the administrator can reprioritize print jobs that are in the queue from a command shell on the FreeBSD server.

8.9.2 Printer entries in configuration files

Following are listings of sample /etc/printcap and smb.conf files used on the system to provide print services. An explanation of the interaction of these files follows.

#
#
# The printer in lpt0 is a PostScript printer.  The nec-crlf entry
# is for testing the printer when it is switched into HP LaserJet III
# mode.
#

lp|local line printer:\
  :lp=/dev/lpt0:sd=/var/spool/output/lpd:\
  :lf=/var/log/lpd-errs:sh:mx#0:

#

nec-crlf|NEC Silentwriter 95 in ASCII mode with UNIX text filter:\
  :lp=/dev/lpt0:sd=/usr/lpdspool/nec-crlf:\
  :lf=/var/log/lpd-errs:sh:mx#0:\
  :if=/usr/local/libexec/crlfilter:tr=\f:

#

nec-raw|NEC Silentwriter 95 used for PostScript passthrough printing:\
  :lp=/dev/lpt0:sd=/usr/lpdspool/nec-raw:\
  :lf=/var/log/lpd-errs:sh:mx#0:

#

nec-ps-banner|NEC Silentwriter 95 with PostScript banner page created:\
  :lp=/dev/lpt0:sd=/usr/lpdspool/nec-ps-banner:\
  :lf=/var/log/lpd-errs:sh:mx#0:if=/usr/local/libexec/psbanner:

#
#

[global]
comment = FreeBSD - Samba %v
log file = /var/log/samba.log
dont descend = /dev,/proc,/root,/stand
print command = lpr -s -P %p %s; rm %s
interfaces = X.X.X.X (the system IP number goes here)
printing = bsd
map archive = no
status = yes
public = yes
read only = no
preserve case = yes
strip dot = yes
security = share
guest ok = no
password level = 1
dead time = 15
domain master = yes
workgroup = WORKGROUP

[homes]
browseable = no
comment = User Home Directory
create mode = 0775
public = no

[printers]
path = /var/spool
comment = Printers
create mode = 0700
browseable = no
read only = yes
public = no

[lp]
printable = yes
browseable = no

[nec-raw]
comment = Main PostScript printer driver for Windows clients
printer driver = NEC SilentWriter 95
printable = yes
browseable = yes

[wwwroot]
path = /usr/local/www
read only = no
create mode = 0775
comment = Internal Web Server

8.9.3 Browsing output

Following is the output of a net view command executed at a DOS prompt under Windows 95:

Shared resources at \\SERVER

Sharename Type    Comment
--------------------------------------------------------------------
nec-crlf  Print   NEC Silentwriter 95 in ASCII mode
nec-raw   Print   Main PostScript printer driver
tedm      Disk    User Home Directory
wwwroot   Disk    Internal Web Server

The command was completed successfully.

In the /etc/printcap file four print queues are defined, all tied to the printer plugged into the parallel port on the FreeBSD server. The first is lp, the generic local line printer. Since this print queue generally has a filter placed on it to format jobs from the UNIX print queue properly, it should not be visible on the SMB network (i.e., visible in Network Neighborhood). The second queue, nec-crlf, has a filter that converts UNIX text to text that prints without stairstepping, so it also should be hidden from the SMB network. The third, nec-raw, should be visible on the network because this is the spool that the Windows clients use. The last queue, nec-ps-banner, is another specialty queue for UNIX local printing and thus should not be visible.

When the smb.conf file is parsed, the default entry [printers] is first read and used as a set of defaults for printers that are going to be shared out. Next, the /etc/printcap file is read to get a list of all printers on the server. Last, each printer is checked for a service name in the smb.conf file that contains settings that override the set of defaults.

In the listing of what resources are visible on the network, both nec-crlf and nec-raw print queues are visible, and lp and nec-ps-banner is not. lp is not visible because there is a specific entry, [lp] in the smb.conf file that blocks it. nec-ps-banner doesn't have such an entry, but because the print queue name is not a legal length for a SMB name, it isn't shared out either.

The nec-crlf printer is visible so as to illustrate another point - comments. If a print queue has no entry in the smb.conf file and is built by scanning the /etc/printcap file and using the [printers] defaults, the comment is taken from the /etc/printcap file next to the queue definition name. Otherwise, if an entry is made for the printer in the smb.conf file the comment is taken from the entry in smb.conf.