JSH(1)                  NetBSD General Commands Manual                  JSH(1)

NAME
     jsh -- run scheduled commands on remote machines

SYNOPSIS
     jsh [-aeiv] [-l username] [-p port] [-o port] [-h hostname] [command ...]

DESCRIPTION
     The jsh program connects to a jsd daemon, and requests a node for pro-
     cessing.  It will then connect to that remote node and execute the com-
     mand or commands given to it.  Once it has completed work on the remote
     machine, it will return the node to the jsd daemon for future use by
     other jsh processes.  The primary use of this is to ensure that no more
     than one remote process is running on any single machine at a point in
     time.  This can be used to better facilitate bulk parallel compiling.

     The following options are available:

     -a   The -a option modifies the behavior of jsh when dealing with stdin.
          Normally all commands from stdin are run on the same machine.  Spec-
          ifying the -a option causes each command to be run on the next node
          in the seqence.

     -e   Unless the -e option is specified, stderr from remote commands will
          not be reported to the user.

     -i   The -i option will list information about the current cluster, and
          command groupings. It will also show you which command you are about
          to run, and your username if specified with the -l option.

     -v   Prints the version of ClusterIt to the stdout, and exits.

     -l   If the -l option is specified, followed by a username, the commands
          will be run under that userid on the remote machines.  Consideration
          must be taken for proper authentication, for this to work.

     -p   The -p option can be used to set the port number which jsd will lis-
          ten to replies from jsh processes indicating completion of process-
          ing on remote nodes.  This option overrides the JSD_IPORT environ-
          ment variable.  The default listen port is 2001.

     -o   The -o option can be used to set the port number which jsd will lis-
          ten to requests from jsh processes for remote nodes.  This option
          overrides the JSD_OPORT environment variable.  The default listen
          port is 2002.

     -h   The -h option can be used to set the remote hostname where a jsd
          daemon is running.  jsh defaults to contacting a jsd daemon on the
          local machine, but can be set up to talk to a remote daemon.  The -h
          option will override the JSD_HOST environment variable.

ENVIRONMENT
     jsh utilizes the following environment variables:

     RCMD_CMD       Command to use to connect to remote machines.  The command
                    chosen must be able to connect with no password to the
                    remote host.  Defaults to rsh.

     RCMD_CMD_ARGS  Arguments to pass to the remote shell command.  Defaults
                    to none.

     JSD_OPORT      When set, overrides the default port which jsd listens on
                    for jsh processes requesting nodes.  This environment set-
                    ting can be overriden by the -o option.

     JSD_IPORT      When set, overrides the default port which jsd listens on
                    for jsh processes reporting back that it has completed
                    processing on a node.  This environment setting can be
                    overriden by the -p option.

     JSD_HOST       When set, contains the hostname of the remote machine that
                    the jsd daemon is listening on.  This environment setting
                    can be overriden by the -h option.

SEE ALSO
     dsh(1), rsh(1), kerberos(3), hosts.equiv(5), rhosts(5), jsd(1).

HISTORY
     The jsh command first appeared in clusterit 2.0.

AUTHOR
     Jsh was written by Tim Rightnour.

NetBSD 4.0_BETA2               February 19, 2000              NetBSD 4.0_BETA2
