Return to tip.1c CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/tip.1c, revision 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.

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