updated docs/manpages for AIX exception, autoconf options changes, and

several english/readibility/aesthetic issues

README

@@ -24,6 +24,9 @@ To configure in additional feature modules:
 
 ./configure [options]
 
+--with-ssh
+        Enable support of ssh(1) remote shell service.
+
 --with-machines=/path/to/machines
 	Use a flat file list of machine names for -a instead of
         genders, nodeattr, or SDRGetObjects.  
@@ -34,19 +37,24 @@ To configure in additional feature modules:
 
 --with-genders
         Enable support of a genders database through the genders(3)
-        library.
+        library.  For pdsh's -i option to function properly, the genders
+        database must have alternate node names listed as the value of
+        the "altname" attribute. 
 
 --with-nodeattr=/path/to/nodeattr
         Enable support of a genders database through the nodeattr(1)
         command. This is primarily for older systems that do not yet
-        have genders(3) library support.
+        have genders(3) library support.  For pdsh's -i option to
+        function properly, the genders database must have alternate
+        node names listed as the value of the "altname" attribute and
+        the nodeattr command must have the -r option available. 
 
 --with-nodeupdown
         Enable support of dynamic elimination of down nodes through
         the nodeupdown(3) library. 
 
 --with-mrsh
-        Enable support of the mrsh(1) shell service.
+        Enable support of mrsh(1) remote shell service.
 
 --with-mqshell
         Enable support for runnig parallel jobs on the Quadrics Elan
@@ -69,9 +77,10 @@ To configure in additional feature modules:
 Note that a number of the above configurations options may "conflict"
 with each other because they perform identical operations.  For
 example, genders and nodeattr both support the -g option.  If several
-modules are built that support identical options, the options will
-default to one particular module.  See the man page in this directory
-for details on which modules conflict.
+modules are installed that support identical options, the options will
+default to one particular module.  Static compilation of modules will
+fail if conflicting modules are selected.  See the man page in this
+directory for details on which modules conflict.
 
 +------------+
 | INSTALLING |

README.KRB4

@@ -1,14 +1,14 @@
-NOTE: this has not been tested in a long while.  We have stopped using KRB4
-for pdsh on our SP's because we would occasionally overwhelm our KDC.
-Also there is a bug which causes pdsh to run very slowly when pdsh has to
-refresh the tgt for a node. --jg
----
 To build the *API only* on an SP with AIX 4.2.1 / PSSP 2.4 and install in 
 /usr/local/krb4, use the following manual procedure or run the attached script
 (but look at it first:  set paths appropriate to your environment and note
 that it destroys an old copy of the API if it is in the way).
 
-NOTE: gcc needs to be in your PATH.
+NOTES: 
+- This has not been tested in a long while.  We have stopped using KRB4
+for pdsh on our SP's because we would occasionally overwhelm our KDC.
+Also there is a bug which causes pdsh to run very slowly when pdsh has to
+refresh the tgt for a node. --jg
+- gcc needs to be in your PATH.
 
 1) Obtain cns-96q4.tar.gz distribution from MIT and untar in ./kerberos.
    See: http://web.mit.edu/network/kerberos-form.html (verified this 3/98).

README.QsNet

@@ -1,10 +1,10 @@
-If built with --with-elan or --with-mqsh, pdsh may be used to run MPI
-jobs on a QsNet interconnect.  This option requires that you have the
-Elan user space libraries installed (qswelan-r RPM for Linux) and that
-your kernel be patched to run the 'elan3' and 'rms' device drivers.
-Pdsh can run independently of the RMS product (the 'rms' kernel
-module, which is used by pdsh, is a distinct facility from the RMS
-product).
+If built with --with-qshell or --with-mqshell, pdsh may be used to run
+MPI jobs on a QsNet interconnect.  This option requires that you have
+the Elan user space libraries installed (qswelan-r RPM for Linux) and
+that your kernel be patched to run the 'elan3' and 'rms' device
+drivers.  Pdsh can run independently of the RMS product (the 'rms'
+kernel module, which is used by pdsh, is a distinct facility from the
+RMS product).
 
 Pdsh can also be run via the Quadrics RMS 'allocate' command such that
 allocate takes care of the node reservations and passes a batch ID

doc/pdcp.1.in

@@ -67,9 +67,11 @@ user a number of other possible options when running pdcp.
 .LP
 .B genders
 .LP
-The genders module allows pdcp to access the genders database through
+The genders module allows pdsh to access the genders database through
 the genders(3) library.  The -g, -a, and -i options are available when
-this module is installed.
+this module is installed.  The -i option will only work if the genders
+database has alternate node names listed as the value of the "altname"
+attribute.
 .LP
 .B machines
 .LP
@@ -79,10 +81,13 @@ when this module is installed.
 .LP
 .B nodeattr
 .LP
-The nodeattr module allows pdcp to access the genders database through
+The nodeattr module allows pdsh to access the genders database through
 the nodeattr(1) command.  This module is primarily needed for older
 systems that do not yet have the gender(3) library installed.  The -g,
