src/usr.bin/tip/tip.1 - diff

Return to tip.1 CVS log

Up to [local] / src / usr.bin / tip

Diff for /src/usr.bin/tip/Attic/tip.1 between version 1.34 and 1.35

version 1.34, 2005/04/08 19:29:12

version 1.35, 2006/05/25 08:41:52

Line 34

.Dt TIP 1

.Os

.Sh NAME

.Nm tip ,

.Nm tip

.Nm cu

.Nd connect to a remote system

.Sh SYNOPSIS

.Nm tip

.Nm

.Op Fl nv

.Op Fl Ar speed

.Op Ar system\-name

.Op Ar system-name

.Nm cu

.Op Fl ehot

.Op Fl a Ar acu

.Op Fl l Ar line

.Op Fl s Ar speed

.Op Fl #

.Op Ar phone\-number

.Sh DESCRIPTION

.Nm

and

establishes a full-duplex connection to another machine, giving the

.Nm cu

establish a full-duplex connection to another machine, giving the

appearance of being logged in directly on the remote CPU.

It goes without saying that you must have a login on the machine (or

equivalent) to which you wish to connect.

The preferred interface is

.Nm tip .

The

.Nm cu

interface is included for those people attached to the

``call

.Ux Ns ''

command of

.At v7 .

This manual page

describes only

.Nm tip .

.Pp

The options are as follows:

.Bl -tag -width 4n

.It Fl a Ar acu

Set the acu.

.It Fl e

For

.Nm cu ,

use even parity.

.It Fl h

For

.Nm cu ,

echo characters locally (half-duplex mode).

.It Fl l Ar line

For

.Nm cu ,

specify the line to use.

Either of the forms like

.Pa tty00

.Pa /dev/tty00

are permitted.

.It Fl n

No escape (disable tilde).

.It Fl o

For

.Nm cu ,

use odd parity.

.It Fl s Ar speed

For

.Nm cu ,

set the speed of the connection.

Defaults to 9600.

.It Fl t

For

.Nm cu ,

connect via a hard-wired connection to a host on a dial-up line.

.It Fl v

Set verbose mode.

.El

.Pp

For

.Nm cu ,

if both

.Fl e

and

.Fl o

are given, then no parity is used.

This is the default behaviour.

.Pp

.Ar speed

is specified it will override any baudrate specified in the system

is specified, it will override any baudrate specified in the system

description being used.

.Pp

If neither

Line 143

Line 80

will be set to a value of 'tip' with

.Ar speed

appended.

e.g.\&

For example,

.Ic tip -1200

will set

.Ar system-name

Line 156

Line 93

appearing as the first character of a line is an escape signal; the

following are recognized:

.Bl -tag -offset indent -width Fl

.It Ic \&~^D No or Ic \&~.

.It Ic ~^D No or Ic ~.

Drop the connection and exit (you may still be logged in on the remote

Drop the connection and exit.

machine).

