unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

ON(1C)                                                                  ON(1C)



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

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 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; abso-
       lute 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.

OPTIONS
       -i     Interactive mode. Use remote echoing and special character  pro-
              cessing.   This  option is needed for programs that expect to be
              talking to a terminal.   All  terminal  modes  and  window  size
              changes are propagated.

       -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  stan-
              dard input from the standard input of the on program.  For exam-
              ple, -n is necessary when running  commands  in  the  background
              with job control.

SEE ALSO
       chkey(1), publickey(5), exports(5), rexd(8C)

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.  RPC: Authen-
                           tication error The server requires des  authentica-
                           tion  and  you  do not have a secret key registered
                           with keyserv.  Perhaps  you  logged  in  without  a
                           password.   Try  to keylogin.  If that fails try to
                           set your publickey with chkey.

       Other error messages may be passed back from the server.

BUGS
       The SunView window system can get confused  by  the  environment  vari-
       ables.

       When  the  working directory is remote mounted over NFS, a ^Z hangs the
       window.

       Root cannot use on.



                               8 September 1988                         ON(1C)