--a, and -i options are available when this module is installed.
+-a, and -i options are available when this module is installed.  The
+-i option will only work if the genders database has alternate node
+names listed as the value of the "altname" attribute and if the
+nodeattr command has the -r option available.
 .LP
 .B nodeupdown
 .LP
@@ -110,18 +115,19 @@ one per line.  The host list may contain hostname ranges of the form
 HOST RANGES section below.
 .LP
 .I "-x host,host,..."
-Exclude the specified hosts.  May be specified in conjunction with other
-target node list options such as -a. Hostname ranges may also be specified
-to the -x option (see HOST RANGES section below)
+Exclude the specified hosts.  May be specified in conjunction with
+other target node list options such as -a and -g. Hostname ranges may
+also be specified to the -x option (see HOST RANGES section below)
 .LP
 .I "-a"
 Target "all" nodes in the cluster.  Conflicts with -w and -g options.
 Available only if the genders, nodeattr, SDR, or machines module is
 installed.
 .LP
 .I "-v"
-In combination with -a, eliminate nodes that are down.  Available only
-if the SDR or nodeupdown module is installed.
+Eliminate target nodes that are down.  Available only if the SDR or
+nodeupdown module is installed.  On AIX, the -v option can only be
+used in conjunction with the -a option.
 .LP
 .I "-G"
 In combination with -a, include all partitions. Available only 
@@ -135,7 +141,8 @@ module is installed.
 .I "-i"
 In conjunction with -a or -g, request canonical hostnames.  The
 default is to use reliable hostnames.  Available only if the
-genders or nodeattr module is installed.
+genders or nodeattr module is installed.  On AIX, the -i option
+can only be used in conjunction with the -a option.
 .LP
 If none of the above options are specified, the WCOLL environment variable
 must point to a file that contains a list of nodes, one per line.  

doc/pdsh.1.in

@@ -101,7 +101,9 @@ user a number of other possible options when running pdsh.
 .LP
 The genders module allows pdsh to access the genders database through
 the genders(3) library.  The -g, -a, and -i options are available when
-this module is installed.
+this module is installed.  The -i option will only work if the genders
+database has alternate node names listed as the value of the "altname"
+attribute.
 .LP
 .B machines
 .LP
@@ -114,7 +116,10 @@ when this  module is installed.
 The nodeattr module allows pdsh to access the genders database through
 the nodeattr(1) command.  This module is primarily needed for older
 systems that do not yet have the gender(3) library installed.  The -g,
--a, and -i options are available when this module is installed.
+-a, and -i options are available when this module is installed.  The
+-i option will only work if the genders database has alternate node
+names listed as the value of the "altname" attribute and if the
+nodeattr command has the -r option available.
 .LP
 .B nodeupdown
 .LP
@@ -142,18 +147,19 @@ one per line.  The host list may contain hostname ranges of the form
 HOST RANGES section below.
 .LP
 .I "-x host,host,..."
-Exclude the specified hosts.  May be specified in conjunction with other
-target node list options such as -a. Hostname ranges may also be specified
-to the -x option (see HOST RANGES section below)
+Exclude the specified hosts.  May be specified in conjunction with
+other target node list options such as -a and -g. Hostname ranges may
+also be specified to the -x option (see HOST RANGES section below)
 .LP
 .I "-a"
 Target "all" nodes in the cluster.  Conflicts with -w and -g options.
 Available only if the genders, nodeattr, SDR, or machines module is
 installed.
 .LP
 .I "-v"
-In combination with -a, eliminate nodes that are down.  Available only
-if the SDR or nodeupdown module is installed.
+Eliminate target nodes that are down.  Available only if the SDR or
+nodeupdown module is installed.  On AIX, the -v option can only be
+used in conjunction with the -a option.
 .LP
 .I "-G"
 In combination with -a, include all partitions. Available only 
@@ -162,12 +168,13 @@ if the SDR module is installed.
 .I "-g attribute"
 Target nodes that have the specified genders attribute.  Conflicts
 with -a and -w options.  Available only if the genders or nodeattr
-module is installed.
+module is installed.  
 .LP
 .I "-i"
 In conjunction with -a or -g, request canonical hostnames.  The
 default is to use reliable hostnames.  Available only if the
-genders or nodeattr module is installed.
+genders or nodeattr module is installed.  On AIX, the -i option
+can only be used in conjunction with the -a option.
 .LP
 If the rms module is installed, and the RMS_RESOURCEID environment
 variable is set to an allocated RMS resource, RMS will be queried for

pdcp.1.in

@@ -67,9 +67,11 @@ user a number of other possible options when running pdcp.
 .LP
 .B genders
 .LP
-The genders module allows pdcp to access the genders database through
+The genders module allows pdsh to access the genders database through
 the genders(3) library.  The -g, -a, and -i options are available when
