Changeset 1618 for trunk/src/emx/include/InnoTekLIBC/backend.h

Timestamp:

Nov 7, 2004, 3:19:42 PM (21 years ago)

Author:

bird

Message:

More signal debugging and cleanup.

File:

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

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

@@ -560 +560 @@
  *
  * @returns 0 on success.
- * @returns -Negative errno on failure.
+ * @returns Negative error code (errno) on failure.
  * @param   iSignalNo   Signal number.
  * @param   pSigAct     Pointer to new signal action.
@@ -570 +570 @@
 
 /**
+ * Change interrupt/restart system call properties for a signal.
+ *
+ * @returns 0 on success.
+ * @returns Negative error code (errno) on failure.
+ * @param   iSignalNo   Signal number to change interrupt/restart
+ *                      properties for.
+ * @param   fFlag       If set Then clear the SA_RESTART from the handler action.
+ *                      If clear Then set the SA_RESTART from the handler action.
+ * @remark  The SA_RESTART flag is inherited when using signal().
+ */
+int __libc_Back_signalInterrupt(int iSignalNo, int fFlag);
+
+/**
  * Changes and/or queries the alternative signal stack settings of a thread.
  *
@@ -584 +597 @@
  *
  * @returns 0 on success.
- * @returns -1 and errno set to EINVAL on failure.
+ * @returns Negative error code (errno) on failure.
  * @param   pThrd       Thread to apply this to.
  * @param   iHow        Describes the action taken if pSigSetNew not NULL. Recognized
@@ -604 +617 @@
 int __libc_Back_signalMask(__LIBC_PTHREAD pThrd, int iHow, const sigset_t * __restrict pSigSetNew, sigset_t * __restrict pSigSetOld);
 
+/**
+ * Wait for one or more signals and remove and return the first of them
+ * to occur.
+ *
+ * Will return immediately if one of the signals is already pending. If more than
+ * one signal is pending the signal with highest priority will be returned.
+ *
+ * @returns Signal number on success.
+ * @returns Negative error code (errno) on failure.
+ * @param   pSigSet     Signals to wait for.
+ * @param   pSigInfo    Where to store the signal info for the signal
+ *                      that we accepted.
+ * @param   pTimeout    Timeout specification. If NULL wait for ever.
+ */
+int __libc_Back_signalWait(const sigset_t *pSigSet, siginfo_t *pSigInfo, const struct timespec *pTimeout);
+
+/**
+ * Suspends the current thread till a signal have been handled.
+ * The signal semaphore is owned.
+ *
+ * @returns Negative error code (errno) on failure. (allways fails)
+ * @param   pSigSet     Temporary signal mask for the thread.
+ */
+int __libc_Back_signalSuspend(const sigset_t *pSigSet);
+
+/**
+ * Gets the set of signals which are blocked by the current thread and are
+ * pending on the process or the calling thread.
+ *
+ * @returns 0 indicating success.
+ * @returns Negative error code (errno) on failure.
+ * @param   pSigSet     Pointer to signal set where the result is to be stored.
+ */
+int __libc_Back_signalPending(sigset_t *pSigSet);
+
 /** @} */