sys/man/4/telco

   1 .TH TELCO 4
   2 .SH NAME
   3 telco, faxreceive, faxsend, fax, telcofax, telcodata \- telephone dialer network
   4 .SH SYNOPSIS
   5 .B telco
   6 [
   7 .B -p
   8 ] [
   9 .B -i
  10 .I source-id
  11 ] [
  12 .B -v
  13 ]
  14 .I dialer-devs
  15 .PP
  16 .B aux/faxsend
  17 .I address
  18 .I page1
  19 \&...
  20 .PP
  21 .B aux/faxreceive
  22 [
  23 .B -s
  24 .I spool-dir
  25 ] [
  26 .B -v
  27 ]
  28 .PP
  29 .B fax
  30 [
  31 .B -v
  32 ]
  33 .I telno
  34 .I recipient
  35 [
  36 .I files
  37 ]
  38 .PP
  39 .B service/telcofax
  40 .PP
  41 .B service/telcodata
  42 .SH DESCRIPTION
  43 .I Telco
  44 is a file server that provides a network interface to
  45 Hayes telephone dialers.
  46 The interface is the same as that provided by
  47 .IR ip (3)
  48 and can be used by any program that makes network connections using
  49 .IR dial (2).
  50 The network addresses used by
  51 .I telco
  52 are telephone
  53 numbers.
  54 .PP
  55 The options are
  56 .TP
  57 .B -p
  58 use pulse dialing
  59 .TP
  60 .B -v
  61 verbose: write to the log file all communications with
  62 the dialer.
  63 .TP
  64 .B -i
  65 specify a
  66 .I source-id
  67 to be used during FAX transfers
  68 .PP
  69 Some control of outgoing calls can be encoded
  70 in the address.
  71 Normally, addresses are of the form
  72 .IB telco ! number\f1,
  73 where
  74 .I number
  75 is a decimal telephone number.
  76 However, commas in the telephone number can be used to insert
  77 pauses in the dialing process.
  78 Dialing options can be added to the end of the address, separated
  79 by
  80 .BR ! 's.
  81 The dialing options are
  82 .TF baudrate
  83 .TP
  84 .B compress
  85 turn on compression (default off)
  86 .TP
  87 .I baudrate
  88 a decimal number representing the highest baud
  89 rate with which to make the call
  90 .TP
  91 .B fax
  92 to make a Class 2 facsimile call (used by programs such as
  93 .IR faxsend )
  94 .PD
  95 .PP
  96 .I Telco
  97 also answers incoming calls.
  98 Upon receiving a facsimile call,
  99 .I telco
 100 starts the script
 101 .BR /rc/bin/service/telcofax .
 102 For data calls it starts
 103 .BR /rc/bin/service/telcodata .
 104 Each is started with the network connection as both standard
 105 input and standard output and with two arguments,
 106 the file name of the network connection, e.g.,
 107 .BR /net/telco/0/data ,
 108 and the type of modem.
 109 Currently, the only modem types supported are:
 110 .TF ATT14400
 111 .TP
 112 .B MT1432
 113 Multitech's 14400 baud modem
 114 .TP
 115 .B MT2834
 116 Multitech's 28800 baud modem
 117 .TP
 118 .B ATT14400
 119 the 14400 baud modem in Safaris
 120 .TP
 121 .B VOCAL
 122 the 14400 baud Vocal modem
 123 .PD
 124 .PP
 125 All other modems are assumed to be compatible with the standard
 126 Hayes command subset.
 127 .PP
 128 .I Faxreceive
 129 is normally started by
 130 .BR /rc/bin/service/telcofax .
 131 It reads and spools a CCITT Group 3 (G3) encoded FAX, and then starts the
 132 script
 133 .BR /sys/lib/fax/receiverc ,
 134 passing it four arguments: the spool file name,
 135 .B Y
 136 (for success) or
 137 .BR N ,
 138 the number of pages, and the id string passed by the caller.
 139 This script sends by
 140 .IR mail (1)
 141 notification to a list of recipients kept in the file
 142 .BR /mail/faxqueue/faxrecipients ;
 143 the script and the list
 144 should be edited to match local needs.
 145 .I Faxreceive's
 146 options are:
 147 .TP
 148 .B -s
 149 specify a different spool directory; the default is
 150 .BR /mail/faxqueue .
 151 .TP
 152 .B -v
 153 verbose: write to the log file all communications with
 154 the modem.
 155 .PP
 156 .I Faxsend
 157 transmits a FAX to
 158 .IR address .
 159 .I Page1
 160 and all arguments that follow
 161 are names of files containing G3 encoded
 162 FAX images, one per page.
 163 .PP
 164 .I Fax
 165 is a shell script that converts to G3 format
 166 PostScript, G3, text, or other files acceptable to
 167 .IR lp (1)
 168 and queues the result
 169 to be transmitted to a FAX machine.
 170 A standard cover sheet, derived from
 171 .BR /sys/lib/fax/h.ps ,
 172 is sent before the message.
 173 .I Telno
 174 is the destination telephone number.
 175 .I Recipient
 176 is the name of the recipient to be placed
 177 on the cover sheet.
 178 If no
 179 .I files
 180 are specified, standard input is converted and sent.
 181 The
 182 .B -v
 183 option invokes
 184 .IR page (1)
 185 on the generated G3 files
 186 instead of transmitting them via FAX machine.
 187 .SH EXAMPLE
 188 Start the dialer on a PC, then use
 189 .I con
 190 to phone out.
 191 .IP
 192 .EX
 193 telco /dev/eia1
 194 con -l telco!18005551212
 195 .EE
 196 .PP
 197 The connection will be made at the highest
 198 negotiable baud rate.  To use the
 199 best negotiable compression scheme as well:
 200 .IP
 201 .EX
 202 con -l telco!18005551212!compress
 203 .EE
 204 .SH FILES
 205 .B /mail/faxqueue/*
 206 .br
 207 .B /rc/bin/service/telcodata
 208 .br
 209 .B /rc/bin/service/telcofax
 210 .br
 211 .B /sys/log/telco
 212 .br
 213 .B /sys/lib/fax/receiverc
 214 .br
 215 .B /mail/faxqueue/faxrecipients
 216 .br
 217 .B /sys/lib/fax/h.ps
 218 .br
 219 .B /sys/log/fax
 220 .SH SOURCE
 221 .B /sys/src/cmd/telco/*
 222 .br
 223 .B /sys/src/cmd/fax/*
 224 .SH "SEE ALSO"
 225 .IR con (1),
 226 .IR ip (3)
 227 .SH BUGS
 228 .PP
 229 These programs require the Class 2 facsimile interface.  This means that
 230 .I faxsend
 231 and
 232 .I faxreceive
 233 will not work on most portable computers since they have Class 1
 234 interfaces.
 235 .PP
 236 The modem specific information is currently built into the source.
 237 This should be in a user modifiable file.