(timeout_handler): Fix error message.
[kopensolaris-gnu/glibc.git] / test-skeleton.c
1 /* Skeleton for test programs.
2    Copyright (C) 1998, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4    Contributed by Ulrich Drepper <drepper@cygnus.com>, 1998.
5
6    The GNU C Library is free software; you can redistribute it and/or
7    modify it under the terms of the GNU Lesser General Public
8    License as published by the Free Software Foundation; either
9    version 2.1 of the License, or (at your option) any later version.
10
11    The GNU C Library is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14    Lesser General Public License for more details.
15
16    You should have received a copy of the GNU Lesser General Public
17    License along with the GNU C Library; if not, write to the Free
18    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
19    02111-1307 USA.  */
20
21 #include <errno.h>
22 #include <getopt.h>
23 #include <search.h>
24 #include <signal.h>
25 #include <stdio.h>
26 #include <stdlib.h>
27 #include <string.h>
28 #include <unistd.h>
29 #include <sys/resource.h>
30 #include <sys/wait.h>
31 #include <sys/param.h>
32 #include <time.h>
33
34 /* The test function is normally called `do_test' and it is called
35    with argc and argv as the arguments.  We nevertheless provide the
36    possibility to overwrite this name.  */
37 #ifndef TEST_FUNCTION
38 # define TEST_FUNCTION do_test (argc, argv)
39 #endif
40
41 #ifndef TEST_DATA_LIMIT
42 # define TEST_DATA_LIMIT (64 << 20) /* Data limit (bytes) to run with.  */
43 #endif
44
45 #define OPT_DIRECT 1000
46 #define OPT_TESTDIR 1001
47
48 static struct option options[] =
49 {
50 #ifdef CMDLINE_OPTIONS
51   CMDLINE_OPTIONS
52 #endif
53   { "direct", no_argument, NULL, OPT_DIRECT },
54   { "test-dir", required_argument, NULL, OPT_TESTDIR },
55   { NULL, 0, NULL, 0 }
56 };
57
58 /* PID of the test itself.  */
59 static pid_t pid;
60
61 /* Directory to place temporary files in.  */
62 static const char *test_dir;
63
64 /* List of temporary files.  */
65 struct temp_name_list
66 {
67   struct qelem q;
68   const char *name;
69 } *temp_name_list;
70
71 /* Add temporary files in list.  */
72 static void
73 __attribute__ ((unused))
74 add_temp_file (const char *name)
75 {
76   struct temp_name_list *newp
77     = (struct temp_name_list *) calloc (sizeof (*newp), 1);
78   if (newp != NULL)
79     {
80       newp->name = name;
81       if (temp_name_list == NULL)
82         temp_name_list = (struct temp_name_list *) &newp->q;
83       else
84         insque (newp, temp_name_list);
85     }
86 }
87
88 /* Delete all temporary files.  */
89 static void
90 delete_temp_files (void)
91 {
92   while (temp_name_list != NULL)
93     {
94       remove (temp_name_list->name);
95       temp_name_list = (struct temp_name_list *) temp_name_list->q.q_forw;
96     }
97 }
98
99 /* Create a temporary file.  */
100 static int
101 __attribute__ ((unused))
102 create_temp_file (const char *base, char **filename)
103 {
104   char *fname;
105   int fd;
106
107   fname = (char *) malloc (strlen (test_dir) + 1 + strlen (base)
108                            + sizeof ("XXXXXX"));
109   if (fname == NULL)
110     {
111       puts ("out of memory");
112       return -1;
113     }
114   strcpy (stpcpy (stpcpy (stpcpy (fname, test_dir), "/"), base), "XXXXXX");
115
116   fd = mkstemp (fname);
117   if (fd == -1)
118     {
119       printf ("cannot open temporary file '%s': %m\n", fname);
120       free (fname);
121       return -1;
122     }
123
124   add_temp_file (fname);
125   if (filename != NULL)
126     *filename = fname;
127
128   return fd;
129 }
130
131 /* Timeout handler.  We kill the child and exit with an error.  */
132 static void
133 __attribute__ ((noreturn))
134 timeout_handler (int sig __attribute__ ((unused)))
135 {
136   int killed;
137   int status;
138
139   /* Send signal.  */
140   kill (pid, SIGKILL);
141
142   /* Wait for it to terminate.  */
143   int i;
144   for (i = 0; i < 5; ++i)
145     {
146       killed = waitpid (pid, &status, WNOHANG|WUNTRACED);
147       if (killed != 0)
148         break;
149
150       /* Delay, give the system time to process the kill.  If the
151          nanosleep() call return prematurely, all the better.  We
152          won't restart it since this probably means the child process
153          finally died.  */
154       struct timespec ts = { .tv_sec = 0, .tv_nsec = 100000000 };
155       nanosleep (&ts, NULL);
156     }
157   if (killed != 0 && killed != pid)
158     {
159       perror ("Failed to kill test process");
160       exit (1);
161     }
162
163 #ifdef CLEANUP_HANDLER
164   CLEANUP_HANDLER;
165 #endif
166
167   /* If we expected this signal: good!  */
168 #ifdef EXPECTED_SIGNAL
169   if (EXPECTED_SIGNAL == SIGALRM)
170     exit (0);
171 #endif
172
173   if (killed == 0 || (WIFSIGNALED (status) && WTERMSIG (status) == SIGKILL))
174     fputs ("Timed out: killed the child process\n", stderr);
175   else if (WIFSTOPPED (status))
176     fprintf (stderr, "Timed out: the child process was %s\n",
177              strsignal (WSTOPSIG (status)));
178   else if (WIFSIGNALED (status))
179     fprintf (stderr, "Timed out: the child process got signal %s\n",
180              strsignal (WTERMSIG (status)));
181   else
182     fprintf (stderr, "Timed out: killed the child process but it exited %d\n",
183              WEXITSTATUS (status));
184
185   /* Exit with an error.  */
186   exit (1);
187 }
188
189 /* We provide the entry point here.  */
190 int
191 main (int argc, char *argv[])
192 {
193   int direct = 0;       /* Directly call the test function?  */
194   int status;
195   int opt;
196   pid_t termpid;
197
198 #ifdef STDOUT_UNBUFFERED
199   setbuf (stdout, NULL);
200 #endif
201
202   while ((opt = getopt_long (argc, argv, "+", options, NULL)) != -1)
203     switch (opt)
204       {
205       case '?':
206         exit (1);
207       case OPT_DIRECT:
208         direct = 1;
209         break;
210       case OPT_TESTDIR:
211         test_dir = optarg;
212         break;
213 #ifdef CMDLINE_PROCESS
214         CMDLINE_PROCESS
215 #endif
216       }
217
218   /* Set TMPDIR to specified test directory.  */
219   if (test_dir != NULL)
220     {
221       setenv ("TMPDIR", test_dir, 1);
222
223       if (chdir (test_dir) < 0)
224         {
225           perror ("chdir");
226           exit (1);
227         }
228     }
229   else
230     {
231       test_dir = getenv ("TMPDIR");
232       if (test_dir == NULL || test_dir[0] == '\0')
233         test_dir = "/tmp";
234     }
235
236   /* Make sure we see all message, even those on stdout.  */
237   setvbuf (stdout, NULL, _IONBF, 0);
238
239   /* make sure temporary files are deleted.  */
240   atexit (delete_temp_files);
241
242   /* Correct for the possible parameters.  */
243   argv[optind - 1] = argv[0];
244   argv += optind - 1;
245   argc -= optind - 1;
246
247   /* Call the initializing function, if one is available.  */
248 #ifdef PREPARE
249   PREPARE (argc, argv);
250 #endif
251
252   /* If we are not expected to fork run the function immediately.  */
253   if (direct)
254     return TEST_FUNCTION;
255
256   /* Set up the test environment:
257      - prevent core dumps
258      - set up the timer
259      - fork and execute the function.  */
260
261   pid = fork ();
262   if (pid == 0)
263     {
264       /* This is the child.  */
265 #ifdef RLIMIT_CORE
266       /* Try to avoid dumping core.  */
267       struct rlimit core_limit;
268       core_limit.rlim_cur = 0;
269       core_limit.rlim_max = 0;
270       setrlimit (RLIMIT_CORE, &core_limit);
271 #endif
272
273 #ifdef RLIMIT_DATA
274       /* Try to avoid eating all memory if a test leaks.  */
275       struct rlimit data_limit;
276       if (getrlimit (RLIMIT_DATA, &data_limit) == 0)
277         {
278           if (TEST_DATA_LIMIT == RLIM_INFINITY)
279             data_limit.rlim_cur = data_limit.rlim_max;
280           else if (data_limit.rlim_cur > (rlim_t) TEST_DATA_LIMIT)
281             data_limit.rlim_cur = MIN ((rlim_t) TEST_DATA_LIMIT,
282                                        data_limit.rlim_max);
283           if (setrlimit (RLIMIT_DATA, &data_limit) < 0)
284             perror ("setrlimit: RLIMIT_DATA");
285         }
286       else
287         perror ("getrlimit: RLIMIT_DATA");
288 #endif
289
290       /* We put the test process in its own pgrp so that if it bogusly
291          generates any job control signals, they won't hit the whole build.  */
292       setpgid (0, 0);
293
294       /* Execute the test function and exit with the return value.   */
295       exit (TEST_FUNCTION);
296     }
297   else if (pid < 0)
298     {
299       perror ("Cannot fork test program");
300       exit (1);
301     }
302
303   /* Set timeout.  */
304 #ifndef TIMEOUT
305   /* Default timeout is two seconds.  */
306 # define TIMEOUT 2
307 #endif
308   signal (SIGALRM, timeout_handler);
309   alarm (TIMEOUT);
310
311   /* Wait for the regular termination.  */
312   termpid = TEMP_FAILURE_RETRY (waitpid (pid, &status, 0));
313   if (termpid == -1)
314     {
315       printf ("Waiting for test program failed: %m\n");
316       exit (1);
317     }
318   if (termpid != pid)
319     {
320       printf ("Oops, wrong test program terminated: expected %ld, got %ld\n",
321               (long int) pid, (long int) termpid);
322       exit (1);
323     }
324
325 #ifndef EXPECTED_SIGNAL
326   /* We don't expect any signal.  */
327 # define EXPECTED_SIGNAL 0
328 #endif
329   if (WTERMSIG (status) != EXPECTED_SIGNAL)
330     {
331       if (EXPECTED_SIGNAL != 0)
332         {
333           if (WTERMSIG (status) == 0)
334             fprintf (stderr,
335                      "Expected signal '%s' from child, got none\n",
336                      strsignal (EXPECTED_SIGNAL));
337           else
338             fprintf (stderr,
339                      "Incorrect signal from child: got `%s', need `%s'\n",
340                      strsignal (WTERMSIG (status)),
341                      strsignal (EXPECTED_SIGNAL));
342         }
343       else
344         fprintf (stderr, "Didn't expect signal from child: got `%s'\n",
345                  strsignal (WTERMSIG (status)));
346       exit (1);
347     }
348
349   /* Simply exit with the return value of the test.  */
350 #ifndef EXPECTED_STATUS
351   return WEXITSTATUS (status);
352 #else
353   if (WEXITSTATUS (status) != EXPECTED_STATUS)
354     {
355       fprintf (stderr, "Expected status %d, got %d\n",
356                EXPECTED_STATUS, WEXITSTATUS (status));
357       exit (1);
358     }
359
360   return 0;
361 #endif
362 }