Open System Services Shell and Utilities Reference Manual (G06.28+, H06.05+)

User Commands (p - r) run(1)
-extswap=/G/volume[/subvolume[/swapfile]]
Same as -swap, but any swap file specified is used to hold the extended data segment
for the TNS process. This flag has no impact on native processes.
-term=/G/terminal_name
Specifies the home terminal for the new process. If this flag is omitted, the new process
uses the OSS shell’s home terminal. terminal_name must be a valid name for a termi-
nal or process. If terminal_name is of the Guardian form $ZTNT.#PTY4, it must be
specified as /G/ZTNT/#PTY4.Ifterminal_name is of the Guardian form $name,it
must be specified as /G/name. For example, $TTY translates to /G/TTY.
DESCRIPTION
The run utility starts OSS programs with specific attributes. The run utility is implemented as a
built-in shell feature conforming to the POSIX.2 syntax standards. The child process of run
belongs to the same process group as that of the shell from which the run command was issued.
run allows OSS programs to run under the control of the symbolic debugger. run issues a
tdm_execve() function call with the specified executable image file path and the option operands
with which it was invoked.
Operands
program_file_path
The OSS filename of an executable image. An executable image is any type of OSS
file that has the execute permission bit set for the user, so that the OSS stat() function
identifies the file as an executable image.
If the full OSS pathname is not specified, the directories listed in the environment vari-
able PATH are searched. If the run command is invoked without a program_file_path,
the usage string is displayed and run exits in error.
arguments
An optional list of arguments that are to be passed to the program file. The arguments
should be specified at the time the run command is invoked.
Environment Variables
LANG Determines the locale to be used for the locale categories when both the LC_ALL
variable and the corresponding environment variable (whose name begins with LC_)
do not specify a locale.
LC_ALL
Determines the locale to be used to override any values for locale categories specified
by the settings of the LANG variable or any environment variable whose name begins
with LC_.
LC_CTYPE
Determines the locale for the interpretation of bytes of text data as characters (for
example, single-byte versus multibyte characters in arguments).
LC_MESSAGES
Determines the locale to be used to affect the format and content of diagnostic mes-
sages written to the standard error file and informational messages written to the stan-
dard output file.
527188-007 Hewlett-Packard Company 7−61