home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / network / system / nsh.1.6.README < prev    next >
Encoding:
Text File  |  1993-03-25  |  4.1 KB  |  91 lines
  1. nsh is a prgram used to easily run jobs in parallel on many
  2. machines on a netinfo network.  If no options are specified
  3. nsh executes whatever arguments you give it as a command on
  4. all the machines listed in the /machines directory in
  5. the / domain of the netinfo network.  The output is not
  6. displayed, and there is a header listing the command
  7. as it is run on each machine.  Other options can be
  8. supplied to alter the behavior of nsh but they must appear
  9. in the argument list before the command you want to run.
  10. nsh allows string replacement in the prepended command,
  11. the command run on the remote machine and the prefix used for
  12. the file names (only if [-f] or [-o] is specified).
  13.  
  14.    '_HOST' will be replaced by the hostname of the machine on
  15.            which the command
  16.    '_COMM' will be replaced by the output of the command specified
  17.            by the [-c] option.  If there wasn't a [-c] command
  18.            specified, "hostname" will be used.
  19.  
  20. The available options are:
  21.  
  22.      [-A domain]  Adds hosts in specified domain to the host list
  23.        [-a host]  Adds a host to the host list
  24.             [-b]  Executes the commands on all the machines in parallel
  25.                   instead of in series
  26.             [-c]  Uses the given command for the '_COMM' substitution.
  27.             [-e]  Completely removes all hosts in the host list
  28.             [-f]  Writes the output to files with names 'nsh_hostname'
  29.                   where 'hostname' is the name of each machines in the host
  30.                   list
  31.         [-h key]  Causes nsh to use the specified string (key) as a hostname
  32.                   replacement tag instead of the default '_HOST'
  33.         [-l key]  Causes nsh to use the specified string (key) as a command
  34.                   replacement tag instead of the default '_COMM'
  35. [-o file-prefix]  Uses the specified string as the prefix for all file
  36.                   names instead of 'nsh' (i.e. 'nsh_hostname' becomes
  37.                   'string_hostname');  Also changes the mode of output to
  38.                   writing to files.
  39.     [-p command]  Uses the spcified command for the submission of the
  40.                   commands to the remote machines instead of [rsh]
  41.             [-s]  Turns off the header displying the command as it is run
  42.             [-v]  Writes the output of each command to the screen
  43.      [-X domain]  Excludes hosts in specified domain from the host list
  44.        [-x host]  Excludes a host from the host list
  45.  
  46. NOTES:
  47.    1) If any options given in the argument list are confilcting
  48.       (e.g. -f and -v, or -a then -e) the options appearing
  49.       latest will be used
  50.    2) -a and -x do not check for the validity of the hostname
  51.       given.
  52.    3) If the -e option is used, all hosts specified by the -a
  53.       option earlier in the argument list will be removed.
  54.    4) If the command you submit to the machine requires
  55.       keyboard input, the -b option is not a good idea
  56.    5) nsh will not work if the user does not have permission
  57.       to read from the netinfo database.
  58.  
  59. EXAMPLES:
  60.    1) nsh -v -s hostname
  61.       [Just a simple test to see if all machines are up]
  62.    2) nsh -v -p finger fosdal@_HOST
  63.       [Checks if 'fosdal' is logged in on any of the machines]
  64.    3) nsh -o Loads uptime
  65.       [Saves the current loads of all the machines]
  66.  
  67. Copyright (C) 1993  Steven R. Fosdal
  68. Version 1.6 March 3rd
  69.  
  70. Steven R. Fosdal
  71. 508 South Baldwin Street
  72. Madison, WI 53703-3707
  73. E-Mail: fosdal@phenxm.physics.wisc.edu
  74.  
  75. If you have any comments or suggestions please let me know.
  76.  
  77. This program is free software; you can redistribute it and/or
  78. modify it under the terms of the GNU General Public License as
  79. published by the Free Software Foundation; either version 1, or
  80. (at your option) any later version.
  81.  
  82. This program is distributed in the hope that it will be useful,
  83. but WITHOUT ANY WARRANTY; without even the implied warranty of
  84. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  85. GNU General Public License for more details.
  86.  
  87. You should have received a copy of the GNU General Public
  88. License along with this program; if not, write to the Free
  89. Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
  90. USA.
  91.