on(1)                               CLIX                               on(1)



  NAME

    on - Executes a command remotely using Remote Procedure Call (RPC)

  SYNOPSIS

    on [-i|-n] [-d] host command [argument]

  FLAGS

    -i   Specifies interactive mode.  This flag uses remote echoing and
         special character processing.  This flag is needed for commands that
         expect to be talking to a terminal.  All terminal modes and window
         size changes are propagated.

    -n   Specifies no input.  This flag causes the remote command to get to
         the end-of-file (EOF) when it reads from stdin, instead of passing
         stdin from stdin of the on command.  For example, -n is necessary
         when running commands in the background with job control.

    -d   Specifies debug mode.  Displays messages as work is being done.

  DESCRIPTION

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

    The stdin is connected to stdin of the remote command, and stdout and
    stderr from the remote command are sent to the corresponding files for the
    on command.

  EXAMPLES

    The following displays the name of the current UNIX system on the system
    sys3:

    on sys3 uname -a


  DIAGNOSTICS

    unknown host
           Hostname not found.

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



  2/94 - Intergraph Corporation                                              1

  on(1)                               CLIX                               on(1)



    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.

  EXIT VALUES

    The exit value for on is 1 if an error occurs in establishing the
    connection; otherwise, it is the exit value of the executed command.

  RELATED INFORMATION

    Commands:  rexd(8)

    Files:  exports(4)




































  2                                              Intergraph Corporation - 2/94