|
|
1.1.1.2 ! root 1: .TH TIP 1C "24 Oct 1985" 1.1 root 2: .UC 4 3: .SH NAME 4: tip, cu \- connect to a remote system 5: .SH SYNOPSIS 6: .B tip 7: [ 8: .B \-v 9: ] [ 10: .BI \- speed 1.1.1.2 ! root 11: ] [ ! 12: .B \-m ! 13: .I minutes 1.1 root 14: ] system-name 15: .br 16: .B tip 17: [ 18: .B \-v 19: ] [ 20: .BI \- speed 1.1.1.2 ! root 21: ] [ ! 22: .B \-m ! 23: .I minutes 1.1 root 24: ] phone-number 25: .br 26: .B cu 27: phone-number 28: [ 29: .B \-t 30: ] [ 31: .B \-s 32: .I speed 33: ] [ 34: .B \ -a 35: .I acu 36: ] [ 37: .B \-l 38: .I line 39: ] [ 1.1.1.2 ! root 40: .B \-m ! 41: .I minutes ! 42: ] [ 1.1 root 43: .B \-# 44: ] 45: .SH DESCRIPTION 46: .I Tip 47: and 48: .I cu 49: establish a full-duplex connection to another machine, 50: giving the appearance of being logged in directly on the 51: remote cpu. It goes without saying that you must have a login 52: on the machine (or equivalent) to which you wish to connect. 53: The preferred interface is 54: .IR tip . 55: The 56: .I cu 57: interface is included for those people attached to the 58: ``call UNIX'' command of version 7. This manual page 59: describes only 60: .IR tip . 61: .PP 62: Typed characters are normally transmitted directly to the remote 63: machine (which does the echoing as well). A tilde (`~') appearing 64: as the first character of a line is an escape signal; the following 65: are recognized: 66: .TP 10 67: .B ~^D ~. 68: Drop the connection and exit 69: (you may still be logged in on the 70: remote machine). 71: .TP 10 72: \fB~c \fP [\fIname\fP] 73: Change directory to name (no argument 74: implies change to your home directory). 75: .TP 10 76: .B ~! 77: Escape to a shell (exiting the shell will 78: return you to tip). 79: .TP 10 80: .B ~> 81: Copy file from local to remote. 82: .I Tip 83: prompts for the name of a local file to transmit. 84: .TP 10 85: .B ~< 86: Copy file from remote to local. 87: .I Tip 88: prompts first for the name of the file to be sent, then for 89: a command to be executed on the remote machine. 90: .TP 10 91: \fB~p\fP \fIfrom\fP [ \fIto\fP ] 92: Send a file to a remote UNIX host. The put command causes the remote UNIX 93: system to run the command string ``cat > 'to''', while 94: .I tip 95: sends it the ``from'' 96: file. If the ``to'' file isn't specified the ``from'' file name is used. 97: This command is actually a UNIX specific version of the ``~>'' command. 98: .TP 10 99: \fB~t\fP \fIfrom\fP [ \fIto\fP ] 100: Take a file from a remote UNIX host. 101: As in the put command the ``to'' file 102: defaults to the ``from'' file name if it isn't specified. 103: The remote host 104: executes the command string ``cat 'from';echo ^A'' to send the file to 105: .IR tip . 106: .TP 10 107: .B ~| 108: Pipe the output from a remote command to a local UNIX process. 109: The command string sent to the local UNIX system is processed by the shell. 110: .TP 10 111: .B ~# 112: Send a BREAK to the remote system. 113: For systems which don't support the 114: necessary 115: .I ioctl 116: call the break is simulated by a sequence of line speed changes 117: and DEL characters. 118: .TP 10 119: .B ~s 120: Set a variable (see the discussion below). 121: .TP 10 122: .B ~^Z 123: Stop 124: .I tip 125: (only available with job control). 126: .TP 10 1.1.1.2 ! root 127: \fB~m\fP \fIminutes\fP ! 128: Change the logout timer value (see the discussion below). ! 129: .TP 10 1.1 root 130: .B ~? 131: Get a summary of the tilde escapes 132: .sp 133: .PP 134: .I Tip 135: uses the file /etc/remote to find how to reach a particular 136: system and to find out how it should operate while talking 137: to the system; 138: refer to 139: .IR remote (5) 140: for a full description. 141: Each system has a default baud rate with which to 142: establish a connection. If this value is not suitable, the baud rate 143: to be used may be specified on the command line, e.g. ``tip -300 mds''. 144: .PP 145: When 146: .I tip 147: establishes a connection it sends out a 148: connection message to the remote system; the default value, if any, 149: is defined in /etc/remote. 150: .PP 151: When 152: .I tip 153: prompts for an argument (e.g. during setup of 154: a file transfer) the line typed may be edited with the standard 155: erase and kill characters. A null line in response to a prompt, 156: or an interrupt, will abort the dialogue and return you to the 157: remote machine. 158: .PP 159: .I Tip 160: guards against multiple users connecting to a remote system 161: by opening modems and terminal lines with exclusive access, 162: and by honoring the locking protocol used by 163: .IR uucp (1C). 164: .PP 165: During file transfers 166: .I tip 167: provides a running count of the number of lines transferred. 168: When using the ~> and ~< commands, the ``eofread'' and ``eofwrite'' 169: variables are used to recognize end-of-file when reading, and 170: specify end-of-file when writing (see below). File transfers 171: normally depend on tandem mode for flow control. If the remote 172: system does not support tandem mode, ``echocheck'' may be set 173: to indicate 174: .I tip 175: should synchronize with the remote system on the echo of each 176: transmitted character. 177: .PP 178: When 179: .I tip 180: must dial a phone number to connect to a system it will print 181: various messages indicating its actions. 182: .PP 1.1.1.2 ! root 183: In an attempt to avoid forgetting to terminate the ! 184: .I tip ! 185: session, thereby ! 186: causing large phone bills, ! 187: .I tip ! 188: will logout the user if either no characters have been typed ! 189: or no characters have been displayed on the terminal ! 190: in the last 20 minutes. ! 191: The timeout value may be adjusted with the ! 192: .B \-m ! 193: option, with the next argument being used as the timeout value ! 194: (in minutes). ! 195: Once logged in, ! 196: the ! 197: .B ~m ! 198: command may be used to alter the logout timeout value dynamically. ! 199: This logout timeout value will not effect file transfers, ! 200: but, it is important to note, if a process is started in the foreground and ! 201: runs for a longer period than the timeout will allow and no output ! 202: is ongoing to the terminal, ! 203: the logout timer will expire and terminate the ! 204: .I tip ! 205: session. ! 206: There is a warning message displayed when the timer expires and an ! 207: additional 60 seconds are allowed before the ! 208: .I tip ! 209: session is terminated. ! 210: .PP 1.1 root 211: .SM 212: .B VARIABLES 213: .PP 214: .I Tip 215: maintains a set of 216: .I variables 217: which control its operation. 218: Some of these variable are read-only to normal users (root is allowed 219: to change anything of interest). Variables may be displayed 220: and set through the ``s'' escape. The syntax for variables is patterned 221: after 222: .IR vi (1) 223: and 224: .IR Mail (1). 225: Supplying ``all'' 226: as an argument to the set command displays all variables readable by 227: the user. Alternatively, the user may request display of a particular 228: variable by attaching a `?' to the end. For example ``escape?'' 229: displays the current escape character. 230: .PP 231: Variables are numeric, string, character, or boolean values. Boolean 232: variables are set merely by specifying their name; they may be reset 233: by prepending a `!' to the name. Other variable types are set by 234: concatenating an `=' and the value. The entire assignment must not 235: have any blanks in it. A single set command may be used to interrogate 236: as well as set a number of variables. 237: Variables may be initialized at run time by placing set commands 238: (without the ``~s'' prefix in a file 239: .I .tiprc 240: in one's home directory). The 241: .B \-v 242: option causes 243: .I tip 244: to display the sets as they are made. 245: Certain common variables have abbreviations. 246: The following is a list of common variables, 247: their abbreviations, and their default values. 248: .TP 249: .B beautify 250: .br 251: (bool) Discard unprintable characters when a session is being scripted; 252: abbreviated 253: .IR be . 254: .TP 255: .B baudrate 256: .br 257: (num) The baud rate at which the connection was established; 258: abbreviated 259: .IR ba . 260: .TP 261: .B dialtimeout 262: .br 263: (num) When dialing a phone number, the time (in seconds) 264: to wait for a connection to be established; abbreviated 265: .IR dial . 266: .TP 267: .B echocheck 268: .br 269: (bool) Synchronize with the remote host during file transfer by 270: waiting for the echo of the last character transmitted; default is 271: .IR off . 272: .TP 273: .B eofread 274: .br 275: (str) The set of characters which signify and end-of-tranmission 276: during a ~< file transfer command; abbreviated 277: .IR eofr . 278: .TP 279: .B eofwrite 280: .br 281: (str) The string sent to indicate end-of-transmission during 282: a ~> file transfer command; abbreviated 283: .IR eofw . 284: .TP 285: .B eol 286: .br 287: (str) The set of characters which indicate an end-of-line. 288: .I Tip 289: will recognize escape characters only after an end-of-line. 290: .TP 291: .B escape 292: .br 293: (char) The command prefix (escape) character; abbreviated 294: .IR es ; 295: default value is `~'. 296: .TP 297: .B exceptions 298: .br 299: (str) The set of characters which should not be discarded 300: due to the beautification switch; abbreviated 301: .IR ex ; 302: default value is ``\et\en\ef\eb''. 303: .TP 304: .B force 305: .br 306: (char) The character used to force literal data transmission; 307: abbreviated 308: .IR fo ; 309: default value is `^P'. 310: .TP 311: .B framesize 312: .br 313: (num) The amount of data (in bytes) to buffer between file system 314: writes when receiving files; abbreviated 315: .IR fr . 316: .TP 317: .B host 318: .br 319: (str) The name of the host to which you are connected; abbreviated 320: .IR ho . 321: .TP 322: .B prompt 323: .br 324: (char) The character which indicates and end-of-line on the remote 325: host; abbreviated 326: .IR pr ; 327: default value is `\en'. This value is used to synchronize during 328: data transfers. The count of lines transferred during a file transfer 1.1.1.2 ! root 329: command is based on receipt of this character. 1.1 root 330: .TP 331: .B raise 332: .br 333: (bool) Upper case mapping mode; abbreviated 334: .IR ra ; 335: default value is 336: .IR off . 337: When this mode is enabled, all lower case letters will be mapped to 338: upper case by 339: .I tip 340: for transmission to the remote machine. 341: .TP 342: .B raisechar 343: .br 344: (char) The input character used to toggle upper case mapping mode; 345: abbreviated 346: .IR rc ; 347: default value is `^A'. 348: .TP 349: .B record 350: .br 351: (str) The name of the file in which a session script is recorded; 352: abbreviated 353: .IR rec ; 354: default value is ``tip.record''. 355: .TP 356: .B script 357: .br 358: (bool) Session scripting mode; abbreviated 359: .IR sc ; 360: default is 361: .IR off . 362: When 363: .I script 364: is 365: .IR true , 366: .I tip 367: will record everything transmitted by the remote machine in 368: the script record file specified in 369: .IR record . 370: If the 371: .I beautify 372: switch is on, only printable ASCII characters will be included in 1.1.1.2 ! root 373: the script file (those characters between 040 and 0177). The 1.1 root 374: variable 375: .I exceptions 376: is used to indicate characters which are an exception to the normal 377: beautification rules. 378: .TP 379: .B tabexpand 380: .br 381: (bool) Expand tabs to spaces during file transfers; abbreviated 382: .IR tab ; 383: default value is 384: .IR false . 385: Each tab is expanded to 8 spaces. 386: .TP 387: .B verbose 388: .br 389: (bool) Verbose mode; abbreviated 390: .IR verb ; 391: default is 392: .IR true . 393: When verbose mode is enabled, 394: .I tip 395: prints messages while dialing, shows the current number 396: of lines transferred during a file transfer operations, 397: and more. 398: .TP 399: .B SHELL 400: .br 401: (str) The name of the shell to use for the ~! command; default 402: value is ``/bin/sh'', or taken from the environment. 403: .TP 404: .B HOME 405: .br 406: (str) The home directory to use for the ~c command; default 407: value is taken from the environment. 408: .PP 409: .SH FILES 410: .ta \w'/usr/spool/uucp/LCK..* 'u 411: .nf 412: /etc/remote global system descriptions 413: /etc/phones global phone number data base 414: ${REMOTE} private system descriptions 415: ${PHONES} private phone numbers 416: ~/.tiprc initialization file. 417: /usr/spool/uucp/LCK..* lock file to avoid conflicts with \fIuucp\fP 418: .fi 419: .SH DIAGNOSTICS 420: Diagnostics are, hopefully, self explanatory. 421: .SH "SEE ALSO" 422: remote(5), 423: phones(5) 424: .SH BUGS 425: The full set of variables is undocumented and should, probably, be 426: paired down.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.