summaryrefslogtreecommitdiff
path: root/usr/src/man/man1/tip.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1/tip.1')
-rw-r--r--usr/src/man/man1/tip.1128
1 files changed, 2 insertions, 126 deletions
diff --git a/usr/src/man/man1/tip.1 b/usr/src/man/man1/tip.1
index 5919c958a0..f10639a1ff 100644
--- a/usr/src/man/man1/tip.1
+++ b/usr/src/man/man1/tip.1
@@ -1,6 +1,6 @@
'\" te
.\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved
-.TH tip 1 "28 Nov 2001" "SunOS 5.11" "User Commands"
+.TH TIP 1 "Nov 28, 2001"
.SH NAME
tip \- connect to remote system
.SH SYNOPSIS
@@ -70,12 +70,10 @@ your home directory.
.SH OPTIONS
.sp
.ne 2
-.mk
.na
\fB\fB-v\fR\fR
.ad
.RS 6n
-.rt
Display commands from the \fB\&.tiprc\fR file as they are executed.
.RE
@@ -98,7 +96,6 @@ signal which directs \fBtip\fR to perform some special action. \fBtip\fR
recognizes the following escape sequences:
.sp
.ne 2
-.mk
.na
\fB\fB~^D\fR\fR
.ad
@@ -107,7 +104,6 @@ recognizes the following escape sequences:
\fB\fB~.\fR\fR
.ad
.RS 18n
-.rt
Drop the connection and exit (you may still be logged in on the remote
machine). \fBNote:\fR If you rlogin and then run \fBtip\fR on the remote host,
you must type \fB~~.\fR (tilde tilde dot) to end the \fBtip\fR session. If you
@@ -116,58 +112,48 @@ type \fB~.\fR (tilde dot), it terminates the rlogin.
.sp
.ne 2
-.mk
.na
\fB\fB~c\fR [\fIname\fR]\fR
.ad
.RS 18n
-.rt
Change directory to \fIname\fR. No argument implies change to your home
directory.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~!\fR\fR
.ad
.RS 18n
-.rt
Escape to an interactive shell on the local machine. Exiting the shell returns
you to \fBtip\fR.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~>\fR\fR
.ad
.RS 18n
-.rt
Copy file from local to remote.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~<\fR\fR
.ad
.RS 18n
-.rt
Copy file from remote to local.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~p\fR\fI from\fR [\fI to \fR]\fR
.ad
.RS 18n
-.rt
Send a file to a remote host running the UNIX system. When you use the put
command, the remote system runs the command string
.sp
@@ -185,12 +171,10 @@ UNIX-system-specific version of the `\fB~>\fR' command.
.sp
.ne 2
-.mk
.na
\fB\fB~t\fR\fI from\fR [\fI to \fR]\fR
.ad
.RS 18n
-.rt
Take a file from a remote host running the UNIX system. As in the put command
the \fIto\fR file defaults to the \fIfrom\fR file name if it is not specified.
The remote host executes the command string
@@ -207,24 +191,20 @@ to send the file to \fBtip\fR.
.sp
.ne 2
-.mk
.na
\fB\fB~|\fR\fR
.ad
.RS 18n
-.rt
Pipe the output from a remote command to a local process. The command string
sent to the local system is processed by the shell.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~C\fR\fR
.ad
.RS 18n
-.rt
Connect a program to the remote machine. The command string sent to the program
is processed by the shell. The program inherits file descriptors 0 as remote
line input, 1 as remote line output, and 2 as tty standard error.
@@ -232,58 +212,48 @@ line input, 1 as remote line output, and 2 as tty standard error.
.sp
.ne 2
-.mk
.na
\fB\fB~$\fR\fR
.ad
.RS 18n
-.rt
Pipe the output from a local process to the remote host. The command string
sent to the local system is processed by the shell.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~#\fR\fR
.ad
.RS 18n
-.rt
Send a \fBBREAK\fR to the remote system.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~s\fR\fR
.ad
.RS 18n
-.rt
Set a variable (see the discussion below).
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~^Z\fR\fR
.ad
.RS 18n
-.rt
Stop \fBtip\fR. Only available when run under a shell that supports job
control, such as the C shell.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~^Y\fR\fR
.ad
.RS 18n
-.rt
Stop only the "local side" of \fBtip\fR. Only available when run under a shell
that supports job control, such as the C shell. The "remote side" of \fBtip\fR,
that is, the side that displays output from the remote host, is left running.
@@ -291,12 +261,10 @@ that is, the side that displays output from the remote host, is left running.
.sp
.ne 2
-.mk
.na
\fB\fB~?\fR\fR
.ad
.RS 18n
-.rt
Get a summary of the tilde escapes.
.RE
@@ -402,12 +370,10 @@ abbreviation may be given. The following list details those variables known to
\fBtip\fR.
.sp
.ne 2
-.mk
.na
\fB\fBbeautify\fR\fR
.ad
.RS 16n
-.rt
(bool) Discard unprintable characters when a session is being scripted;
abbreviated \fBbe\fR. If the \fBnb\fR capability is present, \fBbeautify\fR is
initially set to \fBoff\fR. Otherwise, \fBbeautify\fR is initially set to
@@ -416,12 +382,10 @@ initially set to \fBoff\fR. Otherwise, \fBbeautify\fR is initially set to
.sp
.ne 2
-.mk
.na
\fB\fBbaudrate\fR\fR
.ad
.RS 16n
-.rt
(num) The baud rate at which the connection was established; abbreviated
\fBba\fR. If a baud rate was specified on the command line, \fBbaudrate\fR is
initially set to the specified value. Or, if the \fBbr\fR capability is
@@ -432,12 +396,10 @@ Otherwise, \fBbaudrate\fR is set to 300 baud. Once \fBtip\fR has been started,
.sp
.ne 2
-.mk
.na
\fB\fBdialtimeout\fR\fR
.ad
.RS 16n
-.rt
(num) When dialing a phone number, the time (in seconds) to wait for a
connection to be established; abbreviated \fBdial\fR. \fBdialtimeout\fR is
initially set to 60 seconds, and can only changed by the super-user.
@@ -445,12 +407,10 @@ initially set to 60 seconds, and can only changed by the super-user.
.sp
.ne 2
-.mk
.na
\fB\fBdisconnect\fR\fR
.ad
.RS 16n
-.rt
(str) The string to send to the remote host to disconnect from it; abbreviated
\fBdi\fR. If the \fBdi\fR capability is present, \fBdisconnect\fR is initially
set to the value of that capability. Otherwise, \fBdisconnect\fR is set to a
@@ -459,12 +419,10 @@ null string (\fB""\fR).
.sp
.ne 2
-.mk
.na
\fB\fBechocheck\fR\fR
.ad
.RS 16n
-.rt
(bool) Synchronize with the remote host during file transfer by waiting for the
echo of the last character transmitted; abbreviated \fBec\fR. If the \fBec\fR
capability is present, \fBechocheck\fR is initially set to \fBon\fR. Otherwise,
@@ -473,12 +431,10 @@ capability is present, \fBechocheck\fR is initially set to \fBon\fR. Otherwise,
.sp
.ne 2
-.mk
.na
\fB\fBeofread\fR\fR
.ad
.RS 16n
-.rt
(str) The set of characters which signify an end-of-transmission during a
\fB~<\fR file transfer command; abbreviated \fBeofr\fR. If the \fBie\fR
capability is present, \fBeofread\fR is initially set to the value of that
@@ -487,12 +443,10 @@ capability. Otherwise, \fBeofread\fR is set to a null string (\fB""\fR).
.sp
.ne 2
-.mk
.na
\fB\fBeofwrite\fR\fR
.ad
.RS 16n
-.rt
(str) The string sent to indicate end-of-transmission during a \fB~>\fR file
transfer command; abbreviated \fBeofw\fR. If the \fBoe\fR capability is
present, \fBeofread\fR is initially set to the value of that capability.
@@ -501,12 +455,10 @@ Otherwise, \fBeofread\fR is set to a null string (\fB""\fR).
.sp
.ne 2
-.mk
.na
\fB\fBeol\fR\fR
.ad
.RS 16n
-.rt
(str) The set of characters which indicate an end-of-line. \fBtip\fR will
recognize escape characters only after an end-of-line. If the \fBel\fR
capability is present, \fBeol\fR is initially set to the value of that
@@ -515,12 +467,10 @@ capability. Otherwise, \fBeol\fR is set to a null string (\fB""\fR).
.sp
.ne 2
-.mk
.na
\fB\fBescape\fR\fR
.ad
.RS 16n
-.rt
(char) The command prefix (escape) character; abbreviated \fBes\fR. If the
\fBes\fR capability is present, \fBescape\fR is initially set to the value of
that capability. Otherwise, \fBescape\fR is set to `\fB\|~\|\fR\&'.
@@ -528,12 +478,10 @@ that capability. Otherwise, \fBescape\fR is set to `\fB\|~\|\fR\&'.
.sp
.ne 2
-.mk
.na
\fB\fBetimeout\fR\fR
.ad
.RS 16n
-.rt
(num) The amount of time, in seconds, that \fBtip\fR should wait for the
echo-check response when \fBechocheck\fR is set; abbreviated \fBet\fR. If the
\fBet\fR capability is present, \fBetimeout\fR is initially set to the value of
@@ -542,12 +490,10 @@ that capability. Otherwise, \fBetimeout\fR is set to 10 seconds.
.sp
.ne 2
-.mk
.na
\fB\fBexceptions\fR\fR
.ad
.RS 16n
-.rt
(str) The set of characters which should not be discarded due to the
beautification switch; abbreviated \fBex\fR. If the \fBex\fR capability is
present, \fBexceptions\fR is initially set to the value of that capability.
@@ -556,12 +502,10 @@ Otherwise, \fBexceptions\fR is set to `\fB\et\en\ef\eb\fR\&'.
.sp
.ne 2
-.mk
.na
\fB\fBforce\fR\fR
.ad
.RS 16n
-.rt
(char) The character used to force literal data transmission; abbreviated
\fBfo\fR. If the \fBfo\fR capability is present, \fBforce\fR is initially set
to the value of that capability. Otherwise, \fBforce\fR is set to \fB\e377\fR
@@ -570,12 +514,10 @@ to the value of that capability. Otherwise, \fBforce\fR is set to \fB\e377\fR
.sp
.ne 2
-.mk
.na
\fB\fBframesize\fR\fR
.ad
.RS 16n
-.rt
(num) The amount of data (in bytes) to buffer between file system writes when
receiving files; abbreviated \fBfr\fR. If the \fBfs\fR capability is present,
\fBframesize\fR is initially set to the value of that capability. Otherwise,
@@ -584,12 +526,10 @@ receiving files; abbreviated \fBfr\fR. If the \fBfs\fR capability is present,
.sp
.ne 2
-.mk
.na
\fB\fBhalfduplex\fR\fR
.ad
.RS 16n
-.rt
(bool) Do local echoing because the host is half-duplex; abbreviated \fBhdx\fR.
If the \fBhd\fR capability is present, \fBhalfduplex\fR is initially set to
\fBon\fR. Otherwise, \fBhalfduplex\fR is initially set to \fBoff\fR.
@@ -597,12 +537,10 @@ If the \fBhd\fR capability is present, \fBhalfduplex\fR is initially set to
.sp
.ne 2
-.mk
.na
\fB\fBhardwareflow\fR\fR
.ad
.RS 16n
-.rt
(bool) Do hardware flow control; abbreviated \fBhf\fR. If the \fBhf\fR
capability is present, \fBhardwareflow\fR is initially set to \fBon\fR.
Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR.
@@ -610,12 +548,10 @@ Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR.
.sp
.ne 2
-.mk
.na
\fB\fBhost\fR\fR
.ad
.RS 16n
-.rt
(str) The name of the host to which you are connected; abbreviated \fBho\fR.
\fBhost\fR is permanently set to the name given on the command line or in the
\fBHOST\fR environment variable.
@@ -623,23 +559,19 @@ Otherwise, \fBhardwareflowcontrol\fR is initially set to \fBoff\fR.
.sp
.ne 2
-.mk
.na
\fB\fBlocalecho\fR\fR
.ad
.RS 16n
-.rt
(bool) A synonym for \fBhalfduplex\fR; abbreviated \fBle\fR.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBlog\fR\fR
.ad
.RS 16n
-.rt
(str) The name of the file to which to log information about outgoing phone
calls. \fBlog\fR is initially set to \fB/var/adm/aculog\fR, and can only be
inspected or changed by the super-user.
@@ -647,17 +579,14 @@ inspected or changed by the super-user.
.sp
.ne 2
-.mk
.na
\fB\fBparity\fR\fR
.ad
.RS 16n
-.rt
(str) The parity to be generated and checked when talking to the remote host;
abbreviated \fBpar\fR. The possible values are:
.sp
.ne 2
-.mk
.na
\fB\fBnone\fR>\fR
.ad
@@ -666,40 +595,33 @@ abbreviated \fBpar\fR. The possible values are:
\fB\fBzero\fR\fR
.ad
.RS 9n
-.rt
Parity is not checked on input, and the parity bit is set to zero on output.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBone\fR\fR
.ad
.RS 9n
-.rt
Parity is not checked on input, and the parity bit is set to one on output.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBeven\fR\fR
.ad
.RS 9n
-.rt
Even parity is checked for on input and generated on output.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBodd\fR\fR
.ad
.RS 9n
-.rt
Odd parity is checked for on input and generated on output.
.RE
@@ -709,12 +631,10 @@ value of that capability; otherwise, \fBparity\fR is set to \fBnone\fR.
.sp
.ne 2
-.mk
.na
\fB\fBphones\fR\fR
.ad
.RS 16n
-.rt
The file in which to find hidden phone numbers. If the environment variable
\fBPHONES\fR is set, \fBphones\fR is set to the value of \fBPHONES\fR.
Otherwise, \fBphones\fR is set to \fB/etc/phones\fR. The value of \fBphones\fR
@@ -723,12 +643,10 @@ cannot be changed from within \fBtip\fR.
.sp
.ne 2
-.mk
.na
\fB\fBprompt\fR\fR
.ad
.RS 16n
-.rt
(char) The character which indicates an end-of-line on the remote host;
abbreviated \fBpr\fR. This value is used to synchronize during data transfers.
The count of lines transferred during a file transfer command is based on
@@ -739,12 +657,10 @@ set to \fB\en\fR\&.
.sp
.ne 2
-.mk
.na
\fB\fBraise\fR\fR
.ad
.RS 16n
-.rt
(bool) Upper case mapping mode; abbreviated \fBra\fR. When this mode is
enabled, all lower case letters will be mapped to upper case by \fBtip\fR for
transmission to the remote machine. If the \fBra\fR capability is present,
@@ -754,12 +670,10 @@ set to \fBoff\fR.
.sp
.ne 2
-.mk
.na
\fB\fBraisechar\fR\fR
.ad
.RS 16n
-.rt
(char) The input character used to toggle upper case mapping mode; abbreviated
\fBrc\fR. If the \fBrc\fR capability is present, \fBraisechar\fR is initially
set to the value of that capability. Otherwise, \fBraisechar\fR is set to
@@ -768,12 +682,10 @@ set to the value of that capability. Otherwise, \fBraisechar\fR is set to
.sp
.ne 2
-.mk
.na
\fB\fBrawftp\fR\fR
.ad
.RS 16n
-.rt
(bool) Send all characters during file transfers; do not filter non-printable
characters, and do not do translations like \fB\en\fR to \fB\er\fR\&.
Abbreviated \fBraw\fR. If the \fBrw\fR capability is present, \fBrawftp\fR is
@@ -783,12 +695,10 @@ initially set to \fBon\fR. Otherwise, \fBrawftp\fR is initially set to
.sp
.ne 2
-.mk
.na
\fB\fBrecord\fR\fR
.ad
.RS 16n
-.rt
(str) The name of the file in which a session script is recorded; abbreviated
\fBrec\fR. If the \fBre\fR capability is present, \fBrecord\fR is initially set
to the value of that capability. Otherwise, \fBrecord\fR is set to
@@ -797,12 +707,10 @@ to the value of that capability. Otherwise, \fBrecord\fR is set to
.sp
.ne 2
-.mk
.na
\fB\fBremote\fR\fR
.ad
.RS 16n
-.rt
The file in which to find descriptions of remote systems. If the environment
variable \fBREMOTE\fR is set, \fBremote\fR is set to the value of \fBREMOTE\fR.
Otherwise, \fBremote\fR is set to \fB/etc/remote\fR. The value of \fBremote\fR
@@ -811,12 +719,10 @@ cannot be changed from within \fBtip\fR.
.sp
.ne 2
-.mk
.na
\fB\fBscript\fR\fR
.ad
.RS 16n
-.rt
(bool) Session scripting mode; abbreviated \fBsc\fR. When \fBscript\fR is
\fBon\fR, \fBtip\fR will record everything transmitted by the remote machine in
the script record file specified in \fBrecord\fR. If the \fBbeautify\fR switch
@@ -829,12 +735,10 @@ rules. If the \fBsc\fR capability is present, \fBscript\fR is initially set to
.sp
.ne 2
-.mk
.na
\fB\fBtabexpand\fR\fR
.ad
.RS 16n
-.rt
(bool) Expand \fBTAB\fR characters to \fBSPACE\fR characters during file
transfers; abbreviated \fBtab\fR. When \fBtabexpand\fR is \fBon\fR, each tab
is expanded to eight SPACE characters. If the \fBtb\fR capability is present,
@@ -844,12 +748,10 @@ initially set to \fBoff\fR.
.sp
.ne 2
-.mk
.na
\fB\fBtandem\fR\fR
.ad
.RS 16n
-.rt
(bool) Use \fBXON\fR/\fBXOFF\fR flow control to limit the rate that data is
sent by the remote host; abbreviated \fBta\fR. If the \fBnt\fR capability is
present, \fBtandem\fR is initially set to \fBoff\fR. Otherwise, \fBtandem\fR is
@@ -858,12 +760,10 @@ initially set to \fBon\fR.
.sp
.ne 2
-.mk
.na
\fB\fBverbose\fR\fR
.ad
.RS 16n
-.rt
(bool) Verbose mode; abbreviated \fBverb\fR; When verbose mode is enabled,
\fBtip\fR prints messages while dialing, shows the current number of lines
transferred during a file transfer operations, and more. If the \fBnv\fR
@@ -873,24 +773,20 @@ capability is present, \fBverbose\fR is initially set to \fBoff\fR. Otherwise,
.sp
.ne 2
-.mk
.na
\fB\fBSHELL\fR\fR
.ad
.RS 16n
-.rt
(str) The name of the shell to use for the \fB~!\fR command; default value is
\fB/bin/sh\fR, or taken from the environment.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBHOME\fR\fR
.ad
.RS 16n
-.rt
(str) The home directory to use for the \fB~c\fR command. Default value is
taken from the environment.
.RE
@@ -932,7 +828,7 @@ monet% ~|Local command: pr h sylvester.c | lpr
List command for remote host: cat sylvester.c
monet% ~^D
[EOT]
-\&...(back on the local system)...
+\&...(back on the local system)...
.fi
.in -2
.sp
@@ -943,112 +839,92 @@ monet% ~^D
The following environment variables are read by \fBtip\fR.
.sp
.ne 2
-.mk
.na
\fB\fBREMOTE\fR\fR
.ad
.RS 10n
-.rt
The location of the \fBremote\fR file.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBPHONES\fR\fR
.ad
.RS 10n
-.rt
The location of the file containing private phone numbers.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBHOST\fR\fR
.ad
.RS 10n
-.rt
A default host to connect to.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBHOME\fR\fR
.ad
.RS 10n
-.rt
One's log-in directory (for chdirs).
.RE
.sp
.ne 2
-.mk
.na
\fB\fBSHELL\fR\fR
.ad
.RS 10n
-.rt
The shell to fork on a `\fB~!\fR' escape.
.RE
.SH FILES
.sp
.ne 2
-.mk
.na
\fB\fB/etc/phones\fR\fR
.ad
.RS 29n
-.rt
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/etc/remote\fR\fR
.ad
.RS 29n
-.rt
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/var/spool/locks/LCK.\|.*\fR\fR
.ad
.RS 29n
-.rt
lock file to avoid conflicts with \fBUUCP\fR
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/var/adm/aculog\fR\fR
.ad
.RS 29n
-.rt
file in which outgoing calls are logged
.RE
.sp
.ne 2
-.mk
.na
\fB\fB~/.tiprc\fR\fR
.ad
.RS 29n
-.rt
initialization file
.RE