## NAME

plink - PuTTY link, command line network connection tool

## SYNOPSIS

    plink [options] [user@]host [command]

## DESCRIPTION

plink is a network connection tool supporting several protocols.

## OPTIONS

The command-line options supported by plink are:

\fB-V\fP

Show version information and exit.

\fB-pgpfp\fP

Display the fingerprints of the PuTTY PGP Master Keys and exit, to aid in verifying new files released by the PuTTY team.

\fB-v\fP

Show verbose messages.

\fB-load\fP \fIsession\fP

Load settings from saved session.

\fB-ssh\fP

Force use of SSH protocol (default).

\fB-telnet\fP

Force use of Telnet protocol.

\fB-rlogin\fP

Force use of rlogin protocol.

\fB-raw\fP

Force raw mode.

\fB-serial\fP

Force serial mode.

\fB-P\fP \fIport\fP

Connect to port port.

\fB-l\fP \fIuser\fP

Set remote username to user.

\fB-m\fP \fIpath\fP

Read remote command(s) from local file path.

\fB-batch\fP

Disable interactive prompts.

\fB-pw\fP \fIpassword\fP

Set remote password to password. CAUTION: this will likely make the password visible to other users of the local machine (via commands such as `w').

\fB-L\fP \fB[\fP\fIsrcaddr\fP\fB:]\fP\fIsrcport\fP\fB:\fP\fIdesthost\fP\fB:\fP\fIdestport\fP

Set up a local port forwarding: listen on srcport (or srcaddr:srcport if specified), and forward any connections over the SSH connection to the destination address desthost:destport. Only works in SSH.

\fB-R\fP \fB[\fP\fIsrcaddr\fP\fB:]\fP\fIsrcport\fP\fB:\fP\fIdesthost\fP\fB:\fP\fIdestport\fP

Set up a remote port forwarding: ask the SSH server to listen on srcport (or srcaddr:srcport if specified), and to forward any connections back over the SSH connection where the client will pass them on to the destination address desthost:destport. Only works in SSH.

\fB-D\fP [\fIsrcaddr\fP:]\fIsrcport\fP

Set up dynamic port forwarding. The client listens on srcport (or srcaddr:srcport if specified), and implements a SOCKS server. So you can point SOCKS-aware applications at this port and they will automatically use the SSH connection to tunnel all their connections. Only works in SSH.

\fB-X\fP

Enable X11 forwarding.

\fB-x\fP

Disable X11 forwarding (default).

\fB-A\fP

Enable agent forwarding.

\fB-a\fP

Disable agent forwarding (default).

\fB-t\fP

Enable pty allocation (default if a command is NOT specified).

\fB-T\fP

Disable pty allocation (default if a command is specified).

\fB-1\fP

Force use of SSH protocol version 1.

\fB-2\fP

Force use of SSH protocol version 2.

\fB-C\fP

Enable SSH compression.

\fB-i\fP \fIpath\fP

Private key file for authentication.

\fB-s\fP

Remote command is SSH subsystem (SSH-2 only).

\fB-N\fP

Don't start a remote command or shell at all (SSH-2 only).

\fB-sercfg\fP \fIconfiguration-string\fP

Specify the configuration parameters for the serial port, in -serial mode. configuration-string should be a comma-separated list of configuration parameters as follows:

\fB\(bu\fP

Any single digit from 5 to 9 sets the number of data bits.

\fB\(bu\fP

`1', `1.5' or `2' sets the number of stop bits.

\fB\(bu\fP

Any other numeric string is interpreted as a baud rate.

\fB\(bu\fP

A single lower-case letter specifies the parity: `n' for none, `o' for odd, `e' for even, `m' for mark and `s' for space.

\fB\(bu\fP

A single upper-case letter specifies the flow control: `N' for none, `X' for XON/XOFF, `R' for RTS/CTS and `D' for DSR/DTR.

## MORE INFORMATION

For more information on plink, it's probably best to go and look at the manual on the PuTTY web page:

http://www.chiark.greenend.org.uk/~sgtatham/putty/

## BUGS

This man page isn't terribly complete. See the above web link for better documentation.