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

Timestamp:

Nov 14, 2004, 6:17:04 AM (21 years ago)

Author:

bird

Message:

Signals, processes and stuff.

File:

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

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

@@ -497 +497 @@
  * @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);
@@ -516 +514 @@
  * Send a signal to a process.
  *
+ * Special case for iSignalNo equal to 0, where no signal is sent but permissions to
+ * do so is checked.
+ *
  * @returns 0 on if signal sent.
  * @returns -errno on failure.
@@ -521 +522 @@
  * @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.
+ *                      If 0 no signal is sent, but error handling is done as if.
  */
 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.
+ * Sends a signal to a process group.
+ *
+ * Special case for iSignalNo equal to 0, where no signal is sent but permissions to
+ * do so is checked.
+ *
+ * @returns 0 on if signal sent.
+ * @returns -errno on failure.
+ *
  * @param   pgrp        Process group (positive).
  *                      0 means the process group of this process.
- *                      1 means all process in the system.
+ *                      1 means all process in the system. (not implemented!)
  * @param   iSignalNo   Signal to send to all the processes in the group.
+ *                      If 0 no signal is sent, but error handling is done as if.
  */
 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);
 
 /**
@@ -641 +622 @@
 /**
  * Suspends the current thread till a signal have been handled.
- * The signal semaphore is owned.
- *
- * @returns Negative error code (errno) on failure. (allways fails)
+ *
+ * @returns Negative error code (errno) on failure. (always fails)
  * @param   pSigSet     Temporary signal mask for the thread.
  */
@@ -681 +661 @@
 int __libc_Back_processWait(idtype_t enmIdType, id_t Id, siginfo_t *pSigInfo, unsigned fOptions, struct rusage *pUsage);
 
+/**
+ * Gets the real user id of the current process.
+ * @returns Real user id.
+ */
+uid_t __libc_Back_processGetUid(void);
+
+/**
+ * Gets the effective user id of the current process.
+ * @returns Effective user id.
+ */
+uid_t __libc_Back_processGetEffUid(void);
+
+/**
+ * Sets the effective user id of the current process.
+ * If the caller is superuser real and saved user id are also set.
+ *
+ * @returns 0 on success.
+ * @returns Negative error code (errno) on failure.
+ * @param   uid         New effective user id.
+ *                      For superusers this is also the new real and saved user id.
+ */
+int __libc_Back_processSetUid(uid_t uid);
+
+/**
+ * Sets the real, effective and saved user ids of the current process.
+ * Unprivilegde users can only set them to the real user id, the
+ * effective user id or the saved user id.
+ *
+ * @returns 0 on success.
+ * @returns Negative error code (errno) on failure.
+ * @param   ruid    New real user id. Ignore if -1.
+ * @param   euid    New effective user id. Ignore if -1.
+ * @param   svuid   New Saved user id. Ignore if -1.
+ */
+int __libc_Back_processSetUidAll(uid_t ruid, uid_t euid, uid_t svuid);
+
+
+/**
+ * Gets the real group id of the current process.
+ * @returns Real group id.
+ */
+gid_t __libc_Back_processGetGid(void);
+
+/**
+ * Gets the effective group id of the current process.
+ * @returns Effective group id.
+ */
+gid_t __libc_Back_processGetEffGid(void);
+
+/**
+ * Sets the effective group id of the current process.
+ * If the caller is superuser real and saved group id are also set.
+ *
+ * @returns 0 on success.
+ * @returns Negative error code (errno) on failure.
+ */
+int __libc_Back_processSetGid(gid_t gid);
+
+/**
+ * Sets the real, effective and saved group ids of the current process.
+ * Unprivilegde users can only set them to the real group id, the
+ * effective group id or the saved group id.
+ *
+ * @returns 0 on success.
+ * @returns Negative error code (errno) on failure.
+ * @param   rgid    New real group id. Ignore if -1.
+ * @param   egid    New effective group id. Ignore if -1.
+ * @param   svgid   New Saved group id. Ignore if -1.
+ */
+int __libc_Back_processSetGidAll(gid_t rgid, gid_t egid, gid_t svgid);
+
+
 /** @} */