-this module is installed.
+this module is installed.  The -i option will only work if the genders
+database has alternate node names listed as the value of the "altname"
+attribute.
 .LP
 .B machines
 .LP
@@ -79,10 +81,13 @@ when this module is installed.
 .LP
 .B nodeattr
 .LP
-The nodeattr module allows pdcp to access the genders database through
+The nodeattr module allows pdsh to access the genders database through
 the nodeattr(1) command.  This module is primarily needed for older
 systems that do not yet have the gender(3) library installed.  The -g,
--a, and -i options are available when this module is installed.
+-a, and -i options are available when this module is installed.  The
+-i option will only work if the genders database has alternate node
+names listed as the value of the "altname" attribute and if the
+nodeattr command has the -r option available.
 .LP
 .B nodeupdown
 .LP
@@ -110,18 +115,19 @@ one per line.  The host list may contain hostname ranges of the form
 HOST RANGES section below.
 .LP
 .I "-x host,host,..."
-Exclude the specified hosts.  May be specified in conjunction with other
-target node list options such as -a. Hostname ranges may also be specified
-to the -x option (see HOST RANGES section below)
+Exclude the specified hosts.  May be specified in conjunction with
+other target node list options such as -a and -g. Hostname ranges may
+also be specified to the -x option (see HOST RANGES section below)
 .LP
 .I "-a"
 Target "all" nodes in the cluster.  Conflicts with -w and -g options.
 Available only if the genders, nodeattr, SDR, or machines module is
 installed.
 .LP
 .I "-v"
-In combination with -a, eliminate nodes that are down.  Available only
-if the SDR or nodeupdown module is installed.
+Eliminate target nodes that are down.  Available only if the SDR or
+nodeupdown module is installed.  On AIX, the -v option can only be
+used in conjunction with the -a option.
 .LP
 .I "-G"
 In combination with -a, include all partitions. Available only 
@@ -135,7 +141,8 @@ module is installed.
 .I "-i"
 In conjunction with -a or -g, request canonical hostnames.  The
 default is to use reliable hostnames.  Available only if the
-genders or nodeattr module is installed.
+genders or nodeattr module is installed.  On AIX, the -i option
+can only be used in conjunction with the -a option.
 .LP
 If none of the above options are specified, the WCOLL environment variable
 must point to a file that contains a list of nodes, one per line.  

pdsh.1.in

@@ -101,7 +101,9 @@ user a number of other possible options when running pdsh.
 .LP
 The genders module allows pdsh to access the genders database through
 the genders(3) library.  The -g, -a, and -i options are available when
-this module is installed.
+this module is installed.  The -i option will only work if the genders
+database has alternate node names listed as the value of the "altname"
+attribute.
 .LP
 .B machines
 .LP
@@ -114,7 +116,10 @@ when this  module is installed.
 The nodeattr module allows pdsh to access the genders database through
 the nodeattr(1) command.  This module is primarily needed for older
 systems that do not yet have the gender(3) library installed.  The -g,
--a, and -i options are available when this module is installed.
+-a, and -i options are available when this module is installed.  The
+-i option will only work if the genders database has alternate node
+names listed as the value of the "altname" attribute and if the
+nodeattr command has the -r option available.
 .LP
 .B nodeupdown
 .LP
@@ -142,18 +147,19 @@ one per line.  The host list may contain hostname ranges of the form
 HOST RANGES section below.
 .LP
 .I "-x host,host,..."
-Exclude the specified hosts.  May be specified in conjunction with other
-target node list options such as -a. Hostname ranges may also be specified
-to the -x option (see HOST RANGES section below)
+Exclude the specified hosts.  May be specified in conjunction with
+other target node list options such as -a and -g. Hostname ranges may
+also be specified to the -x option (see HOST RANGES section below)
 .LP
 .I "-a"
 Target "all" nodes in the cluster.  Conflicts with -w and -g options.
 Available only if the genders, nodeattr, SDR, or machines module is
 installed.
 .LP
 .I "-v"
-In combination with -a, eliminate nodes that are down.  Available only
-if the SDR or nodeupdown module is installed.
+Eliminate target nodes that are down.  Available only if the SDR or
+nodeupdown module is installed.  On AIX, the -v option can only be
+used in conjunction with the -a option.
 .LP
 .I "-G"
 In combination with -a, include all partitions. Available only 
@@ -162,12 +168,13 @@ if the SDR module is installed.
 .I "-g attribute"
 Target nodes that have the specified genders attribute.  Conflicts
 with -a and -w options.  Available only if the genders or nodeattr
-module is installed.
+module is installed.  
 .LP
 .I "-i"
 In conjunction with -a or -g, request canonical hostnames.  The
 default is to use reliable hostnames.  Available only if the
-genders or nodeattr module is installed.
+genders or nodeattr module is installed.  On AIX, the -i option
+can only be used in conjunction with the -a option.
 .LP
 If the rms module is installed, and the RMS_RESOURCEID environment
 variable is set to an allocated RMS resource, RMS will be queried for