-/* Skeleton for test programs.
- Copyright (C) 1998, 2000 Free Software Foundation, Inc.
+/* Legacy test skeleton.
+ Copyright (C) 1998-2024 Free Software Foundation, Inc.
This file is part of the GNU C Library.
- Contributed by Ulrich Drepper <drepper@cygnus.com>, 1998.
The GNU C Library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
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, write to the Free
- Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
- 02111-1307 USA. */
-
+ License along with the GNU C Library; if not, see
+ <https://www.gnu.org/licenses/>. */
+
+/* This test skeleton is to support running existing tests. New tests
+ should use <support/test-driver.c> instead; see the documentation
+ in that file for instructions, and <support/README-testing.c> for a
+ minimal example. */
+
+/* This list of headers is needed so that tests which include
+ "../test-skeleton.c" at the beginning still compile. */
+#include <assert.h>
+#include <errno.h>
+#include <fcntl.h>
#include <getopt.h>
+#include <malloc.h>
+#include <paths.h>
#include <search.h>
#include <signal.h>
#include <stdio.h>
#include <unistd.h>
#include <sys/resource.h>
#include <sys/wait.h>
-
-/* The test function is normally called `do_test' and it is called
- with argc and argv as the arguments. We nevertheless provide the
- possibility to overwrite this name. */
-#ifndef TEST_FUNCTION
-# define TEST_FUNCTION do_test (argc, argv)
-#endif
-
-
-#define OPT_DIRECT 1000
-#define OPT_TESTDIR 1001
-
-static struct option options[] =
+#include <sys/param.h>
+#include <time.h>
+#include <stdint.h>
+
+#include <support/support.h>
+#include <support/check.h>
+#include <support/xsignal.h>
+#include <support/temp_file.h>
+
+/* TEST_FUNCTION is no longer used. */
+static int
+legacy_test_function (int argc __attribute__ ((unused)),
+ char **argv __attribute__ ((unused)))
{
-#ifdef CMDLINE_OPTIONS
- CMDLINE_OPTIONS
+#ifdef TEST_FUNCTION
+ return TEST_FUNCTION;
+# undef TEST_FUNCTION
+#else
+ return do_test (argc, argv);
#endif
- { "direct", no_argument, NULL, OPT_DIRECT },
- { "test-dir", required_argument, NULL, OPT_TESTDIR },
- { NULL, 0, NULL, 0 }
-};
-
-/* PID of the test itself. */
-static int pid;
-
-/* Directory to place temporary files in. */
-static const char *test_dir;
-
-/* List of temporary files. */
-struct temp_name_list
-{
- struct qelem q;
- const char *name;
-} *temp_name_list;
-
-/* Add temporary files in list. */
-static void
-add_temp_file (const char *name)
-{
- struct temp_name_list *newp
- = (struct temp_name_list *) calloc (sizeof (*newp), 1);
- if (newp != NULL)
- {
- newp->name = name;
- if (temp_name_list == NULL)
- temp_name_list = (struct temp_name_list *) &newp->q;
- else
- insque (newp, temp_name_list);
- }
}
+#define TEST_FUNCTION_ARGV legacy_test_function
-/* Delete all temporary files. */
+/* PREPARE is a function name in the new skeleton. */
+#ifdef PREPARE
static void
-delete_temp_files (void)
+legacy_prepare_function (int argc __attribute__ ((unused)),
+ char **argv __attribute__ ((unused)))
{
- while (temp_name_list != NULL)
- {
- remove (temp_name_list->name);
- temp_name_list = (struct temp_name_list *) temp_name_list->q.q_forw;
- }
+ PREPARE (argc, argv);
}
+# undef PREPARE
+# define PREPARE legacy_prepare_function
+#endif
-/* Timeout handler. We kill the child and exit with an error. */
+/* CLEANUP_HANDLER is a function name in the new skeleton. */
+#ifdef CLEANUP_HANDLER
static void
-__attribute__ ((noreturn))
-timeout_handler (int sig __attribute__ ((unused)))
+legacy_cleanup_handler_function (void)
{
- int killed;
-
- /* Send signal. */
- kill (pid, SIGKILL);
-
- /* Wait for it to terminate. */
- killed = waitpid (pid, NULL, WNOHANG);
- if (killed != 0 && killed != pid)
- {
- perror ("Failed to killed test process");
- exit (1);
- }
-
-#ifdef CLEANUP_HANDLER
CLEANUP_HANDLER;
-#endif
-
- fputs ("Timed out: killed the child process\n", stderr);
-
- /* Exit with an error. */
- exit (1);
}
-
-/* We provide the entry point here. */
-int
-main (int argc, char *argv[])
-{
- int direct = 0; /* Directly call the test function? */
- int status;
- int opt;
-
-#ifdef STDOUT_UNBUFFERED
- setbuf (stdout, NULL);
+# undef CLEANUP_HANDLER
+# define CLEANUP_HANDLER legacy_cleanup_handler_function
#endif
- while ((opt = getopt_long (argc, argv, "", options, NULL)) != -1)
- switch (opt)
- {
- case '?':
- exit (1);
- case OPT_DIRECT:
- direct = 1;
- break;
- case OPT_TESTDIR:
- test_dir = optarg;
- break;
+/* CMDLINE_PROCESS is a function name in the new skeleton. */
#ifdef CMDLINE_PROCESS
- CMDLINE_PROCESS
-#endif
- }
-
- /* Set TMPDIR to specified test directory. */
- if (test_dir != NULL)
- {
- setenv ("TMPDIR", test_dir, 1);
-
- if (chdir (test_dir) < 0)
- {
- perror ("chdir");
- exit (1);
- }
- }
- else
- {
- test_dir = getenv ("TMPDIR");
- if (test_dir == NULL || test_dir[0] == '\0')
- test_dir = "/tmp";
- }
-
- /* Make sure we see all message, even those on stdout. */
- setvbuf (stdout, NULL, _IONBF, 0);
-
- /* make sure temporary files are deleted. */
- atexit (delete_temp_files);
-
- /* Correct for the possible parameters. */
- argv += optind - 1;
- argc -= optind - 1;
-
- /* Call the initializing function, if one is available. */
-#ifdef PREPARE
- PREPARE (argc, argv);
-#endif
-
- /* If we are not expected to fork run the function immediately. */
- if (direct)
- return TEST_FUNCTION;
-
- /* Set up the test environment:
- - prevent core dumps
- - set up the timer
- - fork and execute the function. */
-
- pid = fork ();
- if (pid == 0)
- {
- /* This is the child. */
-#ifdef RLIMIT_CORE
- /* Try to avoid dumping core. */
- struct rlimit core_limit;
- core_limit.rlim_cur = 0;
- core_limit.rlim_max = 0;
- setrlimit (RLIMIT_CORE, &core_limit);
-#endif
-
- /* Execute the test function and exit with the return value. */
- exit (TEST_FUNCTION);
- }
- else if (pid < 0)
+static void
+legacy_cmdline_process_function (int c)
+{
+ switch (c)
{
- perror ("Cannot fork test program");
- exit (1);
+ CMDLINE_PROCESS
}
-
- /* Set timeout. */
-#ifndef TIMEOUT
- /* Default timeout is two seconds. */
-# define TIMEOUT 2
+}
+# undef CMDLINE_PROCESS
+# define CMDLINE_PROCESS legacy_cmdline_process_function
#endif
- alarm (TIMEOUT);
- signal (SIGALRM, timeout_handler);
-
- /* Wait for the regular termination. */
- if (waitpid (pid, &status, 0) != pid)
- {
- perror ("Oops, wrong test program terminated");
- exit (1);
- }
-#ifndef EXPECTED_SIGNAL
- /* We don't expect any signal. */
-# define EXPECTED_SIGNAL 0
-#endif
- if (WTERMSIG (status) != EXPECTED_SIGNAL)
- {
- if (EXPECTED_SIGNAL != 0)
- fprintf (stderr, "Incorrect signal from child: got `%s', need `%s'\n",
- strsignal (WTERMSIG (status)), strsignal (EXPECTED_SIGNAL));
- else
- fprintf (stderr, "Didn't expect signal from child: got `%s'\n",
- strsignal (WTERMSIG (status)));
- exit (1);
- }
+/* Include the new test-skeleton. */
+#include <support/test-driver.c>
- /* Simply exit with the return value of the test. */
- return WEXITSTATUS (status);
-}
+/* The following functionality is only available if <pthread.h> was
+ included before this file. */
+#ifdef _PTHREAD_H
+# include <support/xthread.h>
+#endif /* _PTHREAD_H */