From 5d4a682a55a8978ab144a3b026e7db8b2c799f5c Mon Sep 17 00:00:00 2001 From: Sergey Poznyakoff Date: Wed, 31 Oct 2007 12:57:04 +0000 Subject: [PATCH] Update --- ChangeLog | 9 +++++++++ NEWS | 7 ++++++- doc/tar.texi | 44 +++++++++++++++++++++++++++++++++++++++----- 3 files changed, 54 insertions(+), 6 deletions(-) diff --git a/ChangeLog b/ChangeLog index 068f8cc..7149001 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,12 @@ +2007-10-31 Sergey Poznyakoff + + * src/checkpoint.c: New actions: bell and ttyout + * src/system.c (sys_exec_info_script) + (sys_exec_checkpoint_script): pass the current blocking factor in + TAR_BLOCKING_FACTOR environment variable. + * doc/tar.texi: Update + * NEWS: Update + 2007-10-30 Sergey Poznyakoff * doc/Makefile.am: Use texi2html and the CVS version of gendocs.sh diff --git a/NEWS b/NEWS index 394925c..f454e4c 100644 --- a/NEWS +++ b/NEWS @@ -1,4 +1,4 @@ -GNU tar NEWS - User visible changes. 2007-10-29 +GNU tar NEWS - User visible changes. 2007-10-31 Please send GNU tar bug reports to @@ -26,6 +26,11 @@ echo=string, and sleep=value. Any number of `--checkpoint-action' options can be specified, the actions will be executed in order of their appearance in the command line. +* Info (end-of-volume) scripts + +The value of the blocking factor is made available to info and +checkpoint scripts via environment variable TAR_BLOCKING_FACTOR. + version 1.19 - Sergey Poznyakoff, 2007-10-10 diff --git a/doc/tar.texi b/doc/tar.texi index 1084e47..777d233 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -2460,6 +2460,13 @@ for a complete description. The @var{action} argument can be one of the following: @table @asis +@item bell +Produce an audible bell on the console. + +@item dot +@itemx . +Print a single dot on the standard listing stream. + @item echo Display a textual message on the standard error, with the status and number of the checkpoint. This is the default. @@ -2468,15 +2475,14 @@ number of the checkpoint. This is the default. Display @var{string} on the standard error. Before output, the string is subject to meta-character expansion. -@item dot -@itemx . -Print a single dot on the standard listing stream. +@item exec=@var{command} +Execute the given @var{command}. @item sleep=@var{time} Wait for @var{time} seconds. -@item exec=@var{command} -Execute the given @var{command}. +@item ttyout=@var{string} +Output @var{string} on the current console (@file{/dev/tty}). @end table Several @option{--checkpoint-action} options can be specified. The @@ -3805,6 +3811,26 @@ audible bell and the message described above at each checkpoint: --checkpoint-action='echo=\aHit %s checkpoint #%u' @end smallexample +@cindex @code{bell}, checkpoint action +There is also a special action which produces an audible signal: +@samp{bell}. It is not equivalent to @samp{echo='\a'}, because +@samp{bell} sends the bell directly to the console (@file{/dev/tty}), +whereas @samp{echo='\a'} sends it to the standard error. + +@cindex @code{ttyout}, checkpoint action +The @samp{ttyout=@var{string}} action outputs @var{string} to +@file{/dev/tty}, so it can be used even if the standard output is +redirected elsewhere. The @var{string} is subject to the same +modifications as with @samp{echo} action. In contrast to the latter, +@samp{ttyout} does not prepend @command{tar} executable name to the +string, nor does it output a newline after it. For example, the +following action will print the checkpoint message at the same screen +line, overwriting any previous message: + +@smallexample +--checkpoint-action="ttyout=\rHit %s checkpoint #%u" +@end smallexample + @cindex @code{dot}, checkpoint action Another available checkpoint action is @samp{dot} (or @samp{.}). It instructs @command{tar} to print a single dot on the standard listing @@ -3849,6 +3875,10 @@ additional arguments. Its exit code is ignored. It gets a copy of @item TAR_ARCHIVE The name of the archive @command{tar} is processing. +@vrindex TAR_BLOCKING_FACTOR, checkpoint script environment +@item TAR_BLOCKING_FACTOR +Current blocking factor (@pxref{Blocking}. + @vrindex TAR_CHECKPOINT, checkpoint script environment @item TAR_CHECKPOINT The checkpoint number. @@ -10621,6 +10651,10 @@ environment variables: @item TAR_ARCHIVE The name of the archive @command{tar} is processing. +@vrindex TAR_BLOCKING_FACTOR, info script environment variable +@item TAR_BLOCKING_FACTOR +Current blocking factor (@pxref{Blocking}. + @vrindex TAR_VOLUME, info script environment variable @item TAR_VOLUME Ordinal number of the volume @command{tar} is about to start. -- 2.44.0