Standard Libraries for EDK II.

[mirror_edk2.git] / StdLib / LibC / Signal / Signal.c

/** @file\r
  Implementation of the signal and raise functions as declared in <signal.h>.\r
\r
  Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
  This program and the accompanying materials are licensed and made available under\r
  the terms and conditions of the BSD License that accompanies this distribution.\r
  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php.\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
#include <Uefi.h>\r
#include <Library/UefiLib.h>\r
\r
#include  <LibConfig.h>\r
#include  <errno.h>\r
#include  <signal.h>\r
#include  <MainData.h>\r
\r
/** The signal function associates a "signal handler" with a signal number.\r
\r
    The signal function chooses one of three ways in which receipt of the\r
    signal number, sig, is to be subsequently handled. If the value of func\r
    is SIG_DFL, default handling for that signal will occur. If the value of\r
    func is SIG_IGN, the signal will be ignored.  Otherwise, func shall point\r
    to a function to be called when that signal occurs. An invocation of such a\r
    function because of a signal, or (recursively) of any further functions\r
    called by that invocation (other than functions in the standard library),\r
    is called a signal handler.\r
\r
    At program startup, the equivalent of signal(sig, SIG_IGN); may be executed\r
    for some signals selected in an implementation-defined manner; the\r
    equivalent of signal(sig, SIG_DFL); is executed for all other signals\r
    defined by the implementation.\r
\r
    @return   If the request can be honored, the signal function returns the\r
              value of func for the most recent successful call to signal for\r
              the specified signal sig. Otherwise, a value of SIG_ERR is\r
              returned and a positive value is stored in errno.\r
 */\r
__sighandler_t *\r
signal(int sig, __sighandler_t *func)\r
{\r
  __sighandler_t *OldHandler;\r
\r
  if (sig < 0 || sig >= SIG_LAST) {\r
    errno = EINVAL;\r
    return SIG_ERR;\r
  }\r
  OldHandler = gMD->sigarray[sig];\r
  gMD->sigarray[sig] = func;\r
\r
  return OldHandler;\r
}\r
\r
static\r
void\r
_defaultSignalHandler( int sig )\r
{\r
  Print(L"\nCaught signal %d.\n", sig);\r
}\r
\r
/** Send a signal.\r
\r
    The raise function carries out the actions described for signal, above,\r
    for the signal sig.\r
\r
    If a signal handler is called, the raise function shall not return until\r
    after the signal handler does.\r
\r
    @return   The raise function returns zero if successful,\r
              nonzero if unsuccessful.\r
**/\r
int\r
raise( int sig)\r
{\r
  __sighandler_t *Handler;\r
\r
  if (sig < 0 || sig >= SIG_LAST) {\r
    return EINVAL;\r
  }\r
  Handler = gMD->sigarray[sig];\r
\r
  if(Handler == SIG_DFL) {\r
    _defaultSignalHandler( sig );\r
  }\r
  else if( Handler != SIG_IGN) {\r
    Handler( sig );\r
  }\r
  return 0;\r
}\r