1 \versionid: $Id: plink.but,v 1.2 2001/02/04 15:47:01 owen Exp $
3 \C{plink} Using the command-line connection tool Plink
7 \# Explain that Plink is probably not what you want if you want to
8 \# run an interactive session in a Command Prompt window
10 \# Explain that Plink is really for batch-file use, and that
11 \# therefore it works best with public-key authentication; link to
14 \# Give instructions on how to set up Plink with CVS
16 Plink (PuTTY Link), is a command-line connection tool similar to UNIX
17 \c{ssh}. It is probably not what you want if you want to run an
18 interactive session in a console window.
20 \H{plink-starting} Starting Plink
22 Plink is a command line application. This means that you cannot just
23 double-click on its icon to run it and instead you have to bring up a
24 \i{console window}. With Windows 95, 98, and ME, this is called an
25 \q{MS-DOS Prompt} and with Windows NT and 2000 it is called a
26 \q{Command Prompt}. It should be available from the Programs section
29 To start Plink it will need either to be on your \i{\c{PATH}} or in your
30 current directory. To add the directory containing Plink to your
31 \c{PATH} environment variable, type into the console window:
33 \c set PATH C:\path\to\putty\directory;%PATH%
35 This will only work for the lifetime of that particular console
36 window. To set your \c{PATH} more permanently on Windows NT, use the
37 Environment tab of the System Control Panel. On Windows 95, 98, and
38 ME, you will need to edit your \c{AUTOEXEC.BAT} to include a \c{set}
39 command like the one above.
41 \H{plink-usage} Plink Usage
43 Once you've got a console window to type into, you can just type
44 \c{plink} on its own to bring up a usage message. This tells you the
45 version of Plink you're using, and gives you a brief summary of how to
49 \c PuTTY Link: command-line connection utility
51 \c Usage: plink [options] [user@]host [command]
53 \c -v show verbose messages
54 \c -ssh force use of ssh protocol
55 \c -P port connect to specified port
56 \c -pw passw login with specified password
58 \S{plink-usage-basics} The basics
60 \S{plink-usage-options} Options
62 These are the command line options that Plink accepts.
64 \H{plink-pubkey} Public key authentication
66 \H{plink-batch} Using Plink in batch files and scripts
68 \H{plink-cvs} Using Plink with CVS
70 \H{plink-whatelse} Using Plink with... ?