faxsrv - UxFax fax spooler and modem driver.
Synopsis
faxsrv [-detach]
Description
Faxsrv is the server process of UxFax. This program runs as the
spooler and spawns copies of itself for each attached modem, unless the "-detach"
option is given, in which case only the spooler will be started.
The program will look for the configuration file named "UxFax2.cfg" located
in the same directory as the executable. This configuration file nominates
all the paths and locations used by the spooler.
The executable must operate as super-user as it must be able to change it's
user and group ID when preparing faxes submitted by users. Therefore the executable
must be owned by "root" and have it's "setuid" and bits set, i.e.;
chown
root faxsrv
chmod 6555 faxsrv
After start-up, the program will detach itself
from the controlling terminal and run as a background (daemon) process.
Files and Directories
The following paths and files are defined in the configuration
file (UxFax2.cfg);
Variable
|
Typical value
|
Description
|
$Utools
|
/usr
|
Root
path to the "Utools" directory
|
$FaxLib
|
/usr/Utools/lib
|
Location
of library text files
|
$FaxBin
|
/usr/Utools/bin
|
Location
of binary executable files
|
$SpoolDir
|
/var/spool/UxFax
|
Root
path to spool directories
|
$FaxInitFile
|
/usr/Utools/lib/UxFax2.ua.glos
|
Initial
text file
|
$FontDir
|
/usr/Utools/font
|
Root
path to font directories
|
The following files are named in the configuration file or $FaxInitFile;
File
|
Description
|
${FaxLib}/UxFax2.msg
|
Message
catalogue
|
$FaxInitFile
|
Constants
and arrays
|
${FaxLib}/UxFax2.forms
|
Client
menus
|
${FaxLib}/UxFax2.local
|
Shell
scripts and device drivers
|
${FaxLib}/UxFax2.modem
|
Modem
driver
|
${FaxLib}/UxFax2.error
|
Server
error handlers
|
See also