Reference Manual

NAME

exec - execute an application within the host operating syatem
SYNOPSIS
desktop  filename [args...]
exec     filename [args...]
execa    filename [args...]
execd    filename [args...]
execr    filename [args...]
execx    filename [args...]
ie       [url] | [-p [url]]
win      filename [args...]
winh     filename [args...]
wins     filename [args...]
execs    filename [args...]
execw    filename [args...]
DESCRIPTION
All variants of the exec command (except execa) execute the specified filename (with arguments) at the same privilege level as NAT32 enjoys within the host operating system. Command execa raises that privilege level if necessary and will usually be intercepted by the operating system's User Account Control mechanism.

Desktop (alias shortcut) executes the specfied filename located on the current Desktop. This command can be used to execute Files, Applications and Shortcuts, and to open Desktop Folders. No error messages are returned and no interaction with the subsequent Process is possible from within NAT32.

Exec invokes filename with the specified arguments as a process within Windows. Windows' naming conventions apply to the named file, and the file must be located within Windows' search path. Exec returns an error message from Windows if the application could not be executed. Once the application is running, NAT32 has no further control over it.

Execx is identical to exec except that it can be issued from a remote host.

Execd runs the process in detached mode (requires privilege under Windows XP and higher).

Execr runs the process with its stdio devices redirected to the NAT32 STDIO devices. The command blocks until the process terminates. The running process can be interrupted by typing Ctrl-C in the window of the process. Applications which do not use stdio devices can be terminated with the killp command or whatever method the application supports.

The execr command allows any Windows Console Mode application to be executed and its output captured. The pipe and redirection mechanisms of the NAT32 shell work as expected.

Example: the command winh cmd.exe starts a Windows Console within a NAT32 Console. Its command interpreter must be terminated with the exit command.

Command win is an alias for execr. Command winh is equivalent to win except that the applications's main window is hidden. Similarly, command wins shows the application's main window.

Command ie displays a url within Internet Explorer. Option -p url starts Internet Explorer in InPrivate Mode to display the specified URL. If no URL is specified, Internet Explorer starts with its default home page.

Execs searches for filename in the Windows system directory.

Execw behaves as exec, but waits for the process to complete.

NOTES
Any external process on which NAT32 waits can be terminated prematurely with the killp command.

Most exec variants that create a GUI process cannot be started from a remote location. The only exception is the execx command, and it is only permitted if password checking is on.

SEE ALSO
kill, shell, sh