Only the connection is dropped \(en the login session is not terminated.

.It Ic \&~c Op Ar name

.It Ic ~c Op Ar name

Change directory to

.Ar name

(no argument implies change to your home directory).

(no argument implies change to home directory).

.It Ic \&~!

.It Ic ~!

Escape to a shell (exiting the shell will return you to

Escape to a shell (exiting the shell will return to

.Nm tip ) .

.Nm ) .

.It Ic \&~>

.It Ic ~\*(Gt

Copy file from local to remote.

.Nm

prompts for the name of a local file to transmit.

.It Ic \&~<

.It Ic ~\*(Lt

Copy file from remote to local.

.Nm

prompts first for the name of the file to be sent, then for a command

to be executed on the remote machine.

.It Ic \&~p Ar from Op Ar to

.It Ic ~p Ar from Op Ar to

Send a file to a remote

.Ux

host.

The put command causes the remote

This command causes the remote

.Ux

system to run the command string

system to run the following command string,

.Ic cat > 'to' ,

sending it the

while

.Sq from

.Nm

file:

sends it the

.Bd -literal -offset indent

.Dq from

stty -echo; cat \*(Gt 'to'; stty echo

file.

.Ed

.Pp

If the

.Dq to

.Sq to

file isn't specified the

file isn't specified, the

.Dq from

.Sq from

file name is used.

This command is actually a

.Ux

specific version of the

.Ic ~>

.Ic ~\*(Gt

command.

.It Ic \&~t Ar from Op Ar to

.It Ic ~t Ar from Op Ar to

Take a file from a remote

.Ux

host.

As in the put command the

As in the

.Dq to

.Ic ~p

command, the

.Sq to

file defaults to the

.Dq from

.Sq from

file name if it isn't specified.

The remote host executes the command string

The remote host executes the following command string

.Ic cat 'from';echo ''|tr '\e012' '\e01'

to send the file to

.Nm tip .

.Nm :

.It Ic \&~|

.Bd -literal -offset indent

cat 'from'; echo '' | tr '\e012' '\e01'

.Ed

.It Ic ~|

Pipe the output from a remote command to a local

.Ux

process.

The command string sent to the local

.Ux

system is processed by the shell.

.It Ic \&~$

.It Ic ~$

Pipe the output from a local

.Ux

process to the remote host.

The command string sent to the local

.Ux

system is processed by the shell.

.It Ic \&~C

.It Ic ~C

Fork a child process on the local system to perform special protocols

such as \s-1XMODEM\s+1.

The child program will be run with the following arrangement of

file descriptors:

.Bd -literal -offset indent

0 <-> remote tty in

0 \*(Lt-\*(Gt remote tty in

1 <-> remote tty out

1 \*(Lt-\*(Gt remote tty out

2 <-> local tty stderr

2 \*(Lt-\*(Gt local tty stderr

.Ed

.It Ic \&~#

.It Ic ~#

Send a

.Dv BREAK

to the remote system.

For systems which don't support the necessary

.Fn ioctl

call the break is simulated by a sequence of line speed changes and

call, the break is simulated by a sequence of line speed changes and

DEL characters.

.It Ic \&~s

.It Ic ~s

Set a variable (see the discussion below).

.It Ic \&~v

.It Ic ~v

List all variables and their values (if set).

.It Ic \&~^Z

.It Ic ~^Z

Stop

.Nm

(only available with job control).

.It Ic \&~^Y

.It Ic ~^Y

Stop only the

.Dq local side

Line 259

Line 201

(only available with job control); the

.Dq remote side

.Nm tip ,

.Nm ,

the side that displays output from the remote host, is left running.

.It Ic \&~?

.It Ic ~?

Get a summary of the tilde escapes.

.El

.Pp

To find the system description and thus the operating characteristics

To find the system description, and thus the operating characteristics

.Ar system-name ,

.Nm

Line 277

Line 219

If the environment variable

.Ev REMOTE

does not start with a

.Ql \&/

.Ql /

it is assumed to be a system description, and is considered first.

.It

If the environment variable

.Ev REMOTE

begins with a

.Ql \&/

.Ql /

it is assumed to be a path to a

.Xr remote 5

database, and the specified database is searched.

Line 304

Line 246

capability is used in system descriptions to specify the baud rate

with which to establish a connection.

If the value specified is not suitable, the baud rate to be used may

be given on the command line, e.g.,

be given on the command line, e.g.\&

.Ql "tip -300 mds" .

.Ql tip -300 mds .

.Pp

When

.Nm

establishes a connection it sends out the connection message

establishes a connection, it sends out the connection message

specified in the

.Ar cm

capability of the system description being used.

.Pp

When

.Nm

prompts for an argument (e.g., during setup of a file transfer) the

prompts for an argument, for example during setup of a file transfer, the

line typed may be edited with the standard erase and kill characters.

A null line in response to a prompt, or an interrupt, will abort the

dialogue and return you to the remote machine.

dialogue and return the user to the remote machine.

.Pp

.Nm

guards against multiple users connecting to a remote system by opening

Line 331

Line 273

.Nm

provides a running count of the number of lines transferred.

When using the

.Ic ~>

.Ic ~\*(Gt

and

.Ic ~<

.Ic ~\*(Lt

commands, the

.Dq eofread

and

Line 408

Line 350

Variables may be initialized at run time by placing set commands

(without the

.Ql ~s

prefix in a file

prefix) in a file,

.Pa .tiprc

.Pa .tiprc ,

in one's home directory).

in one's home directory.

The

.Fl v

option causes

Line 420

Line 362

The following is a list of common variables, their abbreviations, and

their default values:

.Bl -tag -width Ar

.It Ar beautify

(bool) Discard unprintable characters when a session is being

scripted; abbreviated

.Ar be .

.It Ar baudrate

(num) The baud rate at which the connection was established;

abbreviated

.Ar ba .

.It Ar beautify

(bool) Discard unprintable characters when a session is being

scripted; abbreviated

.Ar be .

.It Ar dialtimeout

(num) When dialing a phone number, the time (in seconds) to wait for a

connection to be established; abbreviated

Line 439

Line 381

.It Ar eofread

(str) The set of characters which signify an end-of-transmission

during a

.Ic ~<

.Ic ~\*(Lt

file transfer command; abbreviated

.Ar eofr .

.It Ar eofwrite

(str) The string sent to indicate end-of-transmission during a

.Ic ~>

.Ic ~\*(Gt

file transfer command; abbreviated

.Ar eofw .

.It Ar eol

Line 564

Line 506

.El

.Sh ENVIRONMENT

.Bl -tag -width Fl

.It Ev SHELL

The name of the shell to use for the

.Ic ~!\&

command; default value is

.Dq /bin/sh .

.It Ev HOME

The home directory to use for the

.Ic ~c

Line 577

Line 514

The default value for

.Ar system-name

if none is specified via the command line.

.It Ev REMOTE

A system description, or an absolute path to a

.Xr remote 5

system description database.

.It Ev PHONES

A path to a

.Xr phones 5

database.

.It Ev REMOTE

A system description, or an absolute path to a

.Xr remote 5

system description database.

.It Ev SHELL

The name of the shell to use for the

.Ic ~!\&

command; default value is

.Dq /bin/sh .

.El

.Sh FILES

.Bl -tag -width "/var/spool/lock/LCK..*" -compact

.It Pa /etc/remote

global

.Xr remote 5

database

.It Pa /etc/phones

default

.Xr phones 5

file

.It Pa ~/.tiprc

initialization file

.It Pa tip.record

record file

.It Pa /etc/phones

default

.Xr phones 5

file

.It Pa /etc/remote

global

.Xr remote 5

database

.It Pa /var/log/aculog

line access log

.It Pa /var/spool/lock/LCK..*

Line 607

Line 549

.Xr uucp

.El

.Sh SEE ALSO

.Xr cu 1 ,

.Xr phones 5 ,

.Xr remote 5

.Sh HISTORY