MODULES(4)

NAME
Modules, Config - post directory software configuration

DESCRIPTION
A modules argument describes a particular directory (database) or network address. The -m option of post(1) and pq(1) and the arguments to server(1M) must describe a directory, and the pq_open call of pq(3C) can describe either a directory or a network address. The syntax for modules arguments is described below. The dirmod and netmod arguments below are modules arguments themselves; in this way various modules can be stacked in a pipeline fashion. The default modules argument is opt join.

  Directory Modules

tee file [dirmod...]
    Attach to the directory specified by dirmod and save the session in file in server(1M) format.

opt [dirmod...]
    Attach to the directory specified by dirmod and pass directory queries in optimized form.

join [file]
    Attach to one or more directories listed in file. Relative paths are prefixed with $POST. The default is lib/dispatch and the format is described in dispatch(4).

virt [dirmod...]
    Attach to the directory specified by dirmod and translate the virtual attributes pn, name, and tel into their constituent attributes (see post(1)).

ev [-s sep] [-d data] [-p proto] [index]
    Attach to an ev(4) directory: sep is the field separator (default vertical bar (|)), index is the directory containing the index files (default current directory), data contains the database records (default index/Data), and proto describes the fields in the data file (default index/Proto). Relative paths are prefixed with $POST.

call [netmod...]
    Connect to the network address specified by netmod and use the server(1M) protocol.

  Network Modules

tap infile outfile [netmod...]
    Connect to the network address specified by netmod and save the input from the network in infile and the output to the network in outfile.

sys file
    Connect to file (typically a device) opened for reading and writing.

cmd program [args...]
    Connect to the standard input and output of program run via execvp(2).

dk dialstring
    Connect to the dk(1) (Datakit) destination dialstring (typically area/exch/line.service).

rx host service
    Connect to the rexec(1) destination host and request service.

tcp host service
    Connect via the socket(3) interface to the TCP/IP host and request service.

tcpti host service
    Connect via the transport interface to the TCP/IP host and request service.

ti netspec address [service]
    Connect to address on the transport provider netspec and optionally request service.

Modules lists the directory and network modules and options for compiling the directory query system of post(1). Each line consists of a module name followed by the cc(1) options needed for compilation of that module. The object file module.o is loaded implicitly, and the special module name + is used to set global compilation options. Blank lines and comments introduced by sharp (#) are ignored.

Config reads the Modules file and creates various files necessary for compilation. The file config.lib contains the cc(1) options needed to load with programs that use pq(3C), and the file networks lists the network modules that were configured. Modules are not included if their header files or libraries are not found.

If the environment variable POST is not set, it defaults to /usr/add-on/post if it exists, or the home directory of the post login.

FILES
$POST/src/pq/Modules
    modules file
$POST/src/pq/Config
    configuration program
$POST/src/pq/config.lib
    libraries needed for compilation
$POST/lib/networks
    configured network modules

SEE ALSO
post(1), server(1M), pq(3C).