winsup/testsuite/winsup.api/ltp/alarm01.c

   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., 59
  21  * Temple Place - Suite 330, Boston MA 02111-1307, 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$ */
  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 #include "usctest.h"
 117
 118 extern void setup();
 119 extern void cleanup();
 120
 121
 122
 123 const char *TCID="alarm01";             /* Test program identifier.    */
 124 int TST_TOTAL=1;                /* Total number of test cases. */
 125 extern int Tst_count;           /* Test Case counter for tst_* routines */
 126
 127
 128 int
 129 main(int ac, char **av)
 130 {
 131     int lc;             /* loop counter */
 132     const char *msg;            /* message returned from parse_opts */
 133
 134     /***************************************************************
 135      * parse standard options
 136      ***************************************************************/
 137     if ( (msg=parse_opts(ac, av, (option_t *) NULL, NULL)) != (char *) NULL ) {
 138         tst_brkm(TBROK, NULL, "OPTION PARSING ERROR - %s", msg);
 139         tst_exit();
 140     }
 141
 142     /***************************************************************
 143      * perform global setup for test
 144      ***************************************************************/
 145     setup();
 146
 147     /***************************************************************
 148      * check looping state if -c option given
 149      ***************************************************************/
 150     for (lc=0; TEST_LOOPING(lc); lc++) {
 151
 152         /* reset Tst_count in case we are looping. */
 153         Tst_count=0;
 154
 155         /*
 156          * Call alarm(2)
 157          */
 158         TEST(alarm(1));
 159
 160         /* check return code */
 161         if ( TEST_RETURN == -1 ) {
 162             tst_resm(TFAIL, "alarm(1) Failed, errno=%d : %s",
 163                      TEST_ERRNO, strerror(TEST_ERRNO));
 164         } else {
 165
 166             /***************************************************************
 167              * only perform functional verification if flag set (-f not given)
 168              ***************************************************************/
 169             if ( STD_FUNCTIONAL_TEST ) {
 170                 /* No Verification test, yet... */
 171                 tst_resm(TPASS, "alarm(1) returned %d", TEST_RETURN);
 172             }
 173         }
 174
 175     }   /* End for TEST_LOOPING */
 176
 177     /***************************************************************
 178      * cleanup and exit
 179      ***************************************************************/
 180     cleanup();
 181
 182     return 0;
 183 }       /* End main */
 184
 185 /***************************************************************
 186  * setup() - performs all ONE TIME setup for this test.
 187  ***************************************************************/
 188 void
 189 setup()
 190 {
 191     void trapper();
 192
 193     /* capture signals */
 194     tst_sig(NOFORK, DEF_HANDLER, cleanup);
 195
 196     signal(SIGALRM, trapper);
 197
 198     /* Pause if that option was specified */
 199     TEST_PAUSE;
 200 }       /* End setup() */
 201
 202
 203 /***************************************************************
 204  * cleanup() - performs all ONE TIME cleanup for this test at
 205  *              completion or premature exit.
 206  ***************************************************************/
 207 void
 208 cleanup()
 209 {
 210     /*
 211      * print timing stats if that option was specified.
 212      * print errno log if that option was specified.
 213      */
 214     TEST_CLEANUP;
 215
 216     /* exit with return code appropriate for results */
 217     tst_exit();
 218 }       /* End cleanup() */
 219
 220 void
 221 trapper(sig)
 222 int sig;
 223 {
 224    signal(SIGALRM, trapper);
 225 }
 226