on(1C)                            ONC R4.11                           on(1C)


NAME
       on - execute a command on a remote system, but with the local
       environment

SYNOPSIS
       on [ -i ] [ -d ] [ -n ] host command [ argument ] ...

DESCRIPTION
       The on program is used to execute commands on another system, in an
       environment similar to that invoking the program.  All environment
       variables and the current umask are passed, and the current working
       directory is preserved.  To preserve the working directory, the
       working file system must be either already mounted on the host or be
       exported to it.  Relative path names will only work if they are
       within the current file system; absolute path names may cause
       problems.

       The standard input is connected to the standard input of the remote
       command, and the standard output and the standard error from the
       remote command are sent to the corresponding files for the on
       command.

       The on command uses the simple trusted host authentication that
       rlogin and remsh use. For details, see hosts.equiv(4M)

OPTIONS
       -i     Interactive mode. Use remote echoing and special character
              processing.  This option is needed for programs that expect to
              be talking to a terminal.  All terminal modes and window size
              changes are propagated.  If you create a symbolic link to on
              with the name of a host (e.g., ln -s /usr/bin/on yoursys),
              typing the name of the host is the same as using on with the
              -i option and the name of the host.

       -d     Debug mode. Print out some messages as work is being done.

       -n     No Input. This option causes the remote program to get EOF
              when it reads from the standard input, instead of passing the
              standard input from the standard input of the on program.  For
              example, -n is necessary when running commands in the
              background with job control.

DIAGNOSTICS
       unknown host        Host name not found.

       cannot connect to server
                           Host down or not running the server.

       can't find          Problem finding the working directory.

       can't locate mount point
                           Problem finding current file system.

       Other error messages may be passed back from the server.

SEE ALSO
       remsh(1C), rexd(1M), exports(4), hosts.equiv(4M).

BUGS
       The DG/UX window system can get confused by some environment
       variables, particularly LINES and COLUMNS.


Licensed material--property of copyright holder(s)