ftp.nice.ch/pub/next/unix/network/system/nsh.1.6.README

This is the README for nsh.1.6.d.tar.gz [Download] [Browse] [Up]

nsh is a prgram used to easily run jobs in parallel on many
machines on a netinfo network.  If no options are specified
nsh executes whatever arguments you give it as a command on
all the machines listed in the /machines directory in
the / domain of the netinfo network.  The output is not
displayed, and there is a header listing the command
as it is run on each machine.  Other options can be
supplied to alter the behavior of nsh but they must appear
in the argument list before the command you want to run.
nsh allows string replacement in the prepended command,
the command run on the remote machine and the prefix used for
the file names (only if [-f] or [-o] is specified).

   '_HOST' will be replaced by the hostname of the machine on
           which the command
   '_COMM' will be replaced by the output of the command specified
           by the [-c] option.  If there wasn't a [-c] command
           specified, "hostname" will be used.

The available options are:

     [-A domain]  Adds hosts in specified domain to the host list
       [-a host]  Adds a host to the host list
            [-b]  Executes the commands on all the machines in parallel
                  instead of in series
            [-c]  Uses the given command for the '_COMM' substitution.
            [-e]  Completely removes all hosts in the host list
            [-f]  Writes the output to files with names 'nsh_hostname'
                  where 'hostname' is the name of each machines in the host
                  list
        [-h key]  Causes nsh to use the specified string (key) as a hostname
                  replacement tag instead of the default '_HOST'
        [-l key]  Causes nsh to use the specified string (key) as a command
                  replacement tag instead of the default '_COMM'
[-o file-prefix]  Uses the specified string as the prefix for all file
                  names instead of 'nsh' (i.e. 'nsh_hostname' becomes
                  'string_hostname');  Also changes the mode of output to
                  writing to files.
    [-p command]  Uses the spcified command for the submission of the
                  commands to the remote machines instead of [rsh]
            [-s]  Turns off the header displying the command as it is run
            [-v]  Writes the output of each command to the screen
     [-X domain]  Excludes hosts in specified domain from the host list
       [-x host]  Excludes a host from the host list

NOTES:
   1) If any options given in the argument list are confilcting
      (e.g. -f and -v, or -a then -e) the options appearing
      latest will be used
   2) -a and -x do not check for the validity of the hostname
      given.
   3) If the -e option is used, all hosts specified by the -a
      option earlier in the argument list will be removed.
   4) If the command you submit to the machine requires
      keyboard input, the -b option is not a good idea
   5) nsh will not work if the user does not have permission
      to read from the netinfo database.

EXAMPLES:
   1) nsh -v -s hostname
      [Just a simple test to see if all machines are up]
   2) nsh -v -p finger fosdal@_HOST
      [Checks if 'fosdal' is logged in on any of the machines]
   3) nsh -o Loads uptime
      [Saves the current loads of all the machines]

Copyright (C) 1993  Steven R. Fosdal
Version 1.6 March 3rd

Steven R. Fosdal
508 South Baldwin Street
Madison, WI 53703-3707
E-Mail: fosdal@phenxm.physics.wisc.edu

If you have any comments or suggestions please let me know.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 1, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.