Reference Manual

NAME

exec - execute an application within the host operating syatem
SYNOPSIS
shortcut name
exec     filename [args...]
execa    filename [args...]
execd    filename [args...]
execr    filename [args...]
execx    filename [args...]
ie       [url] | [-p [url]]
browser  [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.

Command shortcut executes the shortcut specified in name located on the Desktop of the current user. Note that names located in \Users\All Users are not accessible. The 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 created host 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. NAT32 records the process details so that later interaction with the process is possible.

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

Execd runs the process in detached mode. No further interaction with the created host process is possible from within NAT32.

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, the browser starts with its configured start page.

Command browser displays a url within the MSEdge browser. If no URL is specified, the browser starts with its configured start 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 on the Desktop cannot be started remotely. The only exception is the execx command, and it is only permitted if password checking is on.

SEE ALSO
kill, shell, sh