#ifndef _SIGNAL_H_ #define _SIGNAL_H_ /* ** Distributed under the terms of the OpenBeOS License. */ #include #ifdef __cplusplus extern "C" { #endif typedef int sig_atomic_t; typedef void (*__signal_func_ptr)(int); __signal_func_ptr signal(int signal, __signal_func_ptr signal_func); int raise(int signal); #ifdef __cplusplus } #endif #define SIG_DFL ((__signal_func_ptr) 0) #define SIG_IGN ((__signal_func_ptr) 1) #define SIG_ERR ((__signal_func_ptr)-1) /* The numbering of signals for BeOS attempts to maintain some consistency with UN*X conventions so that things like "kill -9" do what you expect. */ #define SIGHUP 1 /* hangup -- tty is gone! */ #define SIGINT 2 /* interrupt */ #define SIGQUIT 3 /* `quit' special character typed in tty */ #define SIGILL 4 /* illegal instruction */ #define SIGCHLD 5 /* child process exited */ #define SIGABRT 6 /* abort() called, dont' catch */ #define SIGPIPE 7 /* write to a pipe w/no readers */ #define SIGFPE 8 /* floating point exception */ #define SIGKILL 9 /* kill a team (not catchable) */ #define SIGSTOP 10 /* suspend a thread (not catchable) */ #define SIGSEGV 11 /* segmentation violation (read: invalid pointer) */ #define SIGCONT 12 /* continue execution if suspended */ #define SIGTSTP 13 /* `stop' special character typed in tty */ #define SIGALRM 14 /* an alarm has gone off (see alarm()) */ #define SIGTERM 15 /* termination requested */ #define SIGTTIN 16 /* read of tty from bg process */ #define SIGTTOU 17 /* write to tty from bg process */ #define SIGUSR1 18 /* app defined signal 1 */ #define SIGUSR2 19 /* app defined signal 2 */ #define SIGWINCH 20 /* tty window size changed */ #define SIGKILLTHR 21 /* be specific: kill just the thread, not team */ #define SIGTRAP 22 #define SIGBUS SIGSEGV /* for old style code */ /* Signal numbers 23-32 are currently free but may be used in future releases. Use them at your own peril (if you do use them, at least be smart and use them backwards from signal 32). */ #define __signal_max 22 #define NSIG (__signal_max+1) typedef long sigset_t; /* The Posix interface for signal handling functions isn't as useful as it could be. The standard indicates that only a single argument (the signal number) is passed to the signal handler. It is useful to have more information and the BeOS provides two extra arguments. However, to remain compatible with Posix and ANSI C, we declare the sa_handler field of the sigaction struct as type __signal_func_ptr. That means you'll need to cast any function you assign to the sa_handler field. NOTE: C++ member functions can not be signal handlers (because they expect a "this" pointer as the first argument). The 3 arguments that the BeOS provides to signal handlers are as follows: - The first argument is the signal number (as an integer). - The next argument is whatever value is put in the sa_userdata field of the sigaction struct. - The last argument is a pointer to a vregs struct (defined below). The vregs struct contains the contents of the volatile registers at the time the signal was delivered to your thread. You can change the fields of the structure. After your signal handler completes, the OS uses this struct to reload the registers for your thread (privileged registers are not loaded of course). The vregs struct is of course terribly machine dependent and is guaranteed to change, potentially even between different models of the PowerPC family. If you use it, you should expect to have to re-work your code when new processors come out. Nonetheless the ability to change the registers does open some interesting programming possibilities. */ struct sigaction { __signal_func_ptr sa_handler; sigset_t sa_mask; int sa_flags; void *sa_userdata; /* will be passed to the signal handler */ }; typedef struct stack_t { void *ss_sp; size_t ss_size; int ss_flags; } stack_t; #define SA_NOCLDSTOP 0x01 /* for sa_flags */ #define SA_ONESHOT 0x02 #define SA_NOMASK 0x04 #define SA_NODEFER SA_NOMASK #define SA_RESTART 0x08 #define SA_STACK 0x10 int sigaction(int sig, const struct sigaction *act, struct sigaction *oact); int sigemptyset(sigset_t *set); int sigfillset(sigset_t *set); int sigaddset(sigset_t *set, int signo); int sigdelset(sigset_t *set, int signo); int sigismember(const sigset_t *set, int signo); int sigprocmask(int how, const sigset_t *set, sigset_t *oset); extern const char * const sys_siglist[NSIG]; const char *strsignal(int sig); const void set_signal_stack(void *ptr, size_t size); int sigaltstack(const stack_t *ss, stack_t *oss); /* XXXdbg */ extern inline int sigismember(const sigset_t *set, int sig) { sigset_t mask = (((sigset_t) 1) << (( sig ) - 1)) ; return (*set & mask) ? 1 : 0 ; } extern inline int sigaddset(sigset_t *set, int sig) { sigset_t mask = (((sigset_t) 1) << (( sig ) - 1)) ; return ((*set |= mask), 0) ; } extern inline int sigdelset(sigset_t *set, int sig) { sigset_t mask = (((sigset_t) 1) << (( sig ) - 1)) ; return ((*set &= ~mask), 0) ; } #define SIG_BLOCK 1 /* defines for the how arg of sigprocmask() */ #define SIG_UNBLOCK 2 #define SIG_SETMASK 3 int sigpending(sigset_t *set); int sigsuspend(const sigset_t *mask); int kill(pid_t pid, int sig); int send_signal(pid_t tid, uint sig); #endif /* _SIGNAL_H_ */