updated the docs some

META.yml

@@ -26,4 +26,4 @@ requires:
   Set::Scalar: 1.23
   Term::ReadKey: 2.30
   perl: 5.6.1
-version: 0.003
+version: 0.004

README

@@ -55,6 +55,9 @@ DESCRIPTION
 
     Parallel SSH communication is used to ensure minimal latency.
 
+TODO
+    *   Add a "-c" option to the scripts to limit ssh concurrency level.
+
 INSTALLATION
         perl Makefile.PL
         make

bin/atnodes

@@ -250,7 +250,7 @@ atnodes - Run command on clusters
 
 =head1 SEE ALSO
 
-L<fornodes>, L<tonodes>, L<SSH::Batch>, L<Net::OpenSSH>.
+L<fornodes>, L<tonodes>, L<key2nodes>, L<SSH::Batch>, L<Net::OpenSSH>.
 
 =head1 COPYRIGHT AND LICENSE
 

bin/fornodes

@@ -28,12 +28,19 @@ fornodes - Expand patterns to machine host list.
     $ cat > ~/.fornodesrc
     ps=blah.ps.com bloo.ps.com boo[2-25,32,41-70].ps.com
     as=ws[1101-1105].as.com
+    # use set operations to define new sets:
+    foo={ps} + {ps} * {as} - {ps} / {as}
     ^D
+
     $ fornodes 'api[02-10].foo.bar.com' 'boo*.ps.com'
     $ fornodes 'tq[ab-ac].[1101-1105].foo.com'
     $ fornodes '{ps} + {as} - ws1104.as.com'  # set union and subtraction
     $ fornodes '{ps} * {as}'  # set intersect
 
+=head1 SEE ALSO
+
+L<key2nodes>, L<atnodes>, L<tonodes>, L<SSH::Batch>, L<Net::OpenSSH>.
+
 =head1 COPYRIGHT AND LICENSE
 
 This module as well as its programs are licensed under the BSD License.

bin/tonodes

@@ -241,6 +241,10 @@ tonodes - Upload local files/directories to remote clusters
 
     $ tonodes /tmp/*.inst -- '{as}:/tmp/'
     $ tonodes foo.txt 'ws1105*' :/tmp/bar.txt
+
+    # use rsync instead of scp:
+    $ tonodes foo.txt 'ws1105*' :/tmp/bar.txt -rsync
+
     $ tonodes -r /opt /bin/* -- 'ws[1101-1102].foo.com' 'bar.com' :/foo/bar/
 
 =head1 USAGE
@@ -263,7 +267,7 @@ tonodes - Upload local files/directories to remote clusters
 
 =head1 SEE ALSO
 
-L<fornodes>, L<atnodes>, L<SSH::Batch>, L<Net::OpenSSH>.
+L<fornodes>, L<atnodes>, L<SSH::Batch>, L<key2nodes>, L<Net::OpenSSH>.
 
 =head1 COPYRIGHT AND LICENSE
 

lib/SSH/Batch.pm

@@ -25,7 +25,10 @@ Expand patterns to machine host list.
     $ cat > ~/.fornodesrc
     ps=blah.ps.com bloo.ps.com boo[2-25,32,41-70].ps.com
     as=ws[1101-1105].as.com
+    # use set operations to define new sets:
+    foo={ps} + {ps} * {as} - {ps} / {as}
     ^D
+
     $ fornodes 'api[02-10].foo.bar.com' 'boo*.ps.com'
     $ fornodes 'tq[ab-ac].[1101-1105].foo.com'
     $ fornodes '{ps} + {as} - ws1104.as.com'  # set union and subtraction
@@ -62,13 +65,23 @@ Upload local files/directories to remote clusters
 
     $ tonodes /tmp/*.inst -- '{as}:/tmp/'
     $ tonodes foo.txt 'ws1105*' :/tmp/bar.txt
+
+    # use rsync instead of scp:
+    $ tonodes foo.txt 'ws1105*' :/tmp/bar.txt -rsync
+
     $ tonodes -r /opt /bin/* -- 'ws[1101-1102].foo.com' 'bar.com' :/foo/bar/
 
+=item key2nodes
+
+Push the SSH public key (or generate one if not any) to the remote clusters.
+
+    $ key2nodes 'ws[1101-1105].as.com'
+
 =back
 
 =head1 DESCRIPTION
 
-This is a high-level abstraction over the powerful L<Net::OpenSSH> module. A bunch of handy scripts are provided to simplify big cluster operations: L<fornodes>, L<atnodes>, and L<tonodes>.
+This is a high-level abstraction over the powerful L<Net::OpenSSH> module. A bunch of handy scripts are provided to simplify big cluster operations: L<fornodes>, L<atnodes>, L<tonodes>, and L<key2nodes>.
 
 Parallel SSH communication is used to ensure minimal latency.
 
@@ -102,7 +115,8 @@ If you have a branch for me to pull, please let me know ;)
 
 =head1 SEE ALSO
 
-L<fornodes>, L<atnodes>, L<tonodes>, L<SSH::Batch::ForNodes>, L<Net::OpenSSH>.
+L<fornodes>, L<atnodes>, L<tonodes>, L<key2nodes>,
+L<SSH::Batch::ForNodes>, L<Net::OpenSSH>.
 
 =head1 COPYRIGHT AND LICENSE