1 /*-------------------------------------------------------------------------
2 timeout.c - source file for running ucSim within the regression tests
4 Written By - Bernhard Held . bernhard@bernhardheld.de (2001)
6 This program is free software; you can redistribute it and/or modify it
7 under the terms of the GNU General Public License as published by the
8 Free Software Foundation; either version 2, or (at your option) any
11 This program 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
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 In other words, you are welcome to use, share and improve this program.
21 You are forbidden to forbid anyone else to use, share and improve
22 what you give them. Help stamp out software-hoarding!
23 -------------------------------------------------------------------------*/
25 #define PROGNAME "timeout"
27 #define USAGE PROGNAME " : 1.00\n" \
28 "Usage : " PROGNAME " timeout_in_seconds filename [arguments]\n" \
29 " ´filename´ is executed, the arguments are passed to ´filename´.\n" \
30 " When ´filename´exits before the timeout expires, the\n" \
31 " exit-status of ´filename´ is returned.\n" \
32 " When the timeout expires before ´filename´ exits, ´filename´\n" \
33 " will be killed and an exit-status of 1 is returned.\n"
35 /* First the program tries to limit the maximum CPU-time to the timeout-value.
36 Then the child is run with execvp().
38 It's not possible to limit the CPU-time under Cygwin (V1.3.3). If setrlimit (RLIMIT_CPU, rlp)
39 fails, the program will fork() and run the child with execvp(). The fork/exec pair is slow on
40 Cygwin, but what else can we do? The parent sleeps until:
41 - a signal shows the child´s exitus
42 The exit status of the child is returned.
44 The child will be killed.
51 #include <sys/types.h>
52 #include <sys/resource.h>
54 /* Get the status from all child processes that have terminated, without ever waiting.
55 This function is designed to be a handler for SIGCHLD, the signal that indicates
56 that at least one child process has terminated.
57 http://www.cs.utah.edu/dept/old/texinfo/glibc-manual-0.02/library_23.html#SEC401
65 sigchld_handler (int signum)
73 pid = waitpid (WAIT_ANY, &status, WNOHANG);
74 if (WEXITSTATUS (status))
75 exit_status = 1; // WEXITSTATUS(status);
76 /* pid == -1: no children */
77 /* pid == 0: no children to be noticed */
85 main (int argc, char * const *argv)
87 /* if getrlimit() / setrlimit() succeed, then no fork is neeeded */
96 fprintf (stderr, USAGE);
99 timeout = atol (argv[1]);
102 fprintf (stderr, "Error parameter " PROGNAME ": must be a non-zero dezimal value\n");
106 /* try to use getrlimit() / setrlimit() for RLIMIT_CPU */
107 /* to limit the CPU-time */
108 if (getrlimit (RLIMIT_CPU, &rl) == 0)
110 rl.rlim_cur = timeout;
111 if (setrlimit (RLIMIT_CPU, &rl) == 0)
116 { /* the CPU-time is limited: simple execvp */
118 /* s51 prints warnings on stderr: */
119 /* serial input/output interface connected to a non-terminal file. */
120 /* We'll redirect here stderr to stdout, which will be redirected */
121 /* to /dev/null by the shell. The shell could also redirect stderr */
122 /* to /dev/null, but then this program doesn't have the chance to */
123 /* output any real error. */
124 old_stderr = dup (STDERR_FILENO);
125 dup2 (STDOUT_FILENO, STDERR_FILENO);
126 /* shouldn't return */
127 execvp (argv[2], argv + 2);
129 dup2 (old_stderr, STDERR_FILENO);
131 return 1; /* Error */
135 /* do it the hard way: fork/exec */
136 signal (SIGCHLD, sigchld_handler);
140 /* s51 prints warnings on stderr: */
141 /* serial input/output interface connected to a non-terminal file. */
142 /* We'll redirect here stderr to stdout, which will be redirected */
143 /* to /dev/null by the shell. The shell could also redirect stderr */
144 /* to /dev/null, but then this program doesn't have the chance to */
145 /* output any real error. */
146 old_stderr = dup (STDERR_FILENO);
147 dup2 (STDOUT_FILENO, STDERR_FILENO);
148 /* shouldn't return */
149 execvp (argv[2], argv + 2);
151 dup2 (old_stderr, STDERR_FILENO);
153 return 1; /* Error */
157 /* this timeout is hopefully aborted by a SIGCHLD */
159 fprintf (stderr, PROGNAME ": timeout, killing child %s\n", argv[2]);
160 kill (pid_child, SIGTERM);
161 return 1; /* Error */