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

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.

unix.superglobalmegacorp.com

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