Open System Services Shell and Utilities Reference Manual (G06.25+, H06.03+)

User Commands (m - o) osh(1)
NAME
osh - Runs a process in the OSS environment from the Guardian environment
SYNOPSIS
osh [ option ... ][redirection ... ][operands ]
FLAGS
Operands used with the osh command must follow osh option specifications. Redirection can
appear anywhere on the command line.
Options
All filename and pathname arguments used with osh options must be specified using OSS path-
name syntax. In the current release, filenames and pathnames within the /E directory are not sup-
ported by the OSS file system. However, osh supports specification of the /E directory for
filenames and pathnames in options such as -prog pathname. These specifications allow the user
to identify Guardian environment objects on other HP NonStop server nodes.
The specification of osh options ends when osh finds one of the following:
• The end of the input line
• Any operand; that is, any specification that does not start with a minus (-) or plus (+) and
is not a redirection specification
• The -- option
• The -p option
The osh options cannot be grouped after a single minus (-) or plus (+). That is, -debuginspect on
is not a valid option specification.
The osh options can be specified in any order; osh processes options from left to right. When you
specify an osh option more than once, the rightmost specification on the command line determines
the value used.
-? | -help Displays usage information for the osh command. If this option is specified, all
remaining osh options and operands on the command line are ignored.
-c command Submits command to the OSS child process as a single argument, prefixed by -c.
If the command string contains more than one item, the entire string must be
enclosed in quotation marks ("). The command string can be any valid OSS shell
command, OSS utility name, or script file pathname and can include parameters to
be processed by the named command, utility, or script.
-cpu n Specifies the processor (0-15) in which the child process is to run. The default
processor is the processor in which osh is running.
-debug Starts a Guardian environment debugging tool at the first executable instruction of
the child process. The default action is to start the child process without a debug-
ging tool active.
Refer to the appropriate debugger manual for additional information.
-defmode on | -defmode off
Specifies the Guardian DEFINE mode for the child process.
If you use -defmode on, all Guardian DEFINE values of the process executing
osh are inherited by the child process.
If you use -defmode off, only Guardian =_DEFAULTS DEFINE values are inher-
ited by the child process.
527188-003 Hewlett-Packard Company 6−93