mirror of
https://sourceware.org/git/glibc.git
synced 2025-12-05 00:02:41 +03:00
bd0e88f05c
It can be useful to be able to write a single-threaded test but run it as part of a multi-threaded program simply to exercise glibc synchronization code paths, e.g. the malloc implementation. This commit adds support to enable this kind of testing. Tests that define TEST_IN_THREAD, either as TEST_THREAD_MAIN or TEST_THREAD_WORKER, and then use support infrastructure (by including test-driver.c) will be accordingly run in either the main thread, or in a second "worker" thread while the other thread waits. This can be used in new tests, or to easily make and run copies of existing tests without modifying the tests themselves. Reviewed-by: Florian Weimer <fweimer@redhat.com>
98 lines
3.5 KiB
C
98 lines
3.5 KiB
C
/* Interfaces for the test driver.
|
|
Copyright (C) 2016-2025 Free Software Foundation, Inc.
|
|
This file is part of the GNU C Library.
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with the GNU C Library; if not, see
|
|
<https://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef SUPPORT_TEST_DRIVER_H
|
|
#define SUPPORT_TEST_DRIVER_H
|
|
|
|
#include <sys/cdefs.h>
|
|
|
|
__BEGIN_DECLS
|
|
|
|
struct test_config
|
|
{
|
|
void (*prepare_function) (int argc, char **argv);
|
|
int (*test_function) (void);
|
|
int (*test_function_argv) (int argc, char **argv);
|
|
void (*cleanup_function) (void);
|
|
void (*cmdline_function) (int);
|
|
const void *options; /* Custom options if not NULL. */
|
|
int timeout; /* Test timeout in seconds. */
|
|
int expected_status; /* Expected exit status. */
|
|
int expected_signal; /* If non-zero, expect termination by signal. */
|
|
char no_mallopt; /* Boolean flag to disable mallopt. */
|
|
char no_setvbuf; /* Boolean flag to disable setvbuf. */
|
|
char run_command_mode; /* Boolean flag to indicate run-command-mode. */
|
|
const char *optstring; /* Short command line options. */
|
|
int test_in_thread; /* 0 => no threading, MAIN, WORKER. */
|
|
int (*test_in_thread_wrapper) (int, char **, const struct test_config *);
|
|
};
|
|
|
|
enum
|
|
{
|
|
/* Test exit status which indicates that the feature is
|
|
unsupported. */
|
|
EXIT_UNSUPPORTED = 77,
|
|
|
|
/* Default timeout is twenty seconds. Tests should normally
|
|
complete faster than this, but if they don't, that's abnormal
|
|
(a bug) anyways. */
|
|
DEFAULT_TIMEOUT = 20,
|
|
|
|
/* Used for command line argument parsing. */
|
|
OPT_DIRECT = 1000,
|
|
OPT_TESTDIR,
|
|
|
|
/* Used for TEST_IN_THREAD to run single-threaded tests in a
|
|
multi-threaded environment. */
|
|
TEST_THREAD_MAIN = 1,
|
|
TEST_THREAD_WORKER = 2,
|
|
};
|
|
|
|
/* Options provided by the test driver. */
|
|
#define TEST_DEFAULT_OPTIONS \
|
|
{ "verbose", no_argument, NULL, 'v' }, \
|
|
{ "direct", no_argument, NULL, OPT_DIRECT }, \
|
|
{ "test-dir", required_argument, NULL, OPT_TESTDIR }, \
|
|
|
|
/* The directory the test should use for temporary files. */
|
|
extern const char *test_dir;
|
|
|
|
/* The number of --verbose arguments specified during program
|
|
invocation. This variable can be used to control the verbosity of
|
|
tests. */
|
|
extern unsigned int test_verbose;
|
|
|
|
/* Output that is only emitted if at least one --verbose argument was
|
|
specified. */
|
|
#define verbose_printf(...) \
|
|
do { \
|
|
if (test_verbose > 0) \
|
|
printf (__VA_ARGS__); \
|
|
} while (0);
|
|
|
|
/* Tests that define -DTEST_IN_THREAD are run in a thread while an alternate
|
|
thread exists and waits on it. */
|
|
extern int support_test_in_thread_wrapper (int argc, char **argv,
|
|
const struct test_config *config);
|
|
|
|
int support_test_main (int argc, char **argv, const struct test_config *);
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* SUPPORT_TEST_DRIVER_H */
|