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:
parent
c0722389d6
commit
10a750e953
@ -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
|
||||
|
@ -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 ,
|
||||
|
Loading…
Reference in New Issue
Block a user