openafs/tests
Marc Dionne 0a528a52f5 tests: Improve failure mode for unresolvable hostname
In the case of a host where gethostbyname is unable to resolve
the hostname, afstest_BuildTestConfig() may return NULL which
can cause several tests to crash.

Add a common function to look out for this condition and use it where
appropriate.  When it occurs, the current module is skipped and
the user gets an error message that indicates the configuration
problem.

Change-Id: I7216876eb2424368f415e5759e2b95009ad055b2
Reviewed-on: http://gerrit.openafs.org/9120
Reviewed-by: Derrick Brashear <shadow@your-file-system.com>
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Jeffrey Altman <jaltman@your-file-system.com>
2013-02-17 20:51:15 -08:00
..
auth tests: Improve failure mode for unresolvable hostname 2013-02-17 20:51:15 -08:00
bozo Introduce TAP tests of man pages for command_subcommand 2011-06-28 12:52:28 -07:00
bucoord Introduce TAP tests of man pages for command_subcommand 2011-06-28 12:52:28 -07:00
cmd cmd: exit status zero from -help 2012-09-11 11:38:57 -07:00
common tests: Improve failure mode for unresolvable hostname 2013-02-17 20:51:15 -08:00
kauth Introduce TAP tests of man pages for command_subcommand 2011-06-28 12:52:28 -07:00
opr opr: Don't confuse isLast and isEnd 2012-11-23 06:18:31 -08:00
ptserver Introduce TAP tests of man pages for command_subcommand 2011-06-28 12:52:28 -07:00
rpctestlib util: Convert to using libtool 2012-09-08 20:27:51 -07:00
rx rx: Make rxevent_Put NULL the event ptr being put 2012-12-01 09:51:31 -08:00
tap tests: Start using the upstream C TAP harness 2012-05-11 16:36:44 -07:00
tests-lib/perl5 Introduce TAP tests of man pages for command_subcommand 2011-06-28 12:52:28 -07:00
util tests: Start using the upstream C TAP harness 2012-05-11 16:36:44 -07:00
venus Introduce TAP tests of man pages for command_subcommand 2011-06-28 12:52:28 -07:00
volser tests: Improve failure mode for unresolvable hostname 2013-02-17 20:51:15 -08:00
.gitignore Import C TAP Harness 1.2 as a testing harness 2010-05-29 21:48:19 -07:00
libwrap TESTS: Add the libwrap script to "make check" to handle library paths 2012-04-16 06:02:53 -07:00
Makefile.in tests: Fix fallout from cleanup change 2012-11-01 10:51:53 -07:00
README correct whitespace errors in readme files 2013-01-07 07:40:46 -08:00
TESTS opr: Add dictionary implementation 2012-11-01 12:18:01 -07:00

This directory contains a test harness and the beginnings of what is
intended to become the primary OpenAFS test suite.  The tests in this
directory are run when "make check" is run at the top level of the OpenAFS
tree.

runtests is the test harness, and TESTS is the list of tests that it
will run.  If you add a new test, add it to TESTS as well.  All tests must
be executables (possibly shell scripts or Perl scripts) that end in either
".t" or "-t", but should be listed in TESTS without that suffix.

Tests should be organized into subdirectories, and where it makes sense to
do so, those subdirectories should match the subdirectory names under src
in the AFS source tree.  In other words, tests for src/util/* should go in
a directory named util, tests for the libkopenafs library should go in a
directory named kopenafs, and so forth.  To integrate with the build
system, each subdirectory will need to have its own Makefile.in and be
added to the list of generated Makefiles in configure.in at the top
level.   The Makefile.in in this directory will also need to be modified
to recurse into any new directories.  See util/Makefile.in for an example
of how to write a Makefile.in for a new test directory.

The files comprising the test harness are sourced from the C TAP Harness
distribution using the src/external mechanism. The upstream site for that
distribution is at:

    http://www.eyrie.org/~eagle/software/c-tap-harness/

but feel free to propose modifications directly through OpenAFS Gerrit.
Russ Allbery will take care of merging modifications upstream.  However,
OpenAFS-specific modifications should not be made to those files.  To add
additional OpenAFS-specific code to the TAP library, add additional *.c
and *.h (or *.sh) files to the tests/tap directory rather than modifying files
in src/external.

More information can be found in the HOWTO contained in
src/external/c-tap-harness/HOWTO