Annotation of researchv10dc/man/adm/man1/cu.1, revision 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.