executables » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| executables 2011-09-16 | executables 2024-10-11 (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. | ||
| Line 9: | Line 9: | ||
| Both executables are part of the [[installation|installation package]]. Both are as well available for [[portable|portable use]]. | Both executables are part of the [[installation|installation package]]. Both are as well available for [[portable|portable use]]. | ||
| - | ===== winscp.exe ===== | + | ===== [[winscp.exe]] winscp.exe ===== |
| - | The EXE executable is the main one. | + | 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). |
| - | ===== winscp.com ===== | + | ===== [[winscp.com]] winscp.com ===== |
| - | The %%COM%% executable is a simple tool that internally runs ''winscp.exe'' and provides console interface for it. | + | The ''winscp.com'' executable is a simple tool that internally runs ''winscp.exe'' and provides console interface for it. Its primary purpose is [[scripting]]. |
| What you can do with it: | What you can do with it: | ||
| - | * Supports console mode only, but allows [[executables#redirection|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.)) |
| - | * 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. | + | |
| - | 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 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. |
| + | |||
| + | As WinSCP is an Unicode application, you should use a TrueType console font with a full Unicode support, like "Consolas" or "Lucida Console". | ||
| ==== [[redirection]] Input/Output Redirection ==== | ==== [[redirection]] Input/Output Redirection ==== | ||
| Line 32: | Line 33: | ||
| * ''<'' 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.// | ||