diff --git a/tsshbatch.rst b/tsshbatch.rst index 8eb9dec..6979545 100644 --- a/tsshbatch.rst +++ b/tsshbatch.rst @@ -818,6 +818,26 @@ Builtin Variables ================= +As noted previously, Builtin Variables are created by ``tsshbatch`` +itself. They are created for each new host connection so that things +like time, host number, and hostname are up-to-date. + +As of this release, ``tsshbatch`` supports the following Builtins: + + ==================== =============================================== + ``__DATE__`` Date in YYYYMMDD format + ``__DATETIME__`` Date and time in YYYYMMDDHHMMSS format + ``__HOSTNAME__`` Full name of current host as passed to ``tsshbatch`` + ``__HOSTNUM__`` Count of host being processed, starting at 1 + ``__HOSTSHORT__`` Leftmost component of hostname as passed to ``tsshbatch`` + ``__TIME__`` Time in HHMMSS format + ==================== =============================================== + + +Using Builtin Variables +======================= + + There are times when it's convenient to be able to embed the name of the current host in either a command or in a file transfer specification. For example, suppose you want to use a single @@ -871,7 +891,7 @@ else for whatever reason. You'd create a command file with this entry:: - __HOSTNAME__ = Really A Different Name + .define __HOSTNAME__ = Really A Different Name Now, when you run the command above, the output is:: @@ -969,6 +989,7 @@ There is no known workaround for this problem. + COPYRIGHT AND LICENSING ----------------------- @@ -994,7 +1015,7 @@ :: - $Id: tsshbatch.rst,v 1.145 2014/12/04 21:42:52 tundra Exp $ + $Id: tsshbatch.rst,v 1.146 2014/12/04 22:03:42 tundra Exp $ You can find the latest version of this program at: