[manual index][section index]

NAME

os - interface to host OS commands (hosted Inferno only)

SYNOPSIS

bind -a '#C' /
os [ -b ] [ -m mountpoint ] [ -d dir ] [ -n ] [ -N level ] cmd [ arg... ]

DESCRIPTION

Os uses a cmd(3) device to execute a command, cmd, on a host system. If the -m option is given, os uses the device at mountpoint, otherwise it is asssumed to be at /cmd, and is bound into the local namespace if necessary.

The -d option causes the command to run in directory dir; an error results and the command will not run if dir does not exist or is inaccessible. The standard output and standard error of the command appear on the standard output and standard error streams of the os command itself. Os copies the standard input to the remote command's standard input; redirect os's input to /dev/null if there is no input to the command. Os terminates when cmd does, and its exit status reflects the status of cmd (if available).

If the os command is killed or exits (eg, for lack of input and output), the host's own process control operations are used to (attempt to) kill cmd, if it is still running. The -b (background) option suppresses that behaviour.

The -n option causes cmd to run with less than normal priority (`nice'). The -N option sets low priority to a particular level from 1 to 3.

FILES

/cmd/clone

SOURCE

/appl/cmd/os.b

SEE ALSO

cpu(1), rcmd(1), cmd(3)

DIAGNOSTICS

The exit status of os reflects any error that occurs when starting cmd and, if it starts successfully, the status of os is the exit status of cmd.

os(1) Rev:  Tue Mar 31 02:42:38 GMT 2015