Changeset 1615 for trunk/src/emx/include/InnoTekLIBC/signals.h

Timestamp:

Nov 6, 2004, 9:35:32 AM (21 years ago)

Author:

bird

Message:

signals are finally getting somewhere...

File:

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

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

@@ -32 +32 @@
 *******************************************************************************/
 /** @defgroup __libc_back_signalRaise_return    __libc_back_signalRaise() returns.
+ * These are only valid for positive return values.
  * @{ */
 /** Try restart any interrupted system call. */
@@ -44 +45 @@
 /** If set the passed in SIGQUEUED structure was used. */
 #define __LIBC_BSRR_USED_QUEUED 0x40
-/** Failure. */
-#define __LIBC_BSRR_ERROR       0xffffff22
 /** @} */
 
@@ -94 +93 @@
 int         __libc_back_signalSuspend(void);
 int         __libc_back_signalWait(const struct timespec *pTimeout);
-int         __libc_back_signalVerifyPid(pid_t pid);
-int         __libc_back_signalVerifyPGrp(pid_t pgid);
-int         __libc_back_signalSendPid(pid_t pid, int iSignalNo);
 int         __libc_back_signalSendPidOther(pid_t pid, int iSignalNo);
-int         __libc_back_signalSendPGrp(pid_t pgrp, int iSignalNo);
 int         __libc_back_signalAction(int iSignalNo, const struct sigaction *pSigAct, struct sigaction *pSigActOld);
-unsigned    __libc_back_signalRaise(int iSignalNo, siginfo_t *pSigInfo, void *pvXcptOrQueued, unsigned fFlags);
 int         __libc_back_signalRaisePoked(void *pvXcptParams, int tidPoker);
 void        __libc_back_signalOS2V1Handler16bit(unsigned short uSignal, unsigned short uArg);
 void        __libc_back_signalOS2V1Handler32bit(unsigned uSignal, unsigned uArg);
 
+
+/**
+ * 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);
+
+/**
+ * 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);
+
+
 __END_DECLS