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

Timestamp:

May 8, 2005, 2:11:22 PM (20 years ago)

Author:

bird

Message:

Ported the BSD SysV Semaphore module.

File:

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

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

@@ -4 +4 @@
  * LIBC Shared Process Management.
  *
- *
+ * Copyright (c) 2004-2005 knut st. osmundsen <bird@anduin.net>
+ * Copyright (c) 2004 nickk
  *
  * This file is part of InnoTek LIBC.
@@ -30 +31 @@
 #include <sys/types.h>
 #include <sys/signal.h>
+#include <sys/ipc.h>
 
 
@@ -553 +555 @@
     unsigned long                       hevNotify;
 
-    /*  116 - The rest of the block, up to cbProcess, is undefined in this version.
+    /** 116 - Pointer to SysV Sempahore globals. */
+    struct __libc_SysV_Sem             *pSysVSem;
+
+    /*  120 - 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.
      */
@@ -729 +734 @@
 
 /**
+ * Checks if the calling process is a member of the specified group.
+ *
+ * @returns 0 if member.
+ * @returns -EPERM if not member.
+ * @param   gid     The group id in question.
+ */
+int __libc_spmIsGroupMember(gid_t gid);
+
+/**
+ * Check if the caller can access the SysV IPC object as requested.
+ *
+ * @returns 0 if we can.
+ * @returns -EPERM if we cannot.
+ * @param   pPerm       The IPC permission structure.
+ * @param   Mode        The access request. IPC_M, IPC_W or IPC_R.
+ */
+int __libc_spmCanIPC(struct ipc_perm *pPerm, mode_t Mode);
+
+/**
  * Marks the current process (if we have it around) as zombie
  * or dead freeing all resources associated with it.
@@ -841 +865 @@
  *
  * @returns 0 on success.
- * @returns -1 and errno on failure.
+ * @returns Negative error code (errno.h) on failure.
+ *
  * @param   pRegRec     Pointer to the exception handler registration record.
+ * @param   ppSPMHdr    Where to store the pointer to the SPM header. Can be NULL.
+ *
  * @remark  Don't even think of calling this if you're not LIBC!
  */
-int __libc_spmLock(__LIBC_PSPMXCPTREGREC pRegRec);
+int __libc_spmLock(__LIBC_PSPMXCPTREGREC pRegRec, __LIBC_PSPMHEADER *ppSPMHdr);
 
 /**
@@ -851 +878 @@
  *
  * @returns 0 on success.
- * @returns -1 on and errno failure.
+ * @returns Negative error code (errno.h) on failure.
+ *
  * @param   pRegRec     Pointer to the exception handler registration record.
+ *
  * @remark  Don't even think of calling this if you're not LIBC!
  */
@@ -859 +888 @@
 /**
  * Allocate memory from the LIBC shared memory.
+ *
+ * The SPM must be locked using __libc_spmLock() prior to calling this function!
  *
  * @returns Pointer to allocated memory on success.
  * @returns NULL on failure.
+ *
  * @param   cbSize      Size of memory to allocate.
+ *
  * @remark  Don't think of calling this if you're not LIBC!
  */
-void * __libc_spmAlloc(size_t cbSize);
-
-/**
- * Free memory allocated by __libc_SpmAlloc().
+void * __libc_spmAllocLocked(size_t cbSize);
+
+/**
+ * Free memory allocated by __libc_spmAllocLocked() or __libc_spmAlloc().
+ *
+ * The SPM must be locked using __libc_spmLock() prior to calling this function!
  *
  * @returns 0 on success.
  * @returns -1 and errno on failure.
+ *
  * @param   pv      Pointer to memory block returned by __libc_SpmAlloc().
  *                  NULL is allowed.
  * @remark  Don't think of calling this if you're not LIBC!
  */
+int __libc_spmFreeLocked(void *pv);
+
+/**
+ * Allocate memory from the LIBC shared memory.
+ *
+ * @returns Pointer to allocated memory on success.
+ * @returns NULL on failure.
+ *
+ * @param   cbSize      Size of memory to allocate.
+ *
+ * @remark  Don't think of calling this if you're not LIBC!
+ */
+void * __libc_spmAlloc(size_t cbSize);
+
+/**
+ * Free memory allocated by __libc_SpmAlloc().
+ *
+ * @returns 0 on success.
+ * @returns -1 and errno on failure.
+ *
+ * @param   pv      Pointer to memory block returned by __libc_SpmAlloc().
+ *                  NULL is allowed.
+ *
+ * @remark  Don't think of calling this if you're not LIBC!
+ */
 int __libc_spmFree(void *pv);
 
-
-/**
- * Register TCPIP termination handler.
+/**
+ * Register termination handler.
  *
  * This is a manual way of by passing a.out's broken weak symbols.
- * @param   pfnTerm     Pointer to the termination function.
- */
-void    __libc_spmSocketRegTerm(void (*pfnTerm)(void));
+ */
+void __libc_spmRegTerm(void (*pfnTerm)(void));