Annotation of cci/usr/src/man/man1/tip.1c, revision 1.1.1.1

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

unix.superglobalmegacorp.com

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