1 files changed, 226 insertions, 0 deletions
diff --git a/static/plan9-4e/man4/telco.4 b/static/plan9-4e/man4/telco.4
new file mode 100644
index 00000000..f78a9086
--- /dev/null
+++ b/static/plan9-4e/man4/telco.4
@@ -0,0 +1,226 @@
+.TH TELCO 4
+.SH NAME
+telco, faxreceive, faxsend, fax, telcofax, telcodata \- telephone dialer network
+.SH SYNOPSIS
+.B telco
+[
+.B -p
+] [
+.B -i
+.I source-id
+] [
+.B -v
+]
+.I dialer-devs
+.PP
+.B aux/faxsend
+.I address
+.I page1
+\&...
+.PP
+.B aux/faxreceive
+[
+.B -s
+.I spool-dir
+] [
+.B -v
+]
+.PP
+.B fax
+.I telno
+.I recipient
+[
+.I files
+]
+.PP
+.B service/telcofax
+.PP
+.B service/telcodata
+.SH DESCRIPTION
+.I Telco
+is a file server that provides a network interface to
+Hayes telephone dialers.
+The interface is the same as that provided by
+.IR ip (3)
+and can be used by any program that makes network connections using
+.IR dial (2).
+The network addresses used by
+.I telco
+are telephone
+numbers.
+.PP
+The options are
+.TP
+.B -p
+use pulse dialing
+.TP 
+.B -v
+verbose: write to the log file all communications with
+the dialer.
+.TP 
+.B -i
+specify a
+.I source-id
+to be used during FAX transfers
+.PP
+Some control of outgoing calls can be encoded
+in the address.
+Normally, addresses are of the form
+.IB telco ! number\f1,
+where 
+.I 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
+.BR ! 's.
+The dialing options are
+.TF baudrate
+.TP
+.B compress
+turn on compression (default off)
+.TP
+.I baudrate
+a decimal number representing the highest baud
+rate with which to make the call
+.TP
+.B fax
+to make a Class 2 facsimile call (used by programs such as
+.IR faxsend )
+.PD
+.PP
+.I Telco
+also answers incoming calls.
+Upon receiving a facsimile call,
+.I telco
+starts the script
+.BR /rc/bin/service/telcofax .
+For data calls it starts
+.BR /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.,
+.BR /net/telco/0/data ,
+and the type of modem.
+Currently, the only modem types supported are:
+.TF ATT14400
+.TP
+.B MT1432
+Multitech's 14400 baud modem
+.TP
+.B MT2834
+Multitech's 28800 baud modem
+.TP
+.B ATT14400
+the 14400 baud modem in Safaris
+.TP
+.B VOCAL
+the 14400 baud Vocal modem
+.PD
+.PP
+All other modems are assumed to be compatible with the standard
+Hayes command subset.
+.PP
+.I Faxreceive
+is normally started by
+.BR /rc/bin/service/telcofax .
+It inputs and spools a CCITT Group 3 (G3) encoded FAX, and then starts the
+script
+.BR /sys/lib/fax/receiverc ,
+passing it four arguments: the spool file name,
+.B Y
+(for success) or
+.BR N ,
+the number of pages, and the id string passed by the caller.
+This script sends by
+.IR mail (1)
+notification to a list of recipients kept in the file
+.BR /mail/faxqueue/faxrecipients ;
+the script and the list
+should be edited to match local needs.
+.I Faxreceive's
+options are:
+.TP
+.B -s
+specify a different spool directory; the default is
+.BR /mail/faxqueue .
+.TP
+.B -v
+verbose: write to the log file all communications with
+the modem.
+.PP
+.I Faxsend
+transmits a FAX to
+.IR address .
+.I Page1
+and all arguments that follow
+are names of files containing G3 encoded
+FAX images, one per page.
+.PP
+.I 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
+.BR /sys/lib/fax/h.ps ,
+is sent before the message.
+.I Telno
+is the destination telephone number.
+.I Recipient
+is the name of the recipient to be placed
+on the cover sheet.
+If no
+.I files
+are specified, standard input is sent.
+.SH EXAMPLE
+Start the dialer on a PC, then use
+.I con
+to phone out.
+.IP
+.EX
+telco /dev/eia1
+con -l telco!18005551212
+.EE
+.PP
+The connection will be made at the highest
+negotiable baud rate.  To use the
+best negotiable compression scheme as well:
+.IP
+.EX
+con -l telco!18005551212!compress
+.EE
+.SH FILES
+.B /mail/faxqueue/*
+.br
+.B /rc/bin/service/telcodata
+.br
+.B /rc/bin/service/telcofax
+.br
+.B /sys/log/telco
+.br
+.B /sys/lib/fax/receiverc
+.br
+.B /mail/faxqueue/faxrecipients
+.br
+.B /sys/lib/fax/h.ps
+.br
+.B /sys/log/fax
+.SH SOURCE
+.B /sys/src/cmd/telco/*
+.br
+.B /sys/src/cmd/fax/*
+.SH "SEE ALSO"
+.IR con (1),
+.IR ip (3)
+.SH BUGS
+.PP
+These programs require the Class 2 facsimile interface.  This means that
+.I faxsend
+and
+.I faxreceive
+will not work on most portable computers since they have Class 1
+interfaces.
+.PP
+The modem specific information is currently built into the source.
+This should be in a user modifiable file.