telco man page on Plan9

Man page or keyword search:  
man Server   549 pages
apropos Keyword Search (all sections)
Output format
Plan9 logo
[printable version]

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 tele‐
       phone 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.	  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	 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 fol‐
       low 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 trans‐
       mitted 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 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 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.

								      TELCO(4)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Plan9

List of man pages available for Plan9

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net