pcnfsd.conf Configuration File

AIX Version 4 Files Reference

pcnfsd.conf Configuration File

Purpose

Provides configuration options for the rpc.pcnfsd daemon.

Description

The /etc/pcnfsd.conf file is an ASCII file written by users to add options to the operation of the rpc.pcnfsd daemon, which takes no command-line flags.

When started, the rpc.pcnfsd daemon checks for the presence of the pcnfsd.conf configuration file and conforms its performance to the specified arguments. The following options can be entered in the pcnfsd.conf file:

aixargs -BCharacterPair

Controls the printing of burst pages according to the value of the CharacterPair variable, as listed below. The first character applies to the header and the second character to the trailer. Possible values are n (never), a (always), and g (group).

HT	Description
nn	No headers, no trailers
na	No headers, trailer on every file
ng	No header, trailer at the end of the job
an	Header on every file, no trailers
aa	Headers and trailers on every file in the job
ag	Header on every file, trailer after job
gn	Header at beginning of job, no trailer
ga	Header at beginning of job, trailer after every file
gg	Header at beginning of job, trailer at end of job

The header and trailer stanzas in the /etc/qconfig file define the default treatment of burst pages.

Note: The -B flag works exactly like the -B flag in the enq command. Unlike the enq command, however, the rpc.pcnfsd daemon does not allow spaces between the -B flag and the CharacterPair variable.

getjobnum off

Disables the rpc.pcnfsd daemon feature that returns job numbers when print jobs are submitted.

printer Name AliasFor Command

Defines a PC-NFS virtual printer, recognized only by rpc.pcnfsd daemon clients. Each virtual printer is defined on a separate line in the pcnfsd.conf file. The following variables are specified with this option.

Name

Specifies the name of the PC-NFS virtual printer to be defined.

AliasFor

Specifies the name of an existing printer that performs the print job.

Note: To define a PC-NFS virtual printer associated with no existing printer, use a single - (minus sign) instead of the AliasFor variable.

Command

Specifies the command that is run when a file is printed on the Name printer. This command is executed by the Bourne shell, using the -c option. For complex operations, replace the Command variable with an executable shell script.

The following list of tokens and substitution values can be used in the Command variable:

Token	Substitution Value
$FILE	The full path name of the print data file. After the command has executed, the file will be unlinked.
$USER	The user name of the user logged in to the client.
$HOST	The host name of the client system.

spooldir PathName

Designates a new parent directory, PathName, where the rpc.pcnfsd daemon stores the subdirectories it creates for each of its clients. The default parent directory is /var/spool/pcnfs.

uidrange

Specifies the valid UID (user number) range that the rpc.pcnfsd daemon accepts. The default UID range is 101-4294967295.

wtmp off

Disables the login record-keeping feature of the rpc.pcnfsd daemon. By default, the daemon appends to the /var/adm/wtmp file a record of user logins.

Examples

The following sample pcnfsd.conf configuration file demonstrates the effects some options have on the operation of the rpc.pcnfsd daemon:
```
printer test - /usr/bin/cp $FILE
 /usr/tmp/$HOST-$USER
printer sandman san ls -l $FILE
wtmp off
```
The first line establishes a printer test. Files sent to the test printer will be copied into the /usr/tmp directory. Requests to the test PC-NFS virtual printer to list the queue, check the status, or do similar printer operations, will be rejected because a - (minus sign) has been given for the Alias-For parameter.
The second line establishes a PC-NFS virtual printer called sandman that lists, in long form, the file specifications for the print data file.

The third line turns off the rpc.pcnfsd daemon feature that records user logins.
To set a UID range enter:
```
uidrange 1-100,200-50000
```
This entry means that only numbers from 101-199 and over 50000 are invalid UID numbers.

Implementation Specifics

This file is part of NFS in Network Support Facilities in Base Operating System (BOS) Runtime.

Files

/etc/pcnfsd.conf	Specifies the path of the configuration file.
/var/spool/pcnfs directory	Contains subdirectories for clients of the pcnfsd daemon.
/etc/qconfig	Configures a printer queuing system.
/var/adm/wtmp	Describes formats for user and accounting information.

Related Information

The enq command.

The rpc.pcnfsd daemon.

Bourne Shell in AIX Version 4.3 System User's Guide: Operating System and Devices.

Network File System Overview in AIX Version 4.3 System Management Guide: Communications and Networks.

List of NFS Files.