diff --git a/tsshbatch.rst b/tsshbatch.rst index 254b2de..ad566e7 100644 --- a/tsshbatch.rst +++ b/tsshbatch.rst @@ -9,7 +9,7 @@ -------- :: - tsshbatch.py [-KNSehktvxy -G 'file dest' -P 'file dest' -f cmdfile -n name -p pw ] -H 'host ..' | hostlistfile [command arg ... ] + tsshbatch.py [-KNSaehktvxy -G 'file dest' -P 'file dest' -f cmdfile -n name -p pw ] -H 'host ..' | hostlistfile [command arg ... ] DESCRIPTION @@ -81,6 +81,11 @@ -S Force prompting for sudo password + -T seconds Timeout for ssh connection attempts (Default: 15 seconds) + + -a Do not abort program after failed file transfers. + Continue to next transfer attempt. (Default: Abort) + -e Don't report remote host stderr output -f cmdfile Read commands from a file. This file can be commented @@ -445,8 +450,17 @@ tsshbatch.py -G"/etc/fstab ./tmp" -G"/etc/rc.conf ./tmp" ... - If any file transfer fails, for any reason, the program is aborted - and no further work is done. + By default, ``tsshbatch`` aborts if any file transfer fails. This + is unlike the case of failed commands which are reported but do + *not* abort the program. The rationale' for this is that you may + be doing both file transfer and command execution with a single + ``tsshbatch`` invocation, and the commands may depend on a file + being transfered first. + + If you are sure no such problem exists, you can use the ``-a`` option + to disable abort-after-failure semantics on file transfer. In this + case, file transfer errors will be reported, but ``tsshbatch`` will + continue on to the next transfer request. .. WARNING:: ``tsshbatch`` does *not* preserve file permissions when transferring files. Recall that commands are always @@ -748,7 +762,7 @@ :: - $Id: tsshbatch.rst,v 1.136 2014/03/27 23:40:59 tundra Exp $ + $Id: tsshbatch.rst,v 1.137 2014/03/28 21:01:32 tundra Exp $ You can find the latest version of this program at: