Return to dialout.3 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man3

Annotation of researchv10dc/man/adm/man3/dialout.3, revision 1.1.1.1

1.1       root        1: .TH DIALOUT 3
                      2: .CT 2 comm_mach
                      3: .SH NAME
                      4: dialout \(mi place call on ACU
                      5: .SH SYNOPSIS
                      6: .B int dialout(telno, class)
                      7: .br
                      8: .B char *telno, *class;
                      9: .SH DESCRIPTION
                     10: .I Dialout
                     11: places a data call via an automatic calling unit directly
                     12: attached to the calling computer.
                     13: To use an ACU on Datakit see the example in
                     14: .IR ipc (3).
                     15: .PP
                     16: .I Dialout
                     17: searches for an ACU of the appropriate service class
                     18: and places a data call on the associated line, using the given telephone
                     19: number.
                     20: If successful, it returns an open file descriptor for the line.
                     21: The file is in raw mode, and has exclusive-use and hangup-on-close modes set.
                     22: It returns \-1
                     23: if all ACUs of the given class are busy,
                     24: \-3
                     25: if carrier
                     26: could not be set, and
                     27: \-9
                     28: if the service class is unidentifiable.
                     29: .PP
                     30: The routine consults a data file
                     31: .F /etc/aculist
                     32: that consists of lines containing six blank- or tab-separated fields.
                     33: .TP "\w'service class  'u"
                     34: service class
                     35: Each line with a service class matching the one specified is tried
                     36: in turn until an unoccupied one is found.
                     37: Service classes specify a switching office and a baud rate.
                     38: .IP
                     39: Defined service classes at the `research' site are
                     40: .B 300
                     41: and
                     42: .BR 1200 ,
                     43: for 300- and 1200-baud calls on 665- phone lines, with synonyms
                     44: .B D300
                     45: and
                     46: .BR D1200 .
                     47: Internal calls on these lines require 5 digits.
                     48: Service classes
                     49: .B C300
                     50: and
                     51: .B C1200
                     52: use 582- phone lines.
                     53: Internal calls on these lines require 4 digits and reach only other
                     54: 582- lines.
                     55: .TP
                     56: file
                     57: The file name of the associated special file for the telephone line.
                     58: .TP
                     59: acu
                     60: The file name of the associated ACU.
                     61: If specified as
                     62: .BR none ,
                     63: no ACU is used and the telephone number is ignored.
                     64: This is for hardwired connections.
                     65: .TP
                     66: speed
                     67: The bit rate of the interface, chosen from the numbers given in
                     68: .IR ttyld (4).
                     69: .TP
                     70: prefix
                     71: A string to be prefixed to the number.
                     72: This is handy for shared ACUs in which the first digit specifies a line.
                     73: The prefix
                     74: .L -
                     75: is taken to be an empty prefix.
                     76: .TP
                     77: postfix
                     78: A string to be postfixed to the number to be dialed.
                     79: Some ACUs require an `end of number' code; it should be specified here.
                     80: .SH FILES
                     81: .TP
                     82: .F /etc/aculist
                     83: .SH SEE ALSO
                     84: .IR ttyld (4),
                     85: .IR cu (1),
                     86: .IR ipc (3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.