text: /*
  * Copyright (c) 2005, Bull S.A..  All rights reserved.
  * Created by: Sebastien Decugis
  
  * This program is free software; you can redistribute it and/or modify it
  * under the terms of version 2 of the GNU General Public License as
  * published by the Free Software Foundation.
  *
  * This program is distributed in the hope that it would be useful, but
  * WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  *
  * You should have received a copy of the GNU General Public License along
  * with this program; if not, write the Free Software Foundation, Inc., 59
  * Temple Place - Suite 330, Boston MA 02111-1307, USA.
  
  
  * This sample test aims to check the following assertions:
  *
  * If SA_SIGINFO is not set in sa_flags, sa_handler is used as the signal 
  * handling function.
  
  * The steps are:
  * -> register a handler for SIGALRM without SA_SIGINFO, and a known function
  *   as saèhandler
  * -> raise SIGALRM, and check the function has been called.
  
  * The test fails if the function is not called
  */
  
  
  /* We are testing conformance to IEEE Std 1003.1, 2003 Edition */
  #define _POSIX_C_SOURCE 200112L
  
  /******************************************************************************/
  /*************************** standard includes ********************************/
  /******************************************************************************/
  #include <pthread.h>
  #include <stdarg.h>
  #include <stdio.h>
  #include <stdlib.h>
  #include <string.h>
  #include <unistd.h>
  
  #include <signal.h>
  #include <errno.h>
  
  /******************************************************************************/
  /***************************   Test framework   *******************************/
  /******************************************************************************/
  #include "testfrmw.h"
  #include "testfrmw.c" 
  /* This header is responsible for defining the following macros:
   * UNRESOLVED(ret, descr);  
   *    where descr is a description of the error and ret is an int 
   *   (error code for example)
   * FAILED(descr);
   *    where descr is a short text saying why the test has failed.
   * PASSED();
   *    No parameter.
   * 
   * Both three macros shall terminate the calling process.
   * The testcase shall not terminate in any other maneer.
   * 
   * The other file defines the functions
   * void output_init()
   * void output(char * string, ...)
   * 
   * Those may be used to output information.
   */
  
  /******************************************************************************/
  /**************************** Configuration ***********************************/
  /******************************************************************************/
  #ifndef VERBOSE
  #define VERBOSE 1
  #endif
  
  #define SIGNAL SIGALRM
  
  /******************************************************************************/
  /***************************    Test case   ***********************************/
  /******************************************************************************/
  
  int called = 0;
  void handler( int sig )
  {
  	called = 1;
  }
  
  /* main function */
  int main()
  {
  	int ret;
  
  	struct sigaction sa;
  
  	/* Initialize output */
  	output_init();
  
  	/* Set the signal handler */
  	sa.sa_flags = 0;
  	sa.sa_handler = handler;
  	ret = sigemptyset( &sa.sa_mask );
  
  	if ( ret != 0 )
  	{
  		UNRESOLVED( ret, "Failed to empty signal set" );
  	}
  
  	/* Install the signal handler for SIGALRM */
  	ret = sigaction( SIGNAL, &sa, 0 );
  
  	if ( ret != 0 )
  	{
  		UNRESOLVED( ret, "Failed to set signal handler" );
  	}
  
  	if ( called )
  	{
  		FAILED( "The signal handler has been called when no signal was raised" );
  	}
  
  	ret = raise( SIGNAL );
  
  	if ( ret != 0 )
  	{
  		UNRESOLVED( ret, "Failed to raise SIGALRM" );
  	}
  
  	if ( !called )
  	{
  		FAILED( "the sa_handler was not called whereas SA_SIGINFO was not set" );
  	}
  
  
  	/* Test passed */
  #if VERBOSE > 0
  
  	output( "Test passed\n" );
  
  #endif
  
  	PASSED;
  }
  