Move testing instructions from afterboot(8) to tests(7) and change the

former to only provide a link to the latter.
This commit is contained in:
jmmv 2010-06-26 11:26:17 +00:00
parent c0722389d6
commit 10a750e953
2 changed files with 43 additions and 41 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: tests.7,v 1.1 2010/06/26 11:15:27 jmmv Exp $
.\" $NetBSD: tests.7,v 1.2 2010/06/26 11:26:17 jmmv Exp $
.\"
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -91,6 +91,18 @@ job, to ensure that any changes to the system (such as the installation of
third-party packages or manual modifications to configuration files) do not
introduce unexpected failures.
.El
.Ss Installing the tests
If you chose to install the
.Pa tests.tgz
distribution set while setting up your
.Nx
system, the tests are already available in
.Pa /usr/tests .
Otherwise, install the set now by running:
.Bd -literal -offset indent
# cd /
# tar xzpf /path/to/tests.tgz
.Ed
.Ss Running the tests
Use the following commands to run the whole test suite:
.Bd -literal -offset indent
@ -155,6 +167,30 @@ The following properties are recognized:
Specifies the name of a local, unprivileged user, that will be used by those
tests that need to perform checks as non-root.
.El
.Ss What to do if something fails?
If there is
.Em any failure
during the execution of the test suite, please considering reporting it to the
.Nx
developers so that the failure can be analyzed and fixed.
To do so, either send a message to the appropriate mailing list or file a
problem report.
For more details please refer to:
.Bl -bullet -offset indent -compact
.It
.Pa http://www.netbsd.org/mailinglists/
.It
.Pa http://www.netbsd.org/support/send-pr.html
.El
.Sh FILES
.Bl -tag -compact -width etcXatfXNetBSDXconfXX
.It Pa /etc/atf/NetBSD.conf
Configuration file for the
.Nx
test suite.
.It Pa /usr/tests/
Location of the test suites.
.El
.Sh SEE ALSO
.Xr atf 7
.Sh HISTORY

View File

@ -1,4 +1,4 @@
.\" $NetBSD: afterboot.8,v 1.46 2010/02/17 00:49:21 snj Exp $
.\" $NetBSD: afterboot.8,v 1.47 2010/06/26 11:26:17 jmmv Exp $
.\" $OpenBSD: afterboot.8,v 1.72 2002/02/22 02:02:33 miod Exp $
.\"
.\" Originally created by Marshall M. Midden -- 1997-10-20, m4@umn.edu
@ -59,7 +59,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd January 20, 2010
.Dd June 26, 2010
.Dt AFTERBOOT 8
.Os
.Sh NAME
@ -956,45 +956,10 @@ $ ./build.sh kernel=SOMEFILE
At this point, the system should be fully configured to your liking.
It is now a good time to ensure that the system behaves according to
its specifications and that it is stable on your hardware.
You can easily do so by running the test suites available at
.Pa /usr/tests/ ,
assuming that you installed the
.Pa tests.tgz
set.
If not, you can install it now by running:
.Bd -literal -offset indent
# cd /
# tar xzpf /path/to/tests.tgz
.Ed
.Pp
Once done, edit the
.Pa /etc/atf/NetBSD.conf
file to tune the configuration of the test suite, go to
.Pa /usr/tests/
hierarchy and use the
.Xr atf-run 1
and
.Xr atf-report 1
utilities to run all the tests in an automated way:
.Bd -literal -offset indent
# cd /usr/tests/
# atf-run | atf-report
.Ed
.Pp
Should any problems appear when running the test suite, please let the
.Nx
developers know by sending a message to the appropriate mailing list or
by sending a problem report.
For more details see:
.Bl -bullet -offset indent
.It
.Pa http://www.netbsd.org/mailinglists/
.It
.Pa http://www.netbsd.org/support/send-pr.html
.El
Please refer to
.Xr tests 7
for details on how to do so.
.Sh SEE ALSO
.Xr atf-report 1 ,
.Xr atf-run 1 ,
.Xr chgrp 1 ,
.Xr chmod 1 ,
.Xr config 1 ,
@ -1035,6 +1000,7 @@ For more details see:
.Xr hier 7 ,
.Xr hostname 7 ,
.Xr pkgsrc 7 ,
.Xr tests 7 ,
.Xr amd 8 ,
.Xr ccdconfig 8 ,
.Xr chown 8 ,