TELCO(4) 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 [ -v ] telno recipient [ files ]
service/telcofax
service/telcodata
DESCRIPTION
Telco is a file server that provides a network interface to
Hayes telephone dialers. The interface is the same as that
provided by ip(3) and can be used by any program that makes
network connections using dial(2). The network addresses
used by telco are telephone numbers.
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 facsim-
ile 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
Page 1 Plan 9 (printed 10/26/25)
TELCO(4) TELCO(4)
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 stan-
dard 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.
EXAMPLE
Start the dialer on a PC, then use con to phone out.
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
Page 2 Plan 9 (printed 10/26/25)
TELCO(4) TELCO(4)
well:
con -l telco!18005551212!compress
FILES
/mail/faxqueue/*
/rc/bin/service/telcodata
/rc/bin/service/telcofax
/sys/log/telco
/sys/lib/fax/receiverc
/mail/faxqueue/faxrecipients
/sys/lib/fax/h.ps
/sys/log/fax
SOURCE
/sys/src/cmd/telco/*
/sys/src/cmd/fax/*
SEE ALSO
con(1), 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.
Page 3 Plan 9 (printed 10/26/25)