Module Name: src
Committed By: gdt
Date: Mon Jun 2 19:17:08 UTC 2014
Modified Files:
src/share/man/man7: tests.kyua.7
Log Message:
Add test environment considerations from tests.atf.7.
Bump date in an attempt to avoid provoking wizd(1).
To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/share/man/man7/tests.kyua.7
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man7/tests.kyua.7
diff -u src/share/man/man7/tests.kyua.7:1.3 src/share/man/man7/tests.kyua.7:1.4
--- src/share/man/man7/tests.kyua.7:1.3 Tue Mar 18 18:20:40 2014
+++ src/share/man/man7/tests.kyua.7 Mon Jun 2 19:17:08 2014
@@ -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 @@ $ kyua report-html --output ~/public_htm
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
