1/*
2 * Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
3 *
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms of version 2 of the GNU General Public License as
6 * published by the Free Software Foundation.
7 *
8 * This program is distributed in the hope that it would be useful, but
9 * WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
11 *
12 * Further, this software is distributed without any warranty that it is
13 * free of the rightful claim of any third person regarding infringement
14 * or the like.  Any license provided herein, whether implied or
15 * otherwise, applies only to this software file.  Patent licenses, if
16 * any, provided herein do not apply to combinations of this program with
17 * other software, or any other product whatsoever.
18 *
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22 *
23 * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
24 * Mountain View, CA  94043, or:
25 *
26 * http://www.sgi.com
27 *
28 * For further information regarding this notice, see:
29 *
30 * http://oss.sgi.com/projects/GenInfo/NoticeExplan/
31 */
32/* $Id: alarm01.c,v 1.6 2009/08/28 10:57:29 vapier Exp $ */
33/**********************************************************
34 *
35 *    OS Test - Silicon Graphics, Inc.
36 *
37 *    TEST IDENTIFIER	: alarm01
38 *
39 *    EXECUTED BY	: anyone
40 *
41 *    TEST TITLE	: Basic test for alarm(2)
42 *
43 *    PARENT DOCUMENT	: usctpl01
44 *
45 *    TEST CASE TOTAL	: 1
46 *
47 *    WALL CLOCK TIME	: 1
48 *
49 *    CPU TYPES		: ALL
50 *
51 *    AUTHOR		: William Roske
52 *
53 *    CO-PILOT		: Dave Fenner
54 *
55 *    DATE STARTED	: 03/30/92
56 *
57 *    INITIAL RELEASE	: UNICOS 7.0
58 *
59 *    TEST CASES
60 *
61 * 	1.) alarm(2) returns...(See Description)
62 *
63 *    INPUT SPECIFICATIONS
64 * 	The standard options for system call tests are accepted.
65 *	(See the parse_opts(3) man page).
66 *
67 *    OUTPUT SPECIFICATIONS
68 *$
69 *    DURATION
70 * 	Terminates - with frequency and infinite modes.
71 *
72 *    SIGNALS
73 * 	Uses SIGUSR1 to pause before test if option set.
74 * 	(See the parse_opts(3) man page).
75 *
76 *    RESOURCES
77 * 	None
78 *
79 *    ENVIRONMENTAL NEEDS
80 * 	The libcuts.a and libsys.a libraries must be included in
81 *	the compilation of this test.
82 *
83 *    SPECIAL PROCEDURAL REQUIREMENTS
84 * 	None
85 *
86 *    INTERCASE DEPENDENCIES
87 * 	None
88 *
89 *    DETAILED DESCRIPTION
90 *	This is a Phase I test for the alarm(2) system call.  It is intended
91 *	to provide a limited exposure of the system call, for now.  It
92 *	should/will be extended when full functional tests are written for
93 *	alarm(2).
94 *
95 * 	Setup:
96 * 	  Setup signal handling.
97 *	  Pause for SIGUSR1 if option specified.
98 *
99 * 	Test:
100 *	 Loop if the proper options are given.
101 * 	  Execute system call
102 *	  Check return code, if system call failed (return=-1)
103 *		Log the errno and Issue a FAIL message.
104 *	  Otherwise, Issue a PASS message.
105 *
106 * 	Cleanup:
107 * 	  Print errno log and/or timing stats if options given
108 *
109 *
110 *#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#*#**/
111
112#include <errno.h>
113#include <string.h>
114#include <signal.h>
115#include "test.h"
116
117void setup();
118void cleanup();
119
120char *TCID = "alarm01";
121int TST_TOTAL = 1;
122
123int main(int ac, char **av)
124{
125	int lc;
126
127	tst_parse_opts(ac, av, NULL, NULL);
128
129	setup();
130
131	for (lc = 0; TEST_LOOPING(lc); lc++) {
132
133		tst_count = 0;
134
135		/*
136		 * Call alarm(2)
137		 */
138		TEST(alarm(1));
139
140		/* check return code */
141		if (TEST_RETURN == -1)
142			tst_resm(TFAIL | TTERRNO, "alarm(1) failed");
143		else {
144			tst_resm(TPASS, "alarm(1) returned %ld",
145				 TEST_RETURN);
146		}
147
148	}
149
150	cleanup();
151	tst_exit();
152}
153
154void setup(void)
155{
156	void trapper();
157
158	tst_sig(NOFORK, DEF_HANDLER, cleanup);
159
160	signal(SIGALRM, trapper);
161
162	TEST_PAUSE;
163}
164
165/***************************************************************
166 * cleanup() - performs all ONE TIME cleanup for this test at
167 *		completion or premature exit.
168 ***************************************************************/
169void cleanup(void)
170{
171}
172
173void trapper(int sig)
174{
175	signal(SIGALRM, trapper);
176}
177