From 0eb69512575e1e2ccfec4c4489fa3fb6201d38d1 Mon Sep 17 00:00:00 2001 From: Joseph Myers Date: Wed, 31 Oct 2012 20:43:54 +0000 Subject: Document general use of test-wrapper and test-wrapper-env. --- manual/install.texi | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'manual/install.texi') diff --git a/manual/install.texi b/manual/install.texi index c82b918ca7..4802e699fe 100644 --- a/manual/install.texi +++ b/manual/install.texi @@ -233,6 +233,17 @@ the newly built binaries of @theglibc{}. The source and build directories must be visible at the same locations on both the build system and @var{hostname}. +In general, when testing @theglibc{}, @samp{test-wrapper} may be set +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 +working directory, all environment variables set as part of testing +and the standard input, output and error file descriptors. If +@samp{@var{test-wrapper} env} will not work to run a program with +environment variables set, then @samp{test-wrapper-env} must be set to +a program that runs a newly built program with environment variable +assignments in effect, those assignments being specified as +@samp{@var{var}=@var{value}} before the name of the program to be run. + @node Running make install @appendixsec Installing the C Library -- cgit v1.2.3