MKUUWHO(8) Local MKUUWHO(8)NAMEmkuuwho - make a database suitable for the uuwho command
SYNOPSIS
/usr/lib/smail/mkuuwho [-v] [-x] [-e] [-n] [ -t trace [ -u uuwho_data‐
base ] [ path_config ]
DESCRIPTION
Mkuuwho is a modified version of the mkpath(8) utility, used for creat‐
ing a database for use by the uuwho(1) command. It reads a mkpath(8)
configuration file and builds a DBM database named uuwho_database (by
default a database named /etc/smail/uuwho). This database is used by
the uuwho command to determine where maps for specific sites or domains
can be found. The configuration file is used to determine from which
files, and in which order, map data should be used to create this DBM
database. This command is currently available only on machines that
have the dbm(3X) library functions.
If path_config is -, then a specification will be taken from the stan‐
dard input. If path_config is omitted, then the default specification
/etc/smail/maps/mkpath.conf is used.
CONFIGURATION FILE FORMAT
The format of the path configuration file is a set of lines containing
directives. Blank lines are ignored and the character ``#'' begins a
comment which continues until the end of the line. The various possi‐
ble directives are described below.
In these directive descriptions, an argument of arg refers to one of
the following types of arguments:
literal Literal data specified inline. (single quotes)
shell-command Take data from the standard output of this shell command.
(back quotes)
filename... Take data from the named file or files. Files may be
specified using shell globbing notation, with * ? and
[].
The shell-command form preserves newlines and whitespace and is thus
not entirely equivalent to usage in sh(1). The following lines result
in the same input to uuwho:
map `cat food` # ackpft!
map food # oop ack!
For the shell-command and literal forms, the filename used for error
messages is [stdin].
map arg
Specify map data to be given as input to uuwho. Each file is
preceded by a line containing:
file { pathname }
where pathname is the full pathname to the file. This allows uuwho to
know which from file the data was taken.
safemap arg
This is similar to the map directive, and can be used when you
do not have sufficient control over what the files contain. If
a map file contains pathalias file directives, those directives
are ignored.
delete arg
adjust arg
dead arg
text arg
file filename
These mkpath configuration file directives are ignored by mku‐
uwho.
cd [dir]
By default, the current directory used by mkuuwho begins in the
directory of the configuration file, or in the current directory
if the configuration is read from the standard input. The cd
command without a dir argument changes to the directory from
which mkuuwho was invoked. A dir arg of - changes the directory
to the default directory based on the name of the configuration
file. Otherwise, dir becomes the current directory for file and
shell command references.
sh cmd The given shell command is executed.
pathalias [flags]
pathsort [flags]
These directives end execution blocks (see the next section),
but have no other side effects when processed by mkuuwho.
EXECUTION BLOCKS
Directives are executed in blocks. A map, safemap, delete, adjust,
dead or file directive starts a block. Successive directives continue
it. A pathalias or pathsort directive ends a block. The end of a file
can end a block.
When the start of a block is seen, all directives up to the end of the
block are collected and fed into the resulting uuwho(8) command.
Directives such as cd or sh within a block only effect that block.
Therefore, a cd directive within a block will only change the directory
for the remainder of that block, whereas a cd directive outside of a
block has a global effect.
Additionally an sh directive will feed its standard output into the
block's pathalias command when it is inside a block, while an sh direc‐
tive outside of a block will send its output direct to the standard
output of the mkuuwho command.
OPTIONS
The following options are recognized by mkuuwho:
-v The internal sh(1) commands are executed with a -v option, thus
echoing the commands that are piped to the shell prior to their
being processed.
-x Pass the -x flag to invocations of the shell, causing commands
which are about to execute to be echoed.
-e Pass the -e flag to invocations of the shell, causing shells to
exit whenever a command returns a non-zero exit status. In
addition, the mkuuwho program will exit when it encounters a
syntax error or unknown directive.
-n Disable the execution of any shell commands that mkuuwho gener‐
ates. This is useful with the -v option and disables the -x, -e
and -V options.
-t trace
Cause the input to pathalias to be copied into the file trace.
-u uuwho_database
Cause the named DBM database to be created, rather than using
the default name of /etc/smail/uuwho.
SEE ALSOmkpath(8), uuwho(1), dbm(3X) and sh(1).
BUGS
The first ``#'' character on a line begins a comment regardless of
whether or not it is within quotes.
The -e option does not stop all execution, only command execution
within an instance of the shell created by mkuuwho.
Continuation lines are not currently allowed in the configuration file.
Each command must be on a single line.
COPYRIGHT
Copyright (C) 1987, 1988 Ronald S. Karr and Landon Curt Noll
Copyright (C) 1992 Ronald S. Karr
See a file COPYING, distributed with the source code, or type smail
-bc, to view distribution rights and restrictions associated with this
software.
Smail-3 RELEASE-3_2_0_115 MKUUWHO(8)
