executables » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| executables 2009-04-17 | executables 2024-03-23 (current) | ||
| Line 2: | Line 2: | ||
| ====== Executables winscp.exe and winscp.com ====== | ====== Executables winscp.exe and winscp.com ====== | ||
| WinSCP has two executables: | WinSCP has two executables: | ||
| - | * ''[[executables#winscp.exe|winscp.exe]]'': Main executable, supports both GUI and console operation; | + | * ''[[#winscp.exe|winscp.exe]]'': Main executable, supports both GUI and console operation; |
| - | * ''[[executables#winscp.com|winscp.com]]'': Console interface tool, supports console operation only, allows input/output redirection. | + | * ''[[#winscp.com|winscp.com]]'': Console interface tool, supports console operation only, allows input/output redirection. |
| This follows two basic executable types of Windows operation system, GUI and console. | This follows two basic executable types of Windows operation system, GUI and console. | ||
| - | ===== winscp.exe ===== | + | Both executables are part of the [[installation|installation package]]. Both are as well available for [[portable|portable use]]. |
| - | The EXE executable is the main one. | + | |
| + | ===== [[winscp.exe]] winscp.exe ===== | ||
| + | The ''winscp.exe'' executable is the main one. | ||
| What you can do with it: | What you can do with it: | ||
| - | * When run, it by default starts in GUI mode, showing [[ui_login|Login dialog]]; | + | * When run, it starts by default in GUI mode, showing the [[ui_login|Login dialog]]; |
| - | * Using [[commandline|command-line options]], it can be started in console mode; | + | * Using the [[commandline|command-line options]], it can be started in console mode; |
| - | * It can be used to execute script without showing any window (by omitting ''/console'' parameter). | + | * It can be used to execute scripts without showing any window (by omitting ''[[commandline#scripting|/console]]'' parameter). |
| - | The EXE executable downloaded for [[portable]] use is by default named winscpXXX.exe, where XXX is version. | + | ===== [[winscp.com]] winscp.com ===== |
| - | + | The ''winscp.com'' executable is a simple tool that internally runs ''winscp.exe'' and provides console interface for it. Its primary purpose is [[scripting]]. | |
| - | ===== winscp.com ===== | + | |
| - | The COM executable is simple tool that internally runs ''winscp.exe'' and provides console interface for it. | + | |
| What you can do with it: | What you can do with it: | ||
| - | * Supports console mode only, but allows input/output redirection; | + | * Supports console mode only, but allows [[#redirection|input/output redirection]]; |
| - | * When run from another console application (such as standard Windows console/command-line window, i.e. ''cmd.exe''), it inherits its console((''winscp.exe /console'' would pop up in new console window.)). | + | * When run from another console application (such as standard Windows console/command-line window, i.e. ''cmd.exe''), it inherits its console.((''winscp.exe /console'' would pop up in new console window.)) |
| - | 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 the exactly same name. | + | 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. |
| - | The COM executable is not available for download separately for portable use. However you can install WinSCP temporarily and copy the executable out of the installation folder. Make sure you rename the COM to match name of the EXE. | + | As WinSCP is an Unicode application, you should use a TrueType console font with a full Unicode support, like "Consolas" or "Lucida Console". |
| - | ==== Input/Output Redirection ==== | + | ==== [[redirection]] Input/Output Redirection ==== |
| For input/output redirection use standard operators: | For input/output redirection use standard operators: | ||
| * ''>'' for output redirection; | * ''>'' for output redirection; | ||
| * ''<'' for input redirection; | * ''<'' for input redirection; | ||
| * ''|'' for piping. | * ''|'' for piping. | ||
| + | |||
| + | You can not only redirect normal scripting output and input, but even actual file contents. For that use [[commandline#stdout|''/stdout'']] and [[commandline#stdin|''/stdin'']] command-line switches. | ||
| + | |||
| + | You can also use input/output redirection when running ''winscp.com'' from another application. //For example see [[guide_dotnet#input|Guide to SFTP transfers in .NET]]. Though for this purpose, consider using [[library|WinSCP .NET assembly]] instead.// | ||