remote(C)                       19 June 1992                       remote(C)


 Name

    remote - execute commands on a remote system

 Syntax

    remote [ - ] [ -f file ] [ -m ] [ -u user ] machine command [ arguments ]

 Description

    remote is a limited networking facility that permits execution of UNIX
    commands across serial lines.  Commands on any connected system may be
    executed from the host system using remote.  A command line consisting of
    command and any blank-separated arguments is executed on the remote ma-
    chine.  A machine's name is located in the file /etc/systemid.  Note that
    wild cards are not expanded on the remote machine, so they should not be
    specified in arguments.  The optional -m switch causes mail to be sent to
    the user telling whether the command is successful.

    The available options follow:

    -         A dash signifies that standard input is used as the standard
              input for command on the remote machine.  Standard input comes
              from the local host and not from the remote machine.

    -f file   Use the specified file as the standard input for command on the
              remote machine.  The file exists on the local host and not on
              the remote machine.

    -m        Mails the user to report completion of the command.  By
              default, mail reports only errors.

    -u user   Any mail goes to the named user on machine.  The default ma-
              chine is the machine on which an error was detected, or on
              which the remote command was completed.  The mail will be
              redirected to the appropriate mailbox(es), if an alias for user
              exists in the system alias files on that machine.  Since system
              alias files are usually identical throughout the network, any
              specified machine will most likely be overridden by the alias-
              ing mechanism. To prevent aliasing, user must be escaped with
              at least two ``\'' characters (at least four if given as a
              shell command).

    Before remote can be used successfully, a network of systems must be set
    up and the proper daemons initialized using netutil(ADM).  Also, entries
    for the command to be executed using remote must be added to the
    /etc/default/micnet files on each remote machine.

 Example

    The following command executes an ls command on the directory /tmp of the
    machine machine1:

       remote machine1 ls /tmp


 See also

    mail(C), micnet(F), netutil(ADM), rcp(C)

 Note

    The mail command uses the equivalent of remote to send mail between ma-
    chines.