term% cat index.txt TELCO(4) Kernel Interfaces Manual TELCO(4)
NAME
telco, faxreceive, faxsend, fax, telcofax, telcodata - telephone dialer
network
SYNOPSIS
telco [ -p ] [ -i source-id ] [ -v ] dialer-devs
aux/faxsend address page1 ...
aux/faxreceive [ -s spool-dir ] [ -v ]
fax telno recipient [ files ]
service/telcofax
service/telcodata
DESCRIPTION
Telco is a file server that provides a network interface to Hayes tele‐
phone dialers. The interface is the same as that provided by dk(3) and
ip(3) and can be used by any program that makes network connections us‐
ing dial(2). The network addresses used by telco are telephone num‐
bers.
The options are
-p use pulse dialing
-v verbose: write to the log file all communications with the di‐
aler.
-i specify a source-id to be used during FAX transfers
Some control of outgoing calls can be encoded in the address. Nor‐
mally, addresses are of the form telco!number, where number is a deci‐
mal 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 ar‐
guments, 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 inputs
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 re‐
cipients 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 mo‐
dem.
Faxsend transmits a FAX to address. Page1 and all arguments that fol‐
low are names of files containing G3 encoded fax images, one per page.
Fax is a shell script that queues PostScript, G3, or text files 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 destina‐
tion telephone number. Recipient is the name of the recipient to be
placed on the cover sheet. If no files are specified, standard input
is sent.
EXAMPLE
Start the dialer on a PC, then use con to phone out.
telco /dev/eia1
con -l telco!18005551212
Since cu (see con(1)) knows about telco, this is equivalent:
cu 18005551212
The connection will be made at the highest negotiable baud rate. To
use the best negotiable compression scheme as well:
cu 18005551212!compress
FILES
/mail/faxqueue/*
/rc/bin/service/telcodata
/rc/bin/service/telcofax
/sys/log/telco
/sys/lib/fax/receiverc
/sys/lib/fax/recipients
/sys/lib/fax/h.ps
/sys/log/fax
SOURCE
/sys/src/cmd/telco/*
/sys/src/cmd/fax/*
SEE ALSO
con(1), dk(3), ip(3)
BUGS
These programs require the Class 2 facsimile interface. This means
that faxsend and faxreceive will not work on most portable computers
since they have Class 1 interfaces.
The modem specific information is currently built into the source.
This should be in a user modifiable file.
TELCO(4)