unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (plan9)
Page:
Section:
Apropos / Subsearch:
optional field

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
       using  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
              dialer.

       -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
       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 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
       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  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)