Configuring the software

3. Configuring the software

The behavior of XFAX is mainly controlled by a number of keywords used in the configuration file, config. You can alter the way XFAX acts by modifying config and then restart faxmaster. You restart the faxmaster by finding the process id, kill the process and then start the daemon again. Do not use the –9 option when killing the faxmaster process.

3.1 Keywords

To use a new keyword in the configuration file add the keyword, preferably at the end of the file, and then restart faxmaster.

Examples of some useful keywords:

DIAL_PREFIXDial prefix, for example "0" to get out through a PBX

INIT_STRINGInitilisation string for modem

XON_XOFFSpecifies XON/XOFF flow control is to be used

FLOWFLOW=0 specifies do not try CTS/RTS flow control

EXECUTE_AFTER_SENDSpecify a program to be executed after transmission

MAX_RETRIESMaximum number of tries to send a message

RETRY_TIMETime, in minutes, between tries

ROUND_ROBINUsed with multiple modem devices

There are more than 100 different keywords used by XFAX.

3.2 Environment variables

A couple of environment variables can be used to change the behavior of XFAX:

XFAXDIRSpecifies where the XFAX config file is located, normally /etc/xfax.

XFAXCONFIGSpecifies an alternate config file to use. Must specify the file- name including the complete absolute path.

XFAXIDSpecifies for faxsend which id to use, this is displayed in the page header.

XFAXLICENSESpecifies an alternate XFAX licence file to use.

Example, in Bourne shell:

XFAXCONFIG=/etc/xfax/config2 export XFAXCONFIG

XFAX - User’s Guide 4.3a

9

Page 9
Image 9
Nordic Star Products 4.3A manual Configuring the software, Keywords, Environment variables