UUPARAMS(5)UUPARAMS(5)NAMEuuparams - UUCP program parameters
SYNOPSIS
/etc/uucp/CONFIG
DESCRIPTION
This file provides an optional parameter changing
facility. UUCP is configured with the defaults listed
below, but any of these defaults can be changed by editing
the configuration file to set the new value.
The basic parameter file that affects all UUCP programs is
`/etc/uucp/CONFIG'. It is installed in a well-known
location principally because it allows the UUCP operating
directory to be altered.
The program uuparams(8) displays the default or altered
parameter settings.
MACROS
Some parameters represent arguments passed to programs
called by UUCP programs. There are some macros that can
be used inside arguments to interpolate fields from the
message being processed by the handler, they are all
identified by the special character &:
&F From. The name of the sender of the message.
&H Home. The name of the destination host (on which the
program is being invoked).
&O Origin.
The name of the host from which the message
originated.
&U User. The name of the user to which the message is
being delivered.
&& If you really need to interpolate just an &.
&% The way to escape a % (see below).
There is a set of macros related to the above that can be
used to interpolate a string depending on the presence of
absence of a value associated with the `&' macro of the
same name. If the string is not interpolated the macro is
replaced by the null string, and if this causes the entire
argument to become empty it is omitted from the list of
arguments. These macros are all enclosed by the special
character %, and take the form:
%{+|-}Xstring%
UUCP 1
UUPARAMS(5)UUPARAMS(5)
The string is interpolated if the form +X is used and the
`&' macro would yield a non-empty string, or if the form
-X is used and the `&' macro would yield an empty string.
Eg:
%+U-u%
will interpolate `-u' if the macro &U would yield a non-
empty user name.
There is another set of macros that can be used to
interpolate a string depending on the evaluation of a
simple boolean expression. If the string is not
interpolated the macro is replaced by the null string, and
if this causes the entire argument to become empty it is
omitted from the list of arguments. These macros are all
enclosed by the special character %, and take the form:
%[!]Xstring%
If the condition selected by X evaluates to true and the
optional ! was not given then string is interpolated.
Where the ! is given string is interpolated when the
condition evaluates to false. The string given may
contain & substitutions, however nested % substitutions
are not permitted.
Selector characters (X) are:
H True if &O is identical with &H, ie: if the message
originated at the destination node.
PARAMETERS
Parameters are defined the same way one defines shell
variables, as in: `NAME=value', one per line. There are
three sorts of parameters, strings, arrays of strings, and
numbers. String arrays are merely comma (`,') separated
strings, as in: `UUCICOARGS="-r1","-c"'. Spaces or tabs
around the `=' will be ignored, as will trailing spaces
and tabs. Strings may be enclosed in double-quotes, which
will be ignored. A leading double-quote may be escaped
with a backslash (`\'). Numbers are hexadecimal if they
have a leading `0x', octal if they have a leading `0',
otherwise decimal.
Comments may be introduced with a hash character (`#') at
the start of a line, and continue to the end of the line.
Empty lines are ignored.
Those parameters with a `prepend' field will have its
value prepended if they don't start with a leading `/'.
UUCP 2
UUPARAMS(5)UUPARAMS(5)
The following parameters may be changed:
Name Default Prepend
ACCESS_REMOTE_FILES 0
ACTIVEFILE ".active"
ALIASFILE L.aliases PARAMSDIR
ALLACUINOUT 0
ANON_USERS uucp,tmj
CMDSFILE L.cmds PARAMSDIR
CMDTIMEOUT 14400
CNNCT_ACCT_FILE connect PARAMSDIR
CORRUPTDIR .Corrupt SPOOLDIR
DEADLOCKTIME 5400
DEBUG 0
DEFAULT_CICO_TURN 1800
DIALFILE "L-dialcodes" PARAMSDIR
DIALINOUT "acucntrl" PARAMSDIR
DIRCHECKTIME 900
DIR_MODE 0755
EXPLAINDIR explain/ PARAMSDIR
FILE_MODE 0666
LOCKDIR /var/run/ SPOOLDIR
LOCKNAMEISDEV 0
LOCKPIDISSTR 0
LOCKPRE LCK..
LOCK_MODE 0444
LOGDIR /var/log/uucp/ SPOOLDIR
LOGIN_MUST_MATCH "uucp:tty9","tmj:ttyd"
LOG_MODE 0644
LOG_BAD_SYS_NAME 0
MAILPROG /usr/sbin/sendmail
MAILPROGARGS ""
MAXUUSCHEDS 4
MAXXQTS 15
MINSPOOLFSFREE 100
NEEDUUXQT .NeedUuxqt SPOOLDIR
NODENAME ""
NODESEQFILE "" PARAMSDIR
NODESEQTEMP "SQTMP" PARAMSDIR
NODESEQLOCK "SQ" PARAMSDIR
NOLOGIN "/etc/nologin"
NOSTRANGERS "uucp:tty9","tmj:ttyd"
ORIG_UUCP 1
PARAMSDIR /etc/uucp/
PROGDIR /usr/libexec/
PROG_PARAMSDIR params/ PARAMSDIR
PUBDIR /var/spool/uucppublic/ SPOOLDIR
SEQFILE SEQF SPOOLDIR
SHELL /bin/sh
SPOOLALTDIRS /var/spool/nuucp/
SPOOLDIR /var/spool/uucp/
STATUSDIR status/ SPOOLDIR
SYSFILE L.sys PARAMSDIR
TELNETD /usr/etc/in.telnetd
UUCP 3
UUPARAMS(5)UUPARAMS(5)
TMPDIR /tmp/
TRACEFLAG 0
USERFILE USERFILE PARAMSDIR
UUCICO uucico PROGDIR
UUCICOARGS "-r1","-c"
UUCICO_ONLY 0
UUCP /usr/bin/uucp
UUCPARGS ""
UUCPGROUP uucp
UUCPUSER uucp
UUSCHED uusched PROGDIR
UUSCHEDARGS ""
UUX /usr/bin/uux
UUXARGS ""
UUXQT uuxqt PROGDIR
UUXQTARGS ""
UUXQTHOOK uuxqt-hook PARAMSDIR
VERIFY_TCP_ADDRESS 0
WARN_NAME_TOO_LONG 0
WORK_FILE_MASK 0137
XQTDIR .Xqtdir SPOOLDIR
If you change UUCPUSER or UUCPGROUP then you must also
change all the ownerships in SPOOLDIR from the old value
to the new value.
Note that it is legal to set a program name to NULLSTR --
it just won't be executed.
Definitions
ACCESS_REMOTE_FILES
Set to 1 (else 0) to allow uux to fetch remote files.
ACTIVEFILE
This can be set to some filename unique to uucico's
spool area to indicate when it is active in the
directory. This will prevent any automatic directory
truncation while uucico is active. Set null
otherwise.
ALIASFILE
Name of aliases file (described in L.aliases(5)).
ALLACUINOUT
Set to 1 if all ACUs are used for simultaneous
dialin/dialout access.
ANON_USERS
A list of comma-separated login names that are
considered to be `anonymous' calls that shouldn't be
allowed to receive any waiting messages.
CMDSFILE
Name of `legal commands' validation file for uuxqt(8).
UUCP 4
UUPARAMS(5)UUPARAMS(5)
CMDTIMEOUT
Timeout for command file.
CNNCT_ACCT_FILE
Name of connect accounting file. Accounting disabled
if this is null. File is created if it doesn't exist.
CORRUPTDIR
Directory for corrupted command files.
DEADLOCKTIME
How long before untouched lock file is considered
dead.
DEBUG
Set global debug level. CARE! This affects all
programs.
DEFAULT_CICO_TURN
Default uucico turn-around time in seconds.
DIALFILE
Name of file holding optional dial codes.
DIALINOUT
Name of program to control ACUs for simultaneous dial
in/out access. (Simultaneous use disabled if null.)
DIRCHECKTIME
Directory check period for new work.
DIR_MODE
Directory creation mode for work directories.
EXPLAINDIR
Directory for program argument explanations (for
boolean program options etc.). Files in this
directory with the same name as a program will be read
by that program if required to provide explanations
for argument options.
FILE_MODE
Basic message file creation mode.
LOCKDIR
Directory for locks.
LOCKNAMEISDEV
Set to 1 if lock files have names representing device
number (sprintf pattern "%s%s%3.3lu.%3.3lu.%3.3lu"
with arguments LOCKDIR, LOCKPRE, maj, maj, min) as
opposed to a device name (sprintf pattern "%s%s%s"
with arguments LOCKDIR, LOCKPRE, tty).
UUCP 5
UUPARAMS(5)UUPARAMS(5)
LOCKPIDISSTR
Set to 1 if lockfiles have ASCII pid (otherwise int).
LOCKPRE
Lock file pre-fix.
LOCK_MODE
Lock file creation mode.
LOGDIR
Directory for program log files.
LOGIN_MUST_MATCH
Non-null if you want to guarantee that the site they
claim to be is who you expect them to be. If this is
defined and the site calling in identifies itself as
"foo", then the login name used MUST be either "foo"
or "Ufoo". If there are exceptions, then they can be
defined in a comma-separated list in the form:
name[<:>line]... where name is the login name, and
each line is an initial string to match the device
they came in on (minus leading `/dev/').
LOG_MODE
Log file creation mode.
LOG_BAD_SYS_NAME
Set to 1 to log bad system names (that don't exist in
SYSFILE.)
MAXUUSCHEDS
Maximum allowed number of simultaneous `uuscheds'.
MAXXQTS
Maximum allowed number of simultaneous `uuxqts'.
MAILPROG MAILPROGARGS
Internally generated mail delivery program and args.
MINSPOOLFSFREE
Minimum space that should be available on the SPOOLDIR
file system, in Kbytes.
NEEDUUXQT
File to request a `uuxqt' scan.
NODENAME
Override kernel name for local node.
NODESEQFILE NODESEQTEMP NODESEQLOCK
These files control node conversation sequence
numbers. Set NODESEQFILE to "SQFILE" to enable, and
add a line for each node with sequencing (not
recommended unless sequencing is known to work at
UUCP 6
UUPARAMS(5)UUPARAMS(5)
remote site).
NOLOGIN
Pathname of file to prevent further activity.
NOSTRANGERS
Non-null if you don't want to accept connections from
sites that are not in your SYSFILE. If there are
exceptions, then they can be defined in a comma-
separated list in the same form as LOGIN_MUST_MATCH
above.
ORIG_UUCP
Set to `1` to emulate original UUCP. DO NOT CHANGE ON
ACTIVE SYSTEM!
PARAMSDIR
Directory for UUCP parameter files.
PROGDIR
Directory for UUCP programs.
PROG_PARAMSDIR
Directory for program specific parameter files. Files
in this directory with the same name as a program will
be read by that program on startup and used to
configure parameters in the same way that
`/etc/uucp/CONFIG' works.
PUBDIR
Location of public files directory.
SEQFILE
Name of work file sequence number file.
SHELL
Bourne shell pathname.
SPOOLALTDIRS
Alternative spool directories for uucp (a `,'
separated list). All the spool directories in
SPOOLALTDIRS (including SPOOLDIR) will be scanned for
work.
SPOOLDIR
Spool directory for uucp. This is the default
directory tree for message file generation.
STATUSDIR
Directory for node call status files.
STRANGERSCMD
Optional command to be run if any connection request
is rejected by the LOGIN_MUST_MATCH or NOSTRANGERS
UUCP 7
UUPARAMS(5)UUPARAMS(5)
options above.
SYSFILE
Name of system file (described in L.sys(5)).
TELNETD
Pathname for telnetd(8) if uucpd(8) should pass non-
UUCICO accounts to telnetd.
TMPDIR
Directory for (very) temporary work files.
TRACEFLAG
Set global routine trace level (not same as DEBUG ).
CARE! This affects all programs.
USERFILE
Name of system file (described in USERFILE(5)).
UUCICO UUCICOARGS
Installed path name and initial args for `uucico'
program.
UUCICO_ONLY
Set to `1' if you wish uucpd(8) to only allow logins
to accounts with shell = UUCICO. (Otherwise, if
TELNETD is non-null, it starts up `telnetd(8)' for
non-UUCICO accounts.)
UUCP
Installed path name of `uucp' program.
UUCPARGS
Initial params for UUCP.
UUCPUSER UUCPGROUP
User/group names for UUCP.
UUSCHED UUSCHEDARGS
Installed path name and initial args for `uusched'
program.
UUX UUXARGS
Installed path name of `uux' program and initial
parameters.
UUXQT UUXQTARGS
Installed path name of `uuxqt' program and initial
parameters.
UUXQT UUXQTHOOK
Optional executable (shell script or binary) which
uuxqt will exec(2) when it is finished. Since
rmail(8) is capable of calling sendmail(8) in
UUCP 8
UUPARAMS(5)UUPARAMS(5)
`queuing' mode, you may wish to make UUXQTHOOK a shell
script that runs `sendmail -q'.
VERIFY_TCP_ADDRESS
Set to 1 to verify incoming TCP connection addresses.
WARN_NAME_TOO_LONG
Set to 1 to warn about otherwise acceptable message
names that exceed the standard maximum length [14].
WORK_FILE_MASK
File creation mask (umask) for temporary work files.
XQTDIR
Directory where uuxqt places temporary files.
EXAMPLE
The file `/etc/uucp/CONFIG' might contain:
LOCKDIR = /var/spool/locks/
LOCKPIDISSTR = 1
MAILPROG = /usr/sbin/sendmail
MAILPROGARGS = "-f&F@&O"
NODENAME = uunet
ORIG_UUCP = 0
SPOOLDIR = /var/spool/nuucp/
SEE ALSOuuparams(8).
UUCP 9
