diff options
Diffstat (limited to 'nuttx/include/signal.h')
-rw-r--r-- | nuttx/include/signal.h | 238 |
1 files changed, 238 insertions, 0 deletions
diff --git a/nuttx/include/signal.h b/nuttx/include/signal.h new file mode 100644 index 000000000..02b222343 --- /dev/null +++ b/nuttx/include/signal.h @@ -0,0 +1,238 @@ +/******************************************************************************** + * include/signal.h + * + * Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved. + * Author: Gregory Nutt <gnutt@nuttx.org> + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * 3. Neither the name NuttX nor the names of its contributors may be + * used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, + * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED + * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN + * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + * + ********************************************************************************/ + +#ifndef __INCLUDE_SIGNAL_H +#define __INCLUDE_SIGNAL_H + +/******************************************************************************** + * Included Files + ********************************************************************************/ + +#include <nuttx/config.h> +#include <nuttx/compiler.h> + +#include <stdint.h> +#include <time.h> + +/******************************************************************************** + * Pre-processor Definitions + ********************************************************************************/ + +/* Signal set management definitions and macros. */ + +#define NULL_SIGNAL_SET ((sigset_t)0x00000000) +#define ALL_SIGNAL_SET ((sigset_t)0xffffffff) +#define MIN_SIGNO 0 +#define MAX_SIGNO 31 +#define GOOD_SIGNO(s) ((((unsigned)(s))<=MAX_SIGNO)) +#define SIGNO2SET(s) ((sigset_t)1 << (s)) + +/* All signals are "real time" signals */ + +#define SIGRTMIN 0 /* First real time signal */ +#define SIGRTMAX 31 /* Last real time signal */ + +/* A few of the real time signals are used within the OS. They have + * default values that can be overridden from the configuration file. The + * rest are all user signals: + */ + +#ifndef CONFIG_SIG_SIGUSR1 +#define SIGUSR1 0 /* User signal 1 */ +#else +#define SIGUSR1 CONFIG_SIG_SIGUSR1 +#endif + +#ifndef CONFIG_SIG_SIGUSR2 +#define SIGUSR2 1 /* User signal 2 */ +#else +#define SIGUSR2 CONFIG_SIG_SIGUSR2 +#endif + +#ifndef CONFIG_SIG_SIGALARM +#define SIGALRM 2 /* Default signal used with POSIX timers (used only */ + /* no other signal is provided) */ +#else +#define SIGALRM CONFIG_SIG_SIGALARM +#endif + +#ifndef CONFIG_DISABLE_PTHREAD +#ifndef CONFIG_SIG_SIGCONDTIMEDOUT +#define SIGCONDTIMEDOUT 3 /* Used in the implementation of pthread_cond_timedwait */ +#else +#define SIGCONDTIMEDOUT CONFIG_SIG_SIGCONDTIMEDOUT +#endif +#endif + +/* SIGWORK is used to wake up various internal, NuttX worker thread */ + +#if defined(CONFIG_SCHED_WORKQUEUE) || defined(CONFIG_PAGING) +#ifndef CONFIG_SIG_SIGWORK +#define SIGWORK 4 /* Used to wake up the work queue */ +#else +#define SIGWORK CONFIG_SIG_SIGWORK +#endif +#endif + +/* sigprocmask() "how" definitions. Only one of the following can be specified: */ + +#define SIG_BLOCK 1 /* Block the given signals */ +#define SIG_UNBLOCK 2 /* Unblock the given signals */ +#define SIG_SETMASK 3 /* Set the signal mask to the current set */ + +/* struct sigaction flag values */ + +#define SA_NOCLDSTOP 1 /* Do not generate SIGCHILD when + * children stop (ignored) */ +#define SA_SIGINFO 2 /* Invoke the signal-catching function + * with 3 args instead of 1 + * (always assumed) */ + +/* These are the possible values of the signfo si_code field */ + +#define SI_USER 0 /* Signal sent from kill, raise, or abort */ +#define SI_QUEUE 1 /* Signal sent from sigqueue */ +#define SI_TIMER 2 /* Signal is result of timer expiration */ +#define SI_ASYNCIO 3 /* Signal is the result of asynch IO completion */ +#define SI_MESGQ 4 /* Signal generated by arrival of a message on an */ + /* empty message queue */ + +/* Values for the sigev_notify field of struct sigevent */ + +#define SIGEV_NONE 0 /* No notification desired */ +#define SIGEV_SIGNAL 1 /* Notify via signal */ + +/* Special values of sigaction (all treated like NULL) */ + +#define SIG_ERR ((CODE void*)-1) +#define SIG_DFL ((CODE void*)0) +#define SIG_IGN ((CODE void*)0) + +/******************************************************************************** + * Global Type Declarations + ********************************************************************************/ + +/* This defines a set of 32 signals (numbered 0 through 31). */ + +typedef uint32_t sigset_t; /* Bit set of 32 signals */ + +/* This defines the type of the siginfo si_value field */ + +union sigval +{ + int sival_int; /* Integer value */ + FAR void *sival_ptr; /* Pointer value */ +}; + +/* This structure contains elements that define a queue signal. The following is + * used to attach a signal to a message queue to notify a task when a message is + * available on a queue + */ + +struct sigevent +{ + uint8_t sigev_notify; /* Notification method: SIGEV_SIGNAL or SIGEV_NONE */ + uint8_t sigev_signo; /* Notification signal */ + union sigval sigev_value; /* Data passed with notification */ +}; + +/* The following types is used to pass parameters to/from signal handlers */ + +struct siginfo +{ + uint8_t si_signo; /* Identifies signal */ + uint8_t si_code; /* Source: SI_USER, SI_QUEUE, SI_TIMER, SI_ASYNCIO, or SI_MESGQ */ + union sigval si_value; /* Data passed with signal */ +}; + +typedef struct siginfo siginfo_t; + +/* The following structure defines the action to take for given signal */ + +struct sigaction +{ + union + { + CODE void (*_sa_handler)(int); + CODE void (*_sa_sigaction)(int, FAR siginfo_t *, FAR void *); + } sa_u; + sigset_t sa_mask; + int sa_flags; +}; + +#define sa_handler sa_u._sa_handler +#define sa_sigaction sa_u._sa_sigaction + +/******************************************************************************** + * Global Variables + ********************************************************************************/ + +/******************************************************************************** + * Global Function Prototypes + ********************************************************************************/ + +#ifdef __cplusplus +#define EXTERN extern "C" +extern "C" { +#else +#define EXTERN extern +#endif + +EXTERN int kill(pid_t, int); +EXTERN int sigemptyset(FAR sigset_t *set); +EXTERN int sigfillset(FAR sigset_t *set); +EXTERN int sigaddset(FAR sigset_t *set, int signo); +EXTERN int sigdelset(FAR sigset_t *set, int signo); +EXTERN int sigismember(FAR const sigset_t *set, int signo); +EXTERN int sigaction(int sig, FAR const struct sigaction *act, FAR struct sigaction *oact); +EXTERN int sigprocmask(int how, FAR const sigset_t *set, FAR sigset_t *oset); +EXTERN int sigpending(FAR sigset_t *set); +EXTERN int sigsuspend(FAR const sigset_t *sigmask); +EXTERN int sigwaitinfo(FAR const sigset_t *set, FAR struct siginfo *value); +EXTERN int sigtimedwait(FAR const sigset_t *set, FAR struct siginfo *value, + FAR const struct timespec *timeout); +#ifdef CONFIG_CAN_PASS_STRUCTS +EXTERN int sigqueue(int pid, int signo, union sigval value); +#else +EXTERN int sigqueue(int pid, int signo, FAR void *sival_ptr); +#endif + +#undef EXTERN +#ifdef __cplusplus +} +#endif + +#endif /* __INCLUDE_SIGNAL_H */ + |