aux/faxsend address page1 ...

aux/faxreceive [ -s spool-dir ] [ -v ]

fax [ -v ] telno recipient [ files ]

service/telcofax

service/telcodata

The options are

-p

use pulse dialing

-v

verbose: write to the log file all communications with the dialer.

-i

specify a source-id to be used during FAX transfers

Some control of outgoing calls can be encoded in the address. Normally, addresses are of the form telco!number, where number is a decimal telephone number. However, commas in the telephone number can be used to insert pauses in the dialing process. Dialing options can be added to the end of the address, separated by !'s. The dialing options are

compress

turn on compression (default off)

baudrate

a decimal number representing the highest baud rate with which to make the call

fax

to make a Class 2 facsimile call (used by programs such as faxsend)

Telco also answers incoming calls. Upon receiving a facsimile call, telco starts the script /rc/bin/service/telcofax. For data calls it starts /rc/bin/service/telcodata. Each is started with the network connection as both standard input and standard output and with two arguments, the file name of the network connection, e.g., /net/telco/0/data, and the type of modem. Currently, the only modem types supported are:

MT1432

Multitech's 14400 baud modem

MT2834

Multitech's 28800 baud modem

ATT14400

the 14400 baud modem in Safaris

VOCAL

the 14400 baud Vocal modem

All other modems are assumed to be compatible with the standard Hayes command subset.

Faxreceive is normally started by /rc/bin/service/telcofax. It reads and spools a CCITT Group 3 (G3) encoded FAX, and then starts the script /sys/lib/fax/receiverc, passing it four arguments: the spool file name, Y (for success) or N, the number of pages, and the id string passed by the caller. This script sends by mail(1) notification to a list of recipients kept in the file /mail/faxqueue/faxrecipients; the script and the list should be edited to match local needs. Faxreceive's options are:

-s

specify a different spool directory; the default is /mail/faxqueue.

-v

verbose: write to the log file all communications with the modem.

Faxsend transmits a FAX to address. Page1 and all arguments that follow are names of files containing G3 encoded FAX images, one per page.

Fax is a shell script that converts to G3 format PostScript, G3, text, or other files acceptable to lp(1) and queues the result to be transmitted to a FAX machine. A standard cover sheet, derived from /sys/lib/fax/h.ps, is sent before the message. Telno is the destination telephone number. Recipient is the name of the recipient to be placed on the cover sheet. If no files are specified, standard input is converted and sent. The -v option invokes page(1) on the generated G3 files instead of transmitting them via FAX machine.

telco /dev/eia1 con -l telco!18005551212

The connection will be made at the highest negotiable baud rate. To use the best negotiable compression scheme as well:

con -l telco!18005551212!compress

The modem specific information is currently built into the source. This should be in a user modifiable file.