Document test-wrapper-env-only in INSTALL.

This commit is contained in:
Roland McGrath 2015-03-06 10:59:15 -08:00
parent 00f00cfc37
commit 4acc27ed0a
3 changed files with 25 additions and 9 deletions

View File

@ -1,3 +1,9 @@
2015-03-06 Roland McGrath <roland@hack.frob.com>
* manual/install.texi (Configuring and compiling):
Document test-wrapper-env-only.
* INSTALL: Regenerated.
2015-03-06 Paul Pluzhnikov <ppluzhnikov@google.com> 2015-03-06 Paul Pluzhnikov <ppluzhnikov@google.com>
[BZ #18043] [BZ #18043]

View File

@ -254,7 +254,12 @@ program that runs a newly built program with environment variable
assignments in effect, those assignments being specified as 'VAR=VALUE' assignments in effect, those assignments being specified as 'VAR=VALUE'
before the name of the program to be run. If multiple assignments to before the name of the program to be run. If multiple assignments to
the same variable are specified, the last assignment specified must take the same variable are specified, the last assignment specified must take
precedence. precedence. Similarly, if 'TEST-WRAPPER env -i' will not work to run a
program with an environment completely empty of variables except those
directly assigned, then 'test-wrapper-env-only' must be set; its use has
the same syntax as 'test-wrapper-env', the only difference in its
semantics being starting with an empty set of environment variables
rather than the ambient set.
Installing the C Library Installing the C Library
======================== ========================

View File

@ -283,14 +283,19 @@ In general, when testing @theglibc{}, @samp{test-wrapper} may be set
to the name and arguments of any program to run newly built binaries. to the name and arguments of any program to run newly built binaries.
This program must preserve the arguments to the binary being run, its This program must preserve the arguments to the binary being run, its
working directory and the standard input, output and error file working directory and the standard input, output and error file
descriptors. If descriptors. If @samp{@var{test-wrapper} env} will not work to run a
@samp{@var{test-wrapper} env} will not work to run a program with program with environment variables set, then @samp{test-wrapper-env}
environment variables set, then @samp{test-wrapper-env} must be set to must be set to a program that runs a newly built program with
a program that runs a newly built program with environment variable environment variable assignments in effect, those assignments being
assignments in effect, those assignments being specified as specified as @samp{@var{var}=@var{value}} before the name of the
@samp{@var{var}=@var{value}} before the name of the program to be program to be run. If multiple assignments to the same variable are
run. If multiple assignments to the same variable are specified, specified, the last assignment specified must take precedence.
the last assignment specified must take precedence. Similarly, if @samp{@var{test-wrapper} env -i} will not work to run a
program with an environment completely empty of variables except those
directly assigned, then @samp{test-wrapper-env-only} must be set; its
use has the same syntax as @samp{test-wrapper-env}, the only
difference in its semantics being starting with an empty set of
environment variables rather than the ambient set.
@node Running make install @node Running make install