This is an old revision of the document!
Executables winscp.exe and winscp.com
WinSCP has two executables:
winscp.exe
: Main executable, supports both GUI and console operation;winscp.com
: Console interface tool, supports console operation only, allows input/output redirection.
Advertisement
This follows two basic executable types of Windows operation system, GUI and console.
Both executables are part of the installation package. Both are as well available for portable use.
winscp.exe
The .exe
executable is the main one.
What you can do with it:
- When run, it starts by default in GUI mode, showing the Login dialog;
- Using the command-line options, it can be started in console mode;
- It can be used to execute scripts without showing any window (by omitting
/console
parameter).
winscp.com
The .com
executable is a simple tool that internally runs winscp.exe
and provides console interface for it. It’s primary purpose is scripting.
What you can do with it:
- Supports console mode only, but allows input/output redirection;
- When run from Windows shell (i.e.
cmd.exe
or batch file), the shell waits for WinSCP to finish. So you can then check for WinSCP exit code; - When run from another console application (such as standard Windows console/command-line window, i.e.
cmd.exe
), it inherits its console1.
The .com
executable needs the .exe
one to operate. It looks for it in the same directory where it is located itself. The .exe
must have exactly the same name.
Advertisement
Input/Output Redirection
For input/output redirection use standard operators:
>
for output redirection;<
for input redirection;|
for piping.
You can also use input/output redirection when running ’winscp.com
from another application. For example see Guide to SFTP transfers in .NET.
winscp.exe /console
would pop up in new console window.Back