Annotation of researchv10dc/man/adm/man1/cu.1, revision 1.1.1.1

1.1       root        1: .TH CU 1
                      2: .CT 1 comm_mach 
                      3: .SH NAME
                      4: cu, ct \- call out to a terminal or another system
                      5: .SH SYNOPSIS
                      6: .B cu
                      7: [
                      8: .B -htn
                      9: ] [
                     10: .B -p
                     11: .I parity
                     12: ] [
                     13: .B -s
                     14: .I speed
                     15: ]
                     16: .I telno
                     17: [
                     18: .I service-class
                     19: ]
                     20: .PP
                     21: .B ct
                     22: [ option ...
                     23: ]
                     24: .I phone-number
                     25: [
                     26: .I service-class
                     27: ]
                     28: .SH DESCRIPTION
                     29: .I Cu
                     30: places a data call to a given telephone number
                     31: and expects a computer to answer.
                     32: It manages an interactive conversation with possible
                     33: transfers of text files.
                     34: .I Telno
                     35: is the telephone number, consisting of digits with minus signs at appropriate
                     36: places to indicate delay for second or subsequent dial tones.
                     37: A telephone number may also be expressed symbolically.
                     38: A symbolic number is looked up in the files
                     39: .F $HOME/lib/cunumber
                     40: and
                     41: .F /usr/lib/cunumber
                     42: whose lines look like this:
                     43: .IP
                     44: symbolic-number
                     45: actual-number
                     46: service-class
                     47: comment
                     48: .LP
                     49: The actual number
                     50: may be preceded by options
                     51: such as
                     52: .BR \-t .
                     53: The
                     54: .I comment,
                     55: if present, is printed out when the connection is made.
                     56: .PP
                     57: The options are
                     58: .TP
                     59: .B -n
                     60: Print the the called number but do not call it.
                     61: .TP
                     62: .B -t
                     63: Tandem:
                     64: use DC1/DC3 
                     65: .RB (control- S /control- Q )
                     66: protocol to stop transmission from
                     67: the remote system when the local terminal buffers are almost full.
                     68: This argument should only be used if the remote system
                     69: understands that protocol.
                     70: .TP
                     71: .B -h
                     72: Half-duplex:
                     73: echo locally the characters that are sent to the remote system.
                     74: .TP
                     75: .BI -s " speed"
                     76: Set the line speed;
                     77: .L 1200
                     78: means 1200 baud, etc.
                     79: The default depends on service class.
                     80: .TP
                     81: .BI -p " parity"
                     82: Set the parity of transmitted characters:
                     83: .BR 0 ,
                     84: .BR 1 ,
                     85: .BR e ,
                     86: .BR o
                     87: mean
                     88: zero,
                     89: one,
                     90: even,
                     91: odd parity.
                     92: .B 0
                     93: is the default.
                     94: .PP
                     95: The service class is expressed as in 
                     96: .IR dialout (3).
                     97: A special class
                     98: .L direct
                     99: causes the
                    100: .I telno
                    101: argument to be taken
                    102: as the pathname
                    103: of a terminal line.
                    104: .I Cu
                    105: opens the file,
                    106: sets line speed and other modes,
                    107: and proceeds as if connected.
                    108: The default line speed is
                    109: 9600 baud.
                    110: .PP
                    111: An explicit service class on the command line overrides
                    112: any specified in a
                    113: .L cunumber
                    114: file.
                    115: .PP
                    116: After making the connection,
                    117: .I cu
                    118: runs as two processes:
                    119: the sending
                    120: process reads the standard input and
                    121: passes most of it to the remote system;
                    122: the receiving
                    123: process reads from the remote system and passes
                    124: most data to the standard output.
                    125: Lines beginning with
                    126: .L ~
                    127: have special meanings.
                    128: .PP
                    129: The sending
                    130: process interprets:
                    131: .TP `\fL~%break\ 'u
                    132: .B ~.
                    133: .br
                    134: .ns
                    135: .TP
                    136: .BR ~ EOT
                    137: Terminate the conversation.
                    138: .TP
                    139: .BI ~< file
                    140: Send the contents of
                    141: .I file
                    142: to the remote system,
                    143: as though typed at the terminal.
                    144: .TP
                    145: .B ~!
                    146: Invoke an interactive shell on the local system.
                    147: .TP
                    148: .BI ~! cmd
                    149: Run the command on the local system
                    150: (via
                    151: .LR "sh -c" ).
                    152: .TP
                    153: .BI ~$ cmd
                    154: Run the command locally and send its output
                    155: to the remote system.
                    156: .TP
                    157: .B ~b
                    158: .br
                    159: .ns
                    160: .TP 
                    161: .B ~%break
                    162: Send a break (300 ms space).
                    163: .TP
                    164: .BI ~%take " from \fR[\fIto\fR]"
                    165: Copy file
                    166: .I from
                    167: (on the remote system)
                    168: to file
                    169: .I to
                    170: on the local system.
                    171: If
                    172: .I to
                    173: is omitted,
                    174: the
                    175: .I from
                    176: name is used both places.
                    177: .TP
                    178: .BI ~%put " from \fR[\fIto\fR]"
                    179: Copy file
                    180: .I from
                    181: (on local system)
                    182: to file
                    183: .I to
                    184: on remote system.
                    185: If
                    186: .I to
                    187: is omitted, the
                    188: .I from
                    189: name is used both places.
                    190: .TP
                    191: .BI ~~ text
                    192: send
                    193: the line
                    194: .BI ~ text .
                    195: .PD
                    196: .PP
                    197: WARNING: Using
                    198: .I cu
                    199: to reach your home machine from a machine you don't trust
                    200: can be hazardous to your password.
                    201: .PP
                    202: .I Ct
                    203: places a telephone call to a remote terminal
                    204: and allows a user to log in on that terminal
                    205: in the normal fashion.
                    206: The terminal must be equipped with an auto-answer
                    207: modem.
                    208: .PP
                    209: The
                    210: phone number and service class
                    211: are as in
                    212: .I cu.
                    213: The options are
                    214: .TP
                    215: .BI -c " count"
                    216: If the number doesn't answer, try 
                    217: .I count
                    218: times before giving up (default 5).
                    219: .TP
                    220: .BI -w " interval
                    221: Space retries
                    222: .I interval
                    223: seconds apart (default 60).
                    224: .TP
                    225: .B -h
                    226: Try to hang up the phone before placing the
                    227: call.
                    228: This is useful for a
                    229: `call me right back' arrangement.
                    230: .SH FILES
                    231: .F /usr/lib/cunumber
                    232: .br
                    233: .F $HOME/lib/cunumber
                    234: .SH "SEE ALSO"
                    235: .IR con (1),
                    236: .IR ttyld (4), 
                    237: .IR dialout (3)
                    238: .SH BUGS
                    239: Unless erase and kill characters are the same on the two machines,
                    240: they will be damaged by
                    241: .BR ~%put .
                    242: .br
                    243: .B ~%take
                    244: uses
                    245: .BR ~>
                    246: at the beginning of line to synchronize transmission.
                    247: This sequence can cause misfunction if it is received
                    248: for any other purpose.

unix.superglobalmegacorp.com

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