openafs/tests
Andrew Deason 66d0f91791 tests: Wait for server start in auth/superuser-t
The auth/superuser-t test runs an Rx server and client in two child
processes. If the client process tries to contact the server before
the server has started listening on its port, some tests involving
RPCs can fail (notably test 39, "Can run a simple RPC").

Normally if we try to contact a server that's not there, Rx will try
resending its packets a few times, but on Linux with AFS_RXERRQ_ENV,
if the port isn't open at all, we can get an ICMP_PORT_UNREACH error,
which causes the relevant Rx call to die immediately with
RX_CALL_DEAD.

This means that if the auth/superuser-t client is only just a bit
faster than the server starting up, tests can fail, since the server's
port is not open yet.

To avoid this, we can wait until the server's port is open before
starting the client process. To do this, have the server process send
a SIGUSR1 to the parent after rx_Init() is called, and have the parent
process wait for the SIGUSR1 (waiting for a max of 5 seconds before
failing). This should guarantee that the server's port will be open by
the time the client starts running.

Note that before commit 086d1858 (LINUX: Include linux/time.h for
linux/errqueue.h), AFS_RXERRQ_ENV was mistakenly disabled on Linux
3.17+, so this issue was probably not possible on recent Linux before
that commit.

Change-Id: I0032a640b83c24f72c03e7bea100df5bc3d9ed4c
Reviewed-on: https://gerrit.openafs.org/14109
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
Reviewed-by: Cheyenne Wills <cwills@sinenomine.net>
2020-03-31 17:34:51 -04:00
..
auth tests: Wait for server start in auth/superuser-t 2020-03-31 17:34:51 -04:00
bozo tests: Fix manpage tests for objdir builds 2019-12-20 11:29:45 -05:00
bucoord tests: Fix manpage tests for objdir builds 2019-12-20 11:29:45 -05:00
cmd tests: Fix most tests for objdir builds 2019-12-13 00:03:21 -05:00
common tests: Wait for server start in auth/superuser-t 2020-03-31 17:34:51 -04:00
kauth tests: Fix manpage tests for objdir builds 2019-12-20 11:29:45 -05:00
opr tests: Add cache-t to .gitignore in tests/opr 2020-03-20 15:56:54 -04:00
ptserver tests: Fix manpage tests for objdir builds 2019-12-20 11:29:45 -05:00
rpctestlib Remove dead code 2019-08-23 09:36:44 -04:00
rx tests: Fix most tests for objdir builds 2019-12-13 00:03:21 -05:00
tap tests: Start using the upstream C TAP harness 2012-05-11 16:36:44 -07:00
tests-lib/perl5 tests: Fix manpage tests for objdir builds 2019-12-20 11:29:45 -05:00
util tests: Fix most tests for objdir builds 2019-12-13 00:03:21 -05:00
venus tests: Fix manpage tests for objdir builds 2019-12-20 11:29:45 -05:00
volser tests: skip vos tests when a vlserver is already running 2020-01-20 15:16:14 -05:00
.gitignore tests: Add core to .gitignore in tests 2020-03-20 15:56:12 -04:00
libwrap tests: use exec to call libwrap'd executables 2016-12-16 16:25:58 -05:00
Makefile.in tests: Fix most tests for objdir builds 2019-12-13 00:03:21 -05:00
README correct whitespace errors in readme files 2013-01-07 07:40:46 -08:00
TESTS tests: Run more manpage tests by default 2020-03-13 14:13:04 -04: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