MKUUWHO
Section: Misc. Reference Manual Pages (X_MAN8_EXT_X)
Updated: 31 January 1988
Index
Return to Main Contents
NAME
mkuuwho - make a database suitable for the uuwho command
SYNOPSIS
X_UTIL_BIN_DIR_X/mkuuwho
[-v]
[-x]
[-e]
[-n]
[
-t
trace
[
-u
uuwho_database
] [
path_config
]
DESCRIPTION
Mkuuwho
is a modified version of the
mkpath(X_MAN8_EXT_X)
utility, used for creating a database for use by the
uuwho(X_MAN1_EXT_X)
command. It reads a
mkpath(X_MAN8_EXT_X)
configuration file and builds a DBM database named
uuwho_database
(by default a database named
X_LIB_DIR_X/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 standard input.
If
path_config
is omitted, then the default specification
X_LIB_DIR_X/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 possible 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
mkuuwho.
- 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(X_MAN8_EXT_X)
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
directive 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
generates. 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
X_LIB_DIR_X/uuwho.
SEE ALSO
mkpath(X_MAN8_EXT_X),
uuwho(X_MAN1_EXT_X),
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
for distribution rights and restrictions
associated with this software.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- CONFIGURATION FILE FORMAT
-
- EXECUTION BLOCKS
-
- OPTIONS
-
- SEE ALSO
-
- BUGS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 06:53:34 GMT, May 19, 2025