Changeset 1571 for trunk/src/emx/include/InnoTekLIBC/sharedpm.h

Timestamp:

Oct 10, 2004, 12:48:19 PM (21 years ago)

Author:

bird

Message:

First attempt on shared signal interface.

File:

• trunk/src/emx/include/InnoTekLIBC/sharedpm.h (modified) (6 diffs, 1 prop)

trunk/src/emx/include/InnoTekLIBC/sharedpm.h

@@ -29 +29 @@
 #include <sys/cdefs.h>
 #include <sys/types.h>
+#include <sys/signal.h>
 
 __BEGIN_DECLS
@@ -56 +57 @@
  * The SPM version.
  */
-#define SPM_VERSION             0x00010000
+#define SPM_VERSION             0x00010001
 
 /**
@@ -105 +106 @@
     __LIBC_EXIT_REASON_MAKE_INT32 = 0x7fffffff
 } __LIBC_EXIT_REASON;
+
+
+/**
+ * Signal (queued).
+ */
+typedef struct __libc_SPMSignal
+{
+    /** Structure size. */
+    unsigned                    cb;
+    /** Pointer to the next signal. */
+    struct __libc_SPMSignal    *pNext;
+    /** Signal info. */
+    siginfo_t                   Info;
+} __LIBC_SPMSIGNAL;
+/** Pointer to (queued) signal. */
+typedef __LIBC_SPMSIGNAL *__LIBC_PSPMSIGNAL;
+
 
 /** Inheritance FH Bundle Type.
@@ -253 +271 @@
     /** Creation timestamp. */
     unsigned                    uTimestamp;
+    /** Incoming signal queue.
+     * This is a LIFO for speed and size. The receiving process will
+     * process them in the correct order of course.
+     * For signals which aren't queable only one signal can be queued.
+     */
+    __LIBC_PSPMSIGNAL           pSigHead;
+    /** Number of queued signals.
+     * After it passes 48 signals, only SIGCHLD will be queued.
+     * This means siqueue() won't work 100% according to spec. */
+    unsigned                    cSigsQueued;
 
     /** Reserved pool pointer field with default value 0. */
-    unsigned                    aReserved[40 - 14];
+    unsigned                    aReserved[40 - 16];
 
     /** Number of possible pointers to shared memory starting at pvInherit.
@@ -379 +407 @@
     __LIBC_SPMLOADAVG           LoadAvg;
 
+    /** List of free signal structures. This will reduce
+     * the time spent allocating a signal structure in most cases.
+     * During SPM init 8 signal structures will be allocated and queued. */
+    __LIBC_PSPMSIGNAL           pSigFreeHead;
+    /** Number of free signal structures in the list.
+     * This is used to prevent the list from growing infinitly under stress.
+     * When cSigFree reaches 32 unused signal structures will be freed instead
+     * of put in the list. */
+    unsigned                    cSigFree;
+    /** Number of active signals.
+     * This is used to keep a reasonable limit of the number of active signal
+     * structures so a process cannot exhaust the shared memory pool.
+     * The maximum is defined by cSigMaxActive.
+     */
+    unsigned                    cSigActive;
+    /** The maximum number of active signals.
+     * This is initialized by the SPM creator but can be adjusted later.
+     */
+    unsigned                    cSigMaxActive;
+
     /* The rest of the block, up to cbProcess, is undefined in this version.
      * Future versions of LIBC may use this area assuming it's initalized with zeros.
@@ -593 +641 @@
 
 /**
+ * Queues a signal on another process.
+ *
+ * @returns 0 on success.
+ * @returns Negative error code (errno.h) on failure.
+ * @param   pSignal     Signal to queue.
+ * @param   pid         Pid to queue it on.
+ * @param   fQueued     Set if the signal type is queued.
+ */
+int     __libc_spmSigQueue(siginfo_t *pSignal, pid_t pid, int fQueued);
+
+/**
+ * De-queues one or more pending signals.
+ * @returns Number of de-queued signals on success.
+ * @returns Negative error code (errno.h) on failure.
+ * @param   paSignals   Where to store the signals.
+ * @param   cSignals    Size of the signal array.
+ * @param   cbSignal    Size of one signal entry.
+ */
+int     __libc_spmSigDequeue(siginfo_t *paSignals, unsigned cSignals, size_t cbSignal);
+
+
+/**
  * Checks the SPM memory for trouble.
  *