.TH OS 1 hosted.SH NAMEos \- interface to host OS commands (hosted Inferno only).SH SYNOPSIS.B bind -a '#C' /.br.B os[.B -b] [.B -m.I mountpoint] [.BI -d " dir"] [.B -n] [.BI -N " level"].I cmd[.IR arg ...].SH DESCRIPTION.I Osuses a.IR cmd (3)device to execute a command,.IR cmd ,on a host system.If the.B -moption is given,.I osuses the device at.IR mountpoint ,otherwise it is asssumed to be at.BR /cmd ,and is bound into the local namespace if necessary..PPThe.B -doption causes the command to run in directory.IR dir ;an error results and the command will not run if.I dirdoes not exist or is inaccessible.The standard output and standard error of the command appear on the standard outputand standard error streams of the.I oscommand itself..I Oscopies the standard input to the remote command's standard input; redirect.IR os 'sinput to.B /dev/nullif there is no input to the command..I Osterminates when.I cmddoes, and its exit status reflects the status of.I cmd(if available)..PPIf the.I oscommand is killed or exits (eg, for lack of input and output),the host's own process control operations are used to (attempt to) kill.IR cmd ,if it is still running.The.B -b(background) option suppresses that behaviour..PPThe.B -noption causes.I cmdto run with less than normal priority (`nice').The.B -Noption sets low priority to a particular.I levelfrom 1 to 3..SH FILES.B /cmd/clone.SH SOURCE.B /appl/cmd/os.b.SH "SEE ALSO".IR cpu (1),.IR rcmd (1),.IR cmd (3).SH DIAGNOSTICSThe exit status of.I osreflects any error that occurs when starting.I cmdand, if it starts successfully, the status of.I osis the exit status of.IR cmd .
.TH OS 1 hosted
.SH NAME
os \- interface to host OS commands (hosted Inferno only)
.SH SYNOPSIS
.B bind -a '#C' /
.br
.B os
[
.B -b
] [
.B -m
.I mountpoint
] [
.BI -d " dir"
] [
.B -n
] [
.BI -N " level"
]
.I cmd
[
.IR arg ...
]
.SH DESCRIPTION
.I Os
uses a
.IR cmd (3)
device to execute a command,
.IR cmd ,
on a host system.
If the
.B -m
option is given,
.I os
uses the device at
.IR mountpoint ,
otherwise it is asssumed to be at
.BR /cmd ,
and is bound into the local namespace if necessary.
.PP
The
.B -d
option causes the command to run in directory
.IR dir ;
an error results and the command will not run if
.I 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
.I os
command itself.
.I Os
copies the standard input to the remote command's standard input; redirect
.IR os 's
input to
.B /dev/null
if there is no input to the command.
.I Os
terminates when
.I cmd
does, and its exit status reflects the status of
.I cmd
(if available).
.PP
If the
.I 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
.IR cmd ,
if it is still running.
The
.B -b
(background) option suppresses that behaviour.
.PP
The
.B -n
option causes
.I cmd
to run with less than normal priority (`nice').
The
.B -N
option sets low priority to a particular
.I level
from 1 to 3.
.SH FILES
.B /cmd/clone
.SH SOURCE
.B /appl/cmd/os.b
.SH "SEE ALSO"
.IR cpu (1),
.IR rcmd (1),
.IR cmd (3)
.SH DIAGNOSTICS
The exit status of
.I os
reflects any error that occurs when starting
.I cmd
and, if it starts successfully, the status of
.I os
is the exit status of
.IR cmd .