tsshbatch / WHATSNEW.txt
WHATSNEW For 'tsshbatch' 1.212    (Wed Dec 10 09:42:08 CST 2014)


- Implemented .getfile and .putfile directives for specifying
  file transfers in a cmdfile.


- Quotation characters are no longer stripped in cmdfile file
  transfer specifications.



WHATSNEW For 'tsshbatch' 1.210    (Tue Dec  9 12:20:25 CST 2014)


- It is now possible to put file transfer specifications in cmdfiles.
  Each must be on its own line and in the same form as if it were
    provided on the command line:

    -G /path/to/srcfile destdir
    -P /path/to/srcfile destdir

  Any single- or double quotes will be removed.

- Added __LOGINNAME__ builtin.  For key exchange auth, this will just
  be the name of the user running tsshbatch.  When an explicit login
  name is provided, either via prompting or command line, that name
  will be returned by this variable.

- Implemented -s, "silent" option which suppresses all reporting and
  header noise and only returns the literal results of each command.




- Fixed bug that caused program to exit after a failed
  file transfer even when -a was specified.

WHATSNEW For 'tsshbatch' 1.204    (Thu Dec  4 18:33:10 CST 2014)


- Added the following builtin variables:

  __DATE__       # Date in YYYYMMDD format
  __DATETIME__   # Date and time in YYYYMMDDHHMMSS format
  __HOSTNAME__   # Full name of current host as passed to program
  __HOSTNUM__    # Count of host being processed, starting at 1
  __HOSTSHORT__  # Leftmost component of hostname as passed to program
  __TIME__       # Time in HHMMSS format

- Added an "execution variable".  This runs a command of your
  choosing (on the local machine) and assigns the results to
  a user-defined variable.
- Added -E to redirect all stderr output to stdout instead,

- Added -T timeout option (default is 15 sec).

- Added -a to allow program to continue after file transfer error.

- Added -l logging option. Defaults to /dev/null.  This fixes the error
  that was previously being reported:

    "No handlers could be found for logger "paramiko.transport"

- Added -q for "quieter" output.


- File transfers now properly preserve the file's permissions.

- Changed hostname separator from ':' to '-' when using the -G command.

- The <HOSTNAME> and <HOSTSHORT> builtins have been replaced
  with the new builtins described above.

- Error messages now more consistent and clear.

- Test mode now expands variable references to their values for
  all variables except the builtins above (which are only
  evaluated at runtime).

- Documentation has been rewritten and improved considerably.


- Fixed bug that prevented the proper dereferencing of
  __HOSTNAME|SHORT__ (formerly <HOSTNAME|SHORT>) in file transfer

- Fixed bug that prevented variable substitution in hostnames.

- Fixed bug that prevented '.define' variables from being substituted
  in file transfer specifications.

- Fixed bug that only recognized sudo invocations if they were the
  first statement on a command line.  All instances of the string
  "sudo " will now force sudo password prompting and processing.
  That string is ignored if it appears inside single- or double quotes.
- Fixed bug that intermittently occurred during password-based auth
  sessions because ssh-agent and key searching were still being used.

- Fixed error reporting blowout when key-exchange auth fails.

WHATSNEW For 'tsshbatch' 1.177    (Thu Mar 27 19:09:03 CDT 2014)

- Test mode is now the default.  Actual operation requires
  explicit use of the -x option.

- A new option, -K, has been added to force prompting for passwords.
  This is to provide a means to override a -k (key exchange)
  default if the user set it that way in the $TSSHBATCH environment

- It is now possible to substitute the name of the current host into
  either commands or file transfer specifications via the '<HOSTNAME>'
  and '<HOSTSHORT>' strings.  This allows commands and/or file
  transfers to behave in a host-specific manner.

WHATSNEW For 'tsshbatch' 1.171    (Fri Nov  1 12:08:31 CDT 2013)


  - Changed default behavior to pick up $USER from the environment and
    not prompt for it.

  - When prompting for username, now shows $USER or the user presented
    via -n as default if present.

  - Cosmetic changes in reporting output

  - Cleaned up sudo handling and reporting


  - A new option, -N, to forces prompting for username to overcome the
    new default behavior of using $USER or the name provided by -n
    without promptng.  This option also overrides any previous
    request for key exchange authentication.

  - A new option, -S, forces prompting for the sudo password, with the
    default being any previously provided password (interactive or -p).
    This allows you to use one password to authenticate to the system
    and a different one to do sudo promotion.

  - Two new options, -G and -P, support file transfer GETs and PUTs
    respectively from the selected hosts.

  - A new option, -f cmdfile, allows multiple commands stored
    in the file to be run on each of the selected hosts.  This
    allows for considerably more complex operations than the
    single command string at the end of the command line supported
    in previous versions.

  - A new option, -y, turns on 'noisy' reporting and produces
    context information (hostname, output stream, and command)
    for every line of output.  This makes the output more useful
    when filtered through something like 'grep'.

  - There is a new options, -t, to turn on "test mode" which
    will show what would be done, but will not actually do it.
    This mode also displays useful diagnostic information
    about the command line, variable defintions, file tranfer
    requests, and so on.

  - The new -x option is used to negate a prior -t and thereby
    force execution of the requested file transfers and/or

  - Both cmdfiles and hostlistfiles now support freeform whitespace
    and commenting via the "#" character.  

  - Both cmdfiles and hostlistfiles now support including other
    files via the .include directive.  Circular include detection
    is also implemented.

  - Both cmdfiles and hostlistfiles can contain variable
    definitions that are literally replaced in any following

WHATSNEW For 'tsshbatch' 1.137    (Fri Feb 22 15:30:24 CST 2013)

- Changed error reporting to place the entire message on a single line.

- Changed the manner of error reporting to provide more specific
  detail.  The original error messages could be misleading because
  both the inability to connect and an ssh rejection reported
  the exact same error.

WHATSNEW For 'tsshbatch' 1.134    (Tue Jan 17 09:00:04 CST 2012)

Initial public release