add directory Minix

2024-02-19 00:21:39 -05:00
parent 56596ada90
commit 5a46ddb732
2923 changed files with 1764412 additions and 0 deletions
--- a/Minix/CD-ROM-2.0/MINIX/MANUALS/CAT2/SIGACTIO.2
+++ b/Minix/CD-ROM-2.0/MINIX/MANUALS/CAT2/SIGACTIO.2
@@ -0,0 +1,236 @@
+
+
+SIGACTION(2)              Minix Programmer's Manual               SIGACTION(2)
+
+
+NAME
+     sigaction, signal - manage signal state and handlers
+
+SYNOPSIS
+     #include <signal.h>
+
+     int sigaction(int sig, const  struct  sigaction  *act,  struct  sigaction
+          *oact)
+     void (*signal(int sig, void (*handler)(int)))(int);
+
+DESCRIPTION
+     Sigaction() is used to examine,  set,  or  modify  the  attributes  of  a
+     signal.   The  argument  sig is the signal in question.  The act argument
+     points to a structure containing the new attributes of  the  signal,  the
+     structure pointed to by oact will receive the old attributes that were in
+     effect before the call.
+
+     The act and oact arguments may be NULL to indicate  that  either  no  new
+     attributes are to be set, or that the old attributes are not of interest.
+
+     The structure containing the signal attributes is defined  in  <signal.h>
+     and looks like this:
+
+          struct sigaction {
+              void        (*sa_handler)(int sig);
+              sigset_t    sa_mask;
+              int         sa_flags;
+          };
+
+     The sa_handler field contains the address of a signal handler, a function
+     that  is  called  when  the process is signalled, or one of these special
+     constants:
+
+     SIG_DFL     Default signal handling is to  be  performed.   This  usually
+                 means  that  the  process  is killed, but some signals may be
+                 ignored by default.
+
+     SIG_IGN     Ignore the signal.
+
+     The sa_mask field indicates a set of signals that must  be  blocked  when
+     the  signal  is  being handled.  Whether the signal sig itself is blocked
+     when being handled is not controlled by this mask.   The  mask  is  of  a
+     "signal set" type that is to be manipulated by the sigset(3) functions.
+
+     How the signal is handled precisely is specified by bits in sa_flags.  If
+     none  of  the  flags  is  set  then the handler is called when the signal
+     arrives.  The signal is blocked during  the  call  to  the  handler,  and
+     unblocked  when  the  handler returns.  A system call that is interrupted
+     returns -1 with errno set to EINTR.  The following bit flags can  be  set
+     to modify this behaviour:
+
+
+                                                                             1
+
+
+
+SIGACTION(2)              Minix Programmer's Manual               SIGACTION(2)
+
+
+     SA_RESETHAND   Reset the signal handler to SIG_DFL  when  the  signal  is
+                    caught.
+
+     SA_NODEFER     Do not block the signal on entry to the handler.
+
+     SA_COMPAT      Handle the signal in a way that is compatible with the the
+                    old signal() call.
+
+     The old signal() signal system call sets a signal  handler  for  a  given
+     signal  and  returns the old signal handler.  No signals are blocked, the
+     flags are SA_RESETHAND | SA_NODEFER | SA_COMPAT.  New code should not use
+     signal().   Note  that  signal()  and  all  of  the  SA_* flags are Minix
+     extensions.
+
+     Signal handlers are reset to SIG_DFL on an execve(2).  Signals  that  are
+     ignored stay ignored.
+
+  Signals
+     Minix knows about the following signals:
+
+     signal     num    notes   description
+
+     SIGHUP     1      k       Hangup
+     SIGINT     2      k       Interrupt (usually DEL or CTRL-C)
+     SIGQUIT    3      kc      Quit (usually CTRL-\)
+     SIGILL     4      kc      Illegal instruction
+     SIGTRAP    5      xkc     Trace trap
+     SIGABRT    6      kc      Abort program
+     SIGFPE     8      k       Floating point exception
+     SIGKILL    9      k       Kill
+     SIGUSR1    10     k       User defined signal #1
+     SIGSEGV    11     kc      Segmentation fault
+     SIGUSR2    12     k       User defined signal #2
+     SIGPIPE    13     k       Write to a pipe with no reader
+     SIGALRM    14     k       Alarm clock
+     SIGTERM    15     k       Terminate (default for kill(1))
+     SIGCHLD    17     pvi     Child process terminated
+     SIGCONT    18     p       Continue if stopped
+     SIGSTOP    19     ps      Stop signal
+     SIGTSTP    20     ps      Interactive stop signal
+     SIGTTIN    21     ps      Background read
+     SIGTTOU    22     ps      Background write
+     SIGWINCH   23     xvi     Window size change
+
+     The letters in the notes column indicate:
+
+
+
+
+
+
+
+                                                                             2
+
+
+
+SIGACTION(2)              Minix Programmer's Manual               SIGACTION(2)
+
+
+     k    The process is killed if the signal is not caught.
+
+     c    The signal causes a core dump.
+
+     i    The signal is ignored if not caught.
+
+     v    Only Minix-vmd implements this signal.
+
+     x    Minix extension, not defined by POSIX.
+
+     p    These signals are not implemented, but POSIX requires that they  are
+          defined.
+
+     s    The process should be stopped, but is killed instead.
+
+     The SIGKILL signal cannot be caught or ignored.  The SIGILL  and  SIGTRAP
+     signals  cannot  be  automatically  reset.   The system silently enforces
+     these restrictions.  This may or may not be reflected by  the  attributes
+     of these signals and the signal masks.
+
+  Types
+     POSIX prescribes that <sys/types.h> has the following definition:
+
+          typedef int (*sighandler_t)(int)
+
+     With this type the following declarations can be made:
+
+          sighandler_t sa_handler;
+          sighandler_t signal(int sig, sighandler_t handler);
+
+     This may help you to understand the  earlier  declarations  better.   The
+     sighandler_t  type  is  also  very  useful  in  old  style C code that is
+     compiled by a compiler for standard C.
+
+SEE ALSO
+     kill(1), kill(2), pause(2), sigprocmask(2), sigsuspend(2), sigpending(2),
+     sigset(3).
+
+DIAGNOSTICS
+     Sigaction() returns 0 on success or -1 on error.   Signal()  returns  the
+     old handler on success or SIG_ERR on error.  The error code may be:
+
+     EINVAL    Bad signal number.
+
+     EFAULT    Bad act or oact addresses.
+
+
+
+
+
+
+
+                                                                             3
+
+
+
+SIGACTION(2)              Minix Programmer's Manual               SIGACTION(2)
+
+
+AUTHOR
+     Kees J. Bot (kjb@cs.vu.nl)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+                                                                             4
+