Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 process-
     ing.  It will then connect to that remote node and execute the  command  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  re-
     mote 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.   Speci-
	  fying  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 listen
	  to  replies  from jsh processes indicating completion of processing on
	  remote nodes.  This option overrides the JSD_IPORT  environment  vari-
	  able.  The default listen port is 2001.

     -o   The -o option can be used to set the port number which jsd will listen
	  to  requests	from  jsh processes for remote nodes.  This option over-
	  rides 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 dae-
	  mon 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 re-
		    mote 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  pro-
		    cessing  on a node.  This environment setting can be overri-
		    den 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.

				February 19, 2000			  JSH(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=jsh&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help