![](/uploads/1/2/5/2/125276710/318410207.jpg)
To check whether or not an RS-232 serial port is working, perform an RS-232 loopback test by doing the following:
Jump to Standard command-line options - In this mode, text typed into the PuTTY window will be sent straight out of your computer's serial port, and data received through that port will be displayed in the PuTTY window. You might use this mode, for example, if your serial port is connected to another computer which has a serial connection.
- If your serial port is not female, convert it by taking a female/female cable or gender changer and plugging it into the serial port.
- Take a metal paperclip or wire and cross pins 2 and 3. If you look closely at the female end, the pins should be numbered.
- Open a telnet session on the COM port number of the device that you are testing. To find out the COM port number, refer to the following FAQ: https://www.startech.com/faq/com-port-listing-windows.
Note: To open a telnet session on the COM port, you need a telnet client like PuTTY or Hyper Terminal. Windows XP comes with Hyper Terminal.
- When the session is open, anything you type into it you should see. The loopback test fails when you cannot see what you are typing.
If the loopback test fails, make sure that the serial cable or gender changer that you are using works and that the adapter is in the correct port.
You can check multiple ports at the same time by opening multiple sessions, putting the loopback adapter on one port, and trying to type into each session. When you can see what you are typing, you know that the COM port is working and you can see which port number the physical serial port is. Close the window for the port that you just tested to speed up the testing of the remaining serial ports.
For products related to this article, click here.
Previous | Contents | Index | Next
- Chapter 7: Using the command-line connection tool Plink
- 7.2 Using Plink
Plink is a command-line connection tool similar to UNIX
ssh
. It is mostly used for automated operations, such as making CVS access a repository on a remote server. Plink is probably not what you want if you want to run an interactive session in a console window.
7.1 Starting Plink
![Serial Serial](/uploads/1/2/5/2/125276710/598883923.png)
Plink is a command line application. This means that you cannot just double-click on its icon to run it and instead you have to bring up a console window. In Windows 95, 98, and ME, this is called an ‘MS-DOS Prompt’, and in Windows NT, 2000, and XP, it is called a ‘Command Prompt’. It should be available from the Programs section of your Start Menu.
In order to use Plink, the file
plink.exe
will need either to be on your PATH
or in your current directory. To add the directory containing Plink to your PATH
environment variable, type into the console window: This will only work for the lifetime of that particular console window. To set your
PATH
more permanently on Windows NT, 2000, and XP, use the Environment tab of the System Control Panel. On Windows 95, 98, and ME, you will need to edit your AUTOEXEC.BAT
to include a set
command like the one above. 7.2 Using Plink
This section describes the basics of how to use Plink for interactive logins and for automated processes.
Once you've got a console window to type into, you can just type
plink
on its own to bring up a usage message. This tells you the version of Plink you're using, and gives you a brief summary of how to use Plink: Once this works, you are ready to use Plink.
7.2.1 Using Plink for interactive logins
To make a simple interactive connection to a remote server, just type
plink
and then the host name: You should then be able to log in as normal and run a session. The output sent by the server will be written straight to your command prompt window, which will most likely not interpret terminal control codes in the way the server expects it to. So if you run any full-screen applications, for example, you can expect to see strange characters appearing in your window. Interactive connections like this are not the main point of Plink.
In order to connect with a different protocol, you can give the command line options
-ssh
, -telnet
, -rlogin
or -raw
. To make an SSH connection, for example: If you have already set up a PuTTY saved session, then instead of supplying a host name, you can give the saved session name. This allows you to use public-key authentication, specify a user name, and use most of the other features of PuTTY:
(You can also use the
-load
command-line option to load a saved session; see section 3.8.3.1. If you use -load
, the saved session exists, and it specifies a hostname, you cannot also specify a host
or user@host
argument - it will be treated as part of the remote command.) 7.2.2 Using Plink for automated connections
More typically Plink is used with the SSH protocol, to enable you to talk directly to a program running on the server. To do this you have to ensure Plink is using the SSH protocol. You can do this in several ways:
- Use the
-ssh
option as described in section 7.2.1. - Set up a PuTTY saved session that describes the server you are connecting to, and that also specifies the protocol as SSH.
- Set the Windows environment variable
PLINK_PROTOCOL
to the wordssh
.
Usually Plink is not invoked directly by a user, but run automatically by another process. Therefore you typically do not want Plink to prompt you for a user name or a password.
Next, you are likely to need to avoid the various interactive prompts Plink can produce. You might be prompted to verify the host key of the server you're connecting to, to enter a user name, or to enter a password.
To avoid being prompted for the server host key when using Plink for an automated connection, you should first make a manual connection (using either of PuTTY or Plink) to the same server, verify the host key (see section 2.2 for more information), and select Yes to add the host key to the Registry. After that, Plink commands connecting to that server should not give a host key prompt unless the host key changes.
To avoid being prompted for a user name, you can:
- Use the
-l
option to specify a user name on the command line. For example,plink login.example.com -l fred
. - Set up a PuTTY saved session that describes the server you are connecting to, and that also specifies the username to log in as (see section 4.14.1).
To avoid being prompted for a password, you should almost certainly set up public-key authentication. (See chapter 8 for a general introduction to public-key authentication.) Again, you can do this in two ways:
- Set up a PuTTY saved session that describes the server you are connecting to, and that also specifies a private key file (see section 4.22.8). For this to work without prompting, your private key will need to have no passphrase.
- Store the private key in Pageant. See chapter 9 for further information.
Once you have done all this, you should be able to run a remote command on the SSH server machine and have it execute automatically with no prompting:
Or, if you have set up a saved session with all the connection details:
Then you can set up other programs to run this Plink command and talk to it as if it were a process on the server machine.
7.2.3 Plink command line options
Plink accepts all the general command line options supported by the PuTTY tools. See section 3.8.3 for a description of these options.
Plink also supports some of its own options. The following sections describe Plink's specific command-line options.
7.2.3.1 -batch
: disable all interactive prompts
If you use the
-batch
option, Plink will never give an interactive prompt while establishing the connection. If the server's host key is invalid, for example (see section 2.2), then the connection will simply be abandoned instead of asking you what to do next. This may help Plink's behaviour when it is used in automated scripts: using
-batch
, if something goes wrong at connection time, the batch job will fail rather than hang. 7.2.3.2 -s
: remote command is SSH subsystem
If you specify the
-s
option, Plink passes the specified command as the name of an SSH ‘subsystem’ rather than an ordinary command line. (This option is only meaningful with the SSH-2 protocol.)
7.2.3.3 -shareexists
: test for connection-sharing upstream
This option does not make a new connection; instead it allows testing for the presence of an existing connection that can be shared. (See section 4.18.5 for more information about SSH connection sharing.)
A Plink invocation of the form:
will test whether there is currently a viable ‘upstream’ for the session in question, which can be specified using any syntax you'd normally use with Plink to make an actual connection (a host/port number, a bare saved session name,
-load
, etc). It returns a zero exit status if a usable ‘upstream’ exists, nonzero otherwise. (This option is only meaningful with the SSH-2 protocol.)
7.3 Using Plink in batch files and scripts
![Putty Putty](/uploads/1/2/5/2/125276710/685978883.jpg)
Once you have set up Plink to be able to log in to a remote server without any interactive prompting (see section 7.2.2), you can use it for lots of scripting and batch purposes. For example, to start a backup on a remote machine, you might use a command like:
Or perhaps you want to fetch all system log lines relating to a particular web area:
Any non-interactive command you could usefully run on the server command line, you can run in a batch file using Plink in this way.
7.4 Using Plink with CVS
To use Plink with CVS, you need to set the environment variable
CVS_RSH
to point to Plink: You also need to arrange to be able to connect to a remote host without any interactive prompts, as described in section 7.2.2.
You should then be able to run CVS as follows:
If you specified a username in your saved session, you don't even need to specify the ‘user’ part of this, and you can just say:
7.5 Using Plink with WinCVS
Plink can also be used with WinCVS. Firstly, arrange for Plink to be able to connect to a remote host non-interactively, as described in section 7.2.2.
Then, in WinCVS, bring up the ‘Preferences’ dialogue box from the Admin menu, and switch to the ‘Ports’ tab. Tick the box there labelled ‘Check for an alternate
rsh
name’ and in the text entry field to the right enter the full path to plink.exe
. Select ‘OK’ on the ‘Preferences’ dialogue box. Next, select ‘Command Line’ from the WinCVS ‘Admin’ menu, and type a CVS command as in section 7.4, for example:
or (if you're using a saved session):
Select the folder you want to check out to with the ‘Change Folder’ button, and click ‘OK’ to check out your module. Once you've got modules checked out, WinCVS will happily invoke plink from the GUI for CVS operations.
If you want to provide feedback on this manual or on the PuTTY tools themselves, see the Feedback page.
[PuTTY release 0.68]![](/uploads/1/2/5/2/125276710/318410207.jpg)