on(1) General Commands Manual on(1)
NAME
on - execute command on remote host with environment similar to local
SYNOPSIS
| host [command [argument] ... ]
DESCRIPTION
executes a command on a remote host, using an environment similar to that of the invoking user where:
host specifies the name of the host on which to execute the command.
command specifies the command to execute on host
If command is not specified, starts a shell on host. argument ... is a list of arguments for command.
The user's environment variables are copied to the remote host, and the file system containing the user's current working directory is NFS
mounted on the remote host (see nfs(7)). The command is executed on the remote host in the user's current working directory.
Commands using relative path names that reference file system objects within the user's current working file system have the same behavior
as running the command on the client. The behavior of commands using relative path names that cross the file system boundary or commands
using absolute path names depends on the organization of the remote host's file system.
Implicit and explicit use of environment variables may also cause a command's behavior to be dependent on the organization of the remote
host's file system. For example, the environment variable usually contains absolute path names.
Standard input, output and error of the remote command are connected to the appropriate file descriptors on the client.
The remote execution daemon does not allow to execute a remote command.
The signals and are propagated to the remote command. and are ignored by the remote command. All other signals are delivered to the com-
mand.
In order to execute a remote command, the remote host must be configured to execute (see rexd(1M)).
Options
recognizes the following options:
Interactive mode.
This option is required for commands that must communicate with a terminal such as or Terminal mode changes are propagated
to the server. The standard input for an interactive command must be a tty device. The and options are mutually exclusive.
Debug mode.
Print diagnostic messages during startup of the command. These messages are useful for detecting configuration problems if
the command to a specific host is failing.
No input mode.
This option causes the remote command to get end-of-file (EOF) when it reads from standard input, instead of connecting the
standard input of the command to the standard input of the remote command. The option is required when running commands in
the background. The and options are mutually exclusive.
DIAGNOSTICS
The host name
host was not found in the hosts database.
The host host is down, unreachable on the network, or not running
A problem occurred trying to find the user's current working directory
(current_dir).
A problem occurred trying to determine the mount point
of the user's current working directory (current_dir).
The standard input (stdin) of the
command with the option is not a tty device.
Errors that occur on the server
server are propagated back to the client. These messages are documented in the DIAGNOSTICS section of rexd(1M).
AUTHOR
was developed by Sun Microsystems, Inc.
SEE ALSO
exports(4), rexd(1M).
on(1)