unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

on(1)                            User Commands                           on(1)



NAME
       on - execute a command on a remote system 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 vari-
       ables  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. The standard output and the standard  error  from  the  remote
       command are sent to the corresponding files for the on command.

OPTIONS
       The following options are supported:

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



       -i       Interactive  mode.  Uses  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.



       -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 back-
                ground with job control.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWnfscu


SEE ALSO
       chkey(1), rlogin(1), rsh(1), telnet(1), attributes(5)

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: Authentication error

           The  server  requires  DES  authentication  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 pub-
           lickey with chkey.



       on server: RPC: can't encode arguments

           The 10240 byte limit for arguments to be encoded  and  passed  from
           the sending to the receiving system has been exceeded.



       Other diagnostic messages may be passed back from the server.

BUGS
       When  the  working  directory  is  remote mounted over NFS, a Control-Z
       hangs the window.

       Root cannot use on.



SunOS 5.10                        8 Oct 2003                             on(1)