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

Timestamp:

Nov 7, 2004, 10:33:03 AM (21 years ago)

Author:

bird

Message:

Debugging signals.

File:

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

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

@@ -30 +30 @@
 #include <sys/cdefs.h>
 #include <sys/types.h>
+#include <signal.h>
 #include <emx/io.h>
+
 
 __BEGIN_DECLS
@@ -446 +448 @@
 
 
+/** @defgroup   __libc_Back_signal      LIBC Backend - Signals
+ * @{
+ */
+
+/** @defgroup __libc_Back_signalRaise_return    __libc_back_signalRaise() returns.
+ * These are only valid for positive return values.
+ * @{ */
+/** Try restart any interrupted system call. */
+#define __LIBC_BSRR_RESTART     0x01
+/** Go ahead interrupt system call in progress. */
+#define __LIBC_BSRR_INTERRUPT   0x02
+/** If set execution should be resumed. */
+#define __LIBC_BSRR_CONTINUE    0x10
+/** If set execution should not be resumed but the signal should be passed
+ * on to the system. */
+#define __LIBC_BSRR_PASSITON    0x20
+/** If set the passed in SIGQUEUED structure was used. */
+#define __LIBC_BSRR_USED_QUEUED 0x40
+/** @} */
+
+/** @defgroup __libc_back_signalRaise_flags     __libc_back_signalRaise() flags.
+ * @{ */
+/** The signal is thread specific and must be delivered to the current thread. */
+#define __LIBC_BSRF_THREAD      0x01
+/** The signal was send from an unknown process. */
+#define __LIBC_BSRF_EXTERNAL    0x02
+/** The signal was generated by the hardware (i.e. CPUs and such). */
+#define __LIBC_BSRF_HARDWARE    0x04
+/** The signal should be queued. */
+#define __LIBC_BSRF_QUEUED      0x08
+/** @} */
+
+
+/**
+ * Raises a signal in the current process.
+ *
+ * @returns On success a flag mask out of the __LIBC_BSRR_* #defines is returned.
+ * @returns On failure a negative error code (errno.h) is returned.
+ * @param   iSignalNo           Signal to raise.
+ * @param   pSigInfo            Pointer to signal info for this signal.
+ *                              NULL is allowed.
+ * @param   pvXcptOrQueued      Exception handler parameter list.
+ *                              Or if __LIBC_BSRF_QUEUED is set, a pointer to locally malloced
+ *                              SIGQUEUED node.
+ * @param   fFlags              Flags of the #defines __LIBC_BSRF_* describing how to
+ *                              deliver the signal.
+ *
+ * @remark  This Backend Signal API does NOT require the caller to own the signal semaphore.
+ */
+int __libc_Back_signalRaise(int iSignalNo, siginfo_t *pSigInfo, void *pvXcptOrQueued, unsigned fFlags);
+
+/**
+ * Worker called after __libc_Back_signalRaise() was called with a
+ * preallocated signal queue entry. This function will make sure
+ * we're not ending up with too many heap allocated packets in the
+ * free list.
+ */
+void __libc_Back_signalFreeWorker(void);
+
+/**
+ * Send a signal to a process.
+ *
+ * @returns 0 on if signal sent.
+ * @returns -errno on failure.
+ *
+ * @param   pid         Process Id of the process which the signal is to be sent to.
+ * @param   iSignalNo   The signal to send.
+ * @remark  This Backend Signal API does NOT require the caller to own the signal semaphore.
+ */
+int __libc_Back_signalSendPid(pid_t pid, int iSignalNo);
+
+/**
+ * Verify the existance of another process and that the current process
+ * is allowed to signal it.
+ *
+ * @return 0 on success.
+ * @return -ESRCH if pid doesn't exist.
+ * @return -EPERM if we aren't allowed to signal the pid.
+ * @param   pid     Process Id for the process which we wanna signal.
+ * @todo    Do EPERM check, no ideas here yet.
+ * @remark  This Backend Signal API does NOT require the caller to own the signal semaphore.
+ */
+int __libc_Back_signalVerifyPid(pid_t pid);
+
+/**
+ * Not implemented.
+ *
+ * @returns -ENOSYS.
+ * @param   pgrp        Process group (positive).
+ *                      0 means the process group of this process.
+ *                      1 means all process in the system.
+ * @param   iSignalNo   Signal to send to all the processes in the group.
+ */
+int __libc_Back_signalSendPGrp(pid_t pgrp, int iSignalNo);
+
+/**
+ * Verify the existance of a process group and that the current process
+ * is allowed to signal it.
+ *
+ * @return 0 on success.
+ * @return -ESRCH if pgid doesn't exist.
+ * @return -EPERM if we aren't allowed to signal the pgid.
+ * @param   pgid    Process group id which the current process intend to signal.
+ * @todo    Do EPERM check, no ideas here yet.
+ * @remark  This Backend Signal API does NOT require the caller to own the signal semaphore.
+ */
+int __libc_Back_signalVerifyPGrp(pid_t pgid);
+
+/**
+ * sigaction worker; queries and/or sets the action for a signal.
+ *
+ * @returns 0 on success.
+ * @returns -Negative errno on failure.
+ * @param   iSignalNo   Signal number.
+ * @param   pSigAct     Pointer to new signal action.
+ *                      If NULL no update is done.
+ * @param   pSigActOld  Where to store the old signal action.
+ *                      If NULL nothing is attempted stored.
+ */
+int __libc_Back_signalAction(int iSignalNo, const struct sigaction *pSigAct, struct sigaction *pSigActOld);
+
+/**
+ * Changes and/or queries the alternative signal stack settings of a thread.
+ *
+ * @returns 0 on success.
+ * @returns Negative error number (errno.h) on failure.
+ * @param   pThrd       Thread which signal stack to change and/or query.
+ * @param   pStack      New stack settings. (Optional)
+ * @param   pOldStack   Old stack settings. (Optional)
+ */
+int __libc_Back_signalStack(__LIBC_PTHREAD pThrd, const stack_t *pStack, stack_t *pOldStack);
+
+/**
+ * Block or unblock signal deliveries of a thread.
+ *
+ * @returns 0 on success.
+ * @returns -1 and errno set to EINVAL on failure.
+ * @param   pThrd       Thread to apply this to.
+ * @param   iHow        Describes the action taken if pSigSetNew not NULL. Recognized
+ *                      values are SIG_BLOCK, SIG_UNBLOCK or SIG_SETMASK.
+ *
+ *                      SIG_BLOCK means to or the sigset pointed to by pSigSetNew with
+ *                          the signal mask for the current thread.
+ *                      SIG_UNBLOCK means to and the 0 complement of the sigset pointed
+ *                          to by pSigSetNew with the signal mask of the current thread.
+ *                      SIG_SETMASK means to set the signal mask of the current thread
+ *                          to the sigset pointed to by pSigSetNew.
+ *
+ * @param   pSigSetNew  Pointer to signal set which will be applied to the current
+ *                      threads signal mask according to iHow. If NULL no change
+ *                      will be made the the current threads signal mask.
+ * @param   pSigSetOld  Where to store the current threads signal mask prior to applying
+ *                      pSigSetNew to it. This parameter can be NULL.
+ */
+int __libc_Back_signalMask(__LIBC_PTHREAD pThrd, int iHow, const sigset_t * __restrict pSigSetNew, sigset_t * __restrict pSigSetOld);
+
+/** @} */
+
 __END_DECLS