Home | History | Annotate | Download | only in pthread_exit
      1 /*
      2  * Copyright (c) 2004, Bull S.A..  All rights reserved.
      3  * Created by: Sebastien Decugis
      4 
      5  * This program is free software; you can redistribute it and/or modify it
      6  * under the terms of version 2 of the GNU General Public License as
      7  * published by the Free Software Foundation.
      8  *
      9  * This program is distributed in the hope that it would be useful, but
     10  * WITHOUT ANY WARRANTY; without even the implied warranty of
     11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
     12  *
     13  * You should have received a copy of the GNU General Public License along
     14  * with this program; if not, write the Free Software Foundation, Inc.,
     15  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
     16 
     17  * This sample test aims to check the following assertion:
     18  *
     19  * pthread_exit() terminates the current thread and
     20  * allows a call to pthread_join() on this thread retrieve
     21  * the argument (if the thread is not detached).
     22 
     23  * The steps are:
     24  *
     25  *  -> Create threads with different attributes (but all must be joinable)
     26  *  -> inside the thread, a call to pthread_exit() is made with a certain value.
     27  *  -> In the main thread, we join the thread and check the value is as expected.
     28 
     29  * The test fails if the values are different.
     30 
     31  */
     32 
     33  /* We are testing conformance to IEEE Std 1003.1, 2003 Edition */
     34 #define _POSIX_C_SOURCE 200112L
     35 
     36  /* Some routines are part of the XSI Extensions */
     37 #ifndef WITHOUT_XOPEN
     38 #define _XOPEN_SOURCE	600
     39 #endif
     40 
     41 /********************************************************************************************/
     42 /****************************** standard includes *****************************************/
     43 /********************************************************************************************/
     44 #include <pthread.h>
     45 #include <stdarg.h>
     46 #include <stdio.h>
     47 #include <stdlib.h>
     48 #include <string.h>
     49 #include <unistd.h>
     50 
     51 #include <sched.h>
     52 #include <semaphore.h>
     53 #include <errno.h>
     54 #include <assert.h>
     55 /********************************************************************************************/
     56 /******************************   Test framework   *****************************************/
     57 /********************************************************************************************/
     58 #include "../testfrmw/testfrmw.h"
     59 #include "../testfrmw/testfrmw.c"
     60  /* This header is responsible for defining the following macros:
     61   * UNRESOLVED(ret, descr);
     62   *    where descr is a description of the error and ret is an int (error code for example)
     63   * FAILED(descr);
     64   *    where descr is a short text saying why the test has failed.
     65   * PASSED();
     66   *    No parameter.
     67   *
     68   * Both three macros shall terminate the calling process.
     69   * The testcase shall not terminate in any other maneer.
     70   *
     71   * The other file defines the functions
     72   * void output_init()
     73   * void output(char * string, ...)
     74   *
     75   * Those may be used to output information.
     76   */
     77 
     78 /********************************************************************************************/
     79 /********************************** Configuration ******************************************/
     80 /********************************************************************************************/
     81 #ifndef VERBOSE
     82 #define VERBOSE 1
     83 #endif
     84 
     85 /********************************************************************************************/
     86 /***********************************    Test cases  *****************************************/
     87 /********************************************************************************************/
     88 
     89 #include "../testfrmw/threads_scenarii.c"
     90 
     91 /* This file will define the following objects:
     92  * scenarii: array of struct __scenario type.
     93  * NSCENAR : macro giving the total # of scenarii
     94  * scenar_init(): function to call before use the scenarii array.
     95  * scenar_fini(): function to call after end of use of the scenarii array.
     96  */
     97 
     98 /********************************************************************************************/
     99 /***********************************    Real Test   *****************************************/
    100 /********************************************************************************************/
    101 
    102 void *threaded(void *arg)
    103 {
    104 	pthread_exit(NULL + 1);
    105 
    106 	FAILED("pthread_exit() did not terminate the thread");
    107 
    108 	return NULL;
    109 }
    110 
    111 int main(void)
    112 {
    113 	int ret = 0;
    114 	void *rval;
    115 	pthread_t child;
    116 	int i;
    117 
    118 	output_init();
    119 
    120 	scenar_init();
    121 
    122 	for (i = 0; i < NSCENAR; i++) {
    123 		if (scenarii[i].detached == 0) {
    124 #if VERBOSE > 0
    125 			output("-----\n");
    126 			output("Starting test with scenario (%i): %s\n", i,
    127 			       scenarii[i].descr);
    128 #endif
    129 
    130 			ret =
    131 			    pthread_create(&child, &scenarii[i].ta, threaded,
    132 					   NULL);
    133 			switch (scenarii[i].result) {
    134 			case 0:	/* Operation was expected to succeed */
    135 				if (ret != 0) {
    136 					UNRESOLVED(ret,
    137 						   "Failed to create this thread");
    138 				}
    139 				break;
    140 
    141 			case 1:	/* Operation was expected to fail */
    142 				if (ret == 0) {
    143 					UNRESOLVED(-1,
    144 						   "An error was expected but the thread creation succeeded");
    145 				}
    146 				break;
    147 
    148 			case 2:	/* We did not know the expected result */
    149 			default:
    150 #if VERBOSE > 0
    151 				if (ret == 0) {
    152 					output
    153 					    ("Thread has been created successfully for this scenario\n");
    154 				} else {
    155 					output
    156 					    ("Thread creation failed with the error: %s\n",
    157 					     strerror(ret));
    158 				}
    159 #endif
    160 			}
    161 			if (ret == 0) {	/* The new thread is running */
    162 				ret = pthread_join(child, &rval);
    163 				if (ret != 0) {
    164 					UNRESOLVED(ret,
    165 						   "Unable to join a thread");
    166 				}
    167 
    168 				if (rval != (NULL + 1)) {
    169 					FAILED
    170 					    ("pthread_join() did not retrieve the pthread_exit() param");
    171 				}
    172 			}
    173 		}
    174 	}
    175 
    176 	scenar_fini();
    177 #if VERBOSE > 0
    178 	output("-----\n");
    179 	output("All test data destroyed\n");
    180 	output("Test PASSED\n");
    181 #endif
    182 
    183 	PASSED;
    184 }
    185