psxrun

NAME

psxrun - Windows command-line utility to start an Interix process without a controlling terminal

SYNOPSIS

psxrun [-p pathname] [-h] [-u] 
	 [-l logfilepath] [--] [arg0 [arg1[...]]]

DESCRIPTION

The psxrun Windows command-line utility starts the Interix process specified by arg0 without a controlling terminal. In addition, the arg0 argument is passed to the process as the $0 argument, arg1 is passed as $1, and so on. This is used primarily to start X Window client programs (which create their own windows) or Interix-based Windows services (which cannot interact with users). To run X Window client programs, you must have an X Window server installed and running.

The psxrun utility supports the following options, which must be specified using lowercase letters:

-p pathname
Specifies the path name of the Interix program to be run instead of arg0. You can use this to start a program and set the $0 argument to something other than the actual path to the program. For example, psxrun -u -p /usr/loca/bin/prog -- -prog starts /usr/local/bin/prog, but sets its initial argument (arg0) to be -prog. Note the use of the -- option to prevent -prog from being interpreted as another use of the -p option.
-h
Display usage information.
-u
Specifies that path names are interpreted using Interix syntax rather than Windows syntax. This makes it easier to run programs using the Interix single-rooted file system. For example, psxrun -u /bin/xterm would be started regardless of the directory where Windows Services for UNIX is installed.
-l logfilepath
Specifies that psxrun is to record all diagnostic information in the file specified by the logfilepath argument.
--
Stop examining the command line. The arguments to the program to be executed begin immediately after the -- option.

SEE ALSO

posix(1w)