HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

p
pcnfsd(1M) pcnfsd(1M)
pcnfsd includes a mechanism to define virtual printers known only to
pcnfsd clients. Each of
these printers is defined by an entry in the file
/etc/pcnfsd.conf
using the following for-
mat:
printer name alias-for command
with the following values:
name The name of the printer, as it will be referred to in print requests from
clients.
alias-for The corresponding name for the printer, as it is defined in the line printer
spooling system. For example, a request to display the queue for name will
be translated into the corresponding request for the printer alias-for .If
you have defined a printer within
pcnfsd that has no corresponding
printer defined in the line printer spooling system, use a single hyphen (
-)
for this field. For an example, see the definition of the printer
test in the
examples section, below.
command A command that will be executed whenever a file is printed on name. This
command is executed by the POSIX shell,
/usr/bin/sh
using the -c
option. For complex operations, construct an executable shell program and
execute that in command.
Within command the following tokens will be replaced:
Token Substitution
$FILE Replaced by the full path name of the print data file.
When the command has been executed, the file will be
unlinked.
$USER Replaced by the user name of the user logged in to the
client system.
$HOST Replaced by the host name of the client system.
Reconfiguration
By checking the modification time (and contents) of the file
/var/spool/lp/pstatus
, pcnfsd will
detect when printers have been added or deleted, and will rebuild its list of valid printers. However,
pcnfsd does not monitor the file /etc/pcnfsd.conf
for updates; if you change this file, you must kill
and restart
pcnfsd for the changes to take effect.
EXAMPLES
Given the following entries for the file
/etc/pcnfsd.conf:
printer abc lj lp -dlj -oraw
printer test - /usr/bin/cp $FILE /usr/tmp/$HOST-$USER
If a user on a client system prints a job on printer abc, the request will be sent to destination lj in raw
mode.
If the client requests a list of the print queue for printer
abc, the pcnfsd daemon will translate this into
a request for a listing for printer lj.
Printer
test is used only for testing. Any file sent to this printer will be copied into the directory
/usr/tmp. Any request to list the queue, check the status, etc., of printer test will be rejected because
alias-for has been specified as a hyphen (-).
FILES
/etc/pcnfsd.conf
/etc/rc.config.d/nfsconf
/var/spool/lp/pstatus
/var/spool/pcnfs
/etc/shells
SEE ALSO
lp(1), lpstat(1), inetd(1M), lpadmin(1M), wtmp(4).
Section 1M602 Hewlett-Packard Company 2 HP-UX 11i Version 2: August 2003