[src/trunk]: src/share/man/man7 Add test environment considerations from test...

[gdt <gdt%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/4a91f27732df
branches:  trunk
changeset: 796423:4a91f27732df
user:      gdt <gdt%NetBSD.org@localhost>
date:      Mon Jun 02 19:17:08 2014 +0000

description:
Add test environment considerations from tests.atf.7.

Bump date in an attempt to avoid provoking wizd(1).

diffstat:

 share/man/man7/tests.kyua.7 |  19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)

diffs (40 lines):

diff -r a7995a38e9e8 -r 4a91f27732df share/man/man7/tests.kyua.7
--- a/share/man/man7/tests.kyua.7       Mon Jun 02 19:16:10 2014 +0000
+++ b/share/man/man7/tests.kyua.7       Mon Jun 02 19:17:08 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: tests.kyua.7,v 1.3 2014/03/18 18:20:40 riastradh Exp $
+.\"    $NetBSD: tests.kyua.7,v 1.4 2014/06/02 19:17:08 gdt Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
 .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 24, 2013
+.Dd June 2, 2014
 .Dt TESTS 7
 .Os
 .Sh NAME
@@ -138,6 +138,21 @@
 For further details on the command-line interface of Kyua, please refer
 to its manual page
 .Xr kyua 1 .
+.Ss Test environment considerations
+Tests can be invoked as an unprivileged user, in which case tests that
+require privileges will be skipped.
+If run as root, an unprivileged user will be used for tests that
+require privileges.
+For maximal coverage, the standard approach is to invoke tests as root.
+.Pp
+Ideally, tests are self-contained and do not either depend on or
+perturb the host environment, aside from skipping tests when optional
+facilities are not available.
+In reality, tests load and unload modules, and do other things that
+might cause problems.
+While it is not entirely safe to run tests on a multi-user system,
+permanent problems or crashes from doing so are viewed as bugs and
+should be reported.
 .Ss Configuring the tests
 Some test cases in the
 .Nx