pcnfsd.1m (2010 09)

p
pcnfsd(1M) pcnfsd(1M)
NAME
pcnfsd: rpc.pcnfsd - PC-NFS authentication and print request server
SYNOPSIS
/usr/sbin/rpc.pcnfsd
DESCRIPTION
pcnfsd is an RPC server that supports ONC clients on PC (DOS, OS/2, Macintosh, and other) systems.
This describes version two of the pcnfsd server.
pcnfsd can be started from the /sbin/init.d/nfs.server
startup script by setting the
PCNFS_SERVER variable to 1 in /etc/rc.config.d/nfsconf
, or from the inetd daemon (see
inetd (1M)). It reads the configuration file
/etc/pcnfsd.conf
, if present, and services RPC requests
directed to program number 150001. The
pcnfsd daemon supports version 1 and version 2 of the
PCNFSD protocol.
A fixed port can be specified for
pcnfsd by adding a line to the /etc/pcnfsd.conf
file of the form:
port port_number
The port number can have any value between
1 and 65535. pcnfsd must be restarted after adding the
line to
/etc/pcnfsd.conf
for this to take effect. To disable this feature, delete or comment out the
line specifying the fixed port from
/etc/pcnfsd.conf
and restart pcnfsd.
The requests serviced by
pcnfsd fall into three categories: authentication, printing, and other. Only
the authentication and printing categories have administrative significance.
Authentication
When
pcnfsd receives a PCNFSD_AUTH or PCNFSD2_AUTH request, it will "log in" the user by validat-
ing the user name and password, returning the corresponding user ID, group IDs, home directory, and
umask. The PCNFSD protocol supports user names up to 32 characters for authentication requests.
pcnfsd will also append a record to the wtmps data base (see wtmps (4)). If you do not want PC "logins"
recorded in this way, add a line to the /etc/pcnfsd.conf
file in the form:
wtmp off
By default, pcnfsd will only allow authentication or print requests for users with user IDs in the range
101 to MAXUID. To override this, add a line to the /etc/pcnfsd.conf
file in the form:
uidrange range [, range ]...
where each range is a user ID number in the form
uid
or an inclusive range of user ID numbers in the form
uid
-uid
NOTE:
pcnfsd will deny authentication if the /etc/shells file is incorrectly setup.
Printing
pcnfsd supports a printing model that uses NFS to transfer print data from the client to the server.
The client system issues a PCNFSD_PR_INIT or PCNFSD2_PR_INIT
request, and the server returns
the path to a spool directory that is exported by NFS for use by the client.
pcnfsd creates a subdirectory
for each client. By default, the parent directory is /var/spool/pcnfs, and the name of each subdirec-
tory is the same as its client’s host name. The PCNFSD protocol limits the length of the absolute path of
the client’s spool directory to 64 characters. To use a different parent directory, add a line to the
/etc/pcnfsd.conf file in the form:
spooldir path
Once a client has mounted the spool directory using NFS, and transferred print data to a file in that
directory, it will issue a
PCNFSD_PR_START or PCNFSD2_PR_START request. pcnfsd handles most
print-related requests by constructing a command based on the printing services of the server’s operating
system, and executing that command using the identity of the PC user. Because this involves set-user-ID
privileges, pcnfsd must be run as root. The PCNFSD protocol supports user names up to 64 charac-
ters for print requests.
HP-UX 11i Version 3: September 2010 1 Hewlett-Packard Company 1

Summary of content (4 pages)