]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/sys/shm.h
xnu-3247.1.106.tar.gz
[apple/xnu.git] / bsd / sys / shm.h
index f6f43f5f8e8618dec5fba29e3c15ae9d9aa916a1..150261adc3d7014f869d5b26f95a469a125aa1ff 100644 (file)
@@ -1,16 +1,19 @@
 /*
  * Copyright (c) 2000-2002 Apple Computer, Inc. All rights reserved.
  *
- * @APPLE_LICENSE_HEADER_START@
- * 
- * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
  * 
  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ * 
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
  * 
  * The Original Code and all software distributed under the License are
  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
@@ -20,7 +23,7 @@
  * Please see the License for the specific language governing rights and
  * limitations under the License.
  * 
- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  */
 /*     $NetBSD: shm.h,v 1.15 1994/06/29 06:45:17 cgd Exp $     */
 
 #ifndef _SYS_SHM_H_
 #define _SYS_SHM_H_
 
-#include <sys/appleapiopts.h>
-#include <sys/param.h>
+#include <sys/cdefs.h>
+#include <sys/_types.h>
+
+/*
+ * [XSI]       All of the symbols from <sys/ipc.h> SHALL be defined
+ *             when this header is included
+ */
 #include <sys/ipc.h>
 
-#define SHM_RDONLY  010000  /* Attach read-only (else read-write) */
-#define SHM_RND     020000  /* Round attach address to SHMLBA */
-#define SHMLBA      NBPG /* Segment low boundary address multiple */
+/*
+ * [XSI] The pid_t, time_t, key_t, and size_t types shall be defined as
+ * described in <sys/types.h>.
+ *
+ * NOTE:       The definition of the key_t type is implicit from the
+ *             inclusion of <sys/ipc.h>
+ */
+#include <sys/_types/_pid_t.h>
+#include <sys/_types/_time_t.h>
+#include <sys/_types/_size_t.h>
+
+/*
+ * [XSI] The unsigned integer type used for the number of current attaches
+ * that MUST be able to store values at least as large as a type unsigned
+ * short.
+ */
+typedef unsigned short shmatt_t;
+
+
+/*
+ * Possible flag values which may be OR'ed into the third argument to
+ * shmat()
+ */
+#define SHM_RDONLY     010000  /* [XSI] Attach read-only (else read-write) */
+#define SHM_RND                020000  /* [XSI] Round attach address to SHMLBA */
+
+/*
+ * This value is symbolic, and generally not expected to be sed by user
+ * programs directly, although such ise is permitted by the standard.  Its
+ * value in our implementation is equal to the number of bytes per page.
+ *
+ * NOTE:       We DO NOT obtain this value from the appropriate system
+ *             headers at this time, to avoid the resulting namespace
+ *             pollution, which is why we discourages its use.
+ */
+#define SHMLBA      4096       /* [XSI] Segment low boundary address multiple*/
 
 /* "official" access mode definitions; somewhat braindead since you have
    to specify (SHM_* >> 3) for group and (SHM_* >> 6) for world permissions */
 #define SHM_R       (IPC_R)
 #define SHM_W       (IPC_W)
 
+#pragma pack(4)
 
-struct shmid_ds {
-       struct ipc_perm shm_perm;       /* operation permission structure */
-       int             shm_segsz;      /* size of segment in bytes */
-       pid_t           shm_lpid;   /* process ID of last shared memory op */
-       pid_t           shm_cpid;       /* process ID of creator */
-       short           shm_nattch;     /* number of current attaches */
-       time_t          shm_atime;      /* time of last shmat() */
-       time_t          shm_dtime;      /* time of last shmdt() */
-       time_t          shm_ctime;      /* time of last change by shmctl() */
-       void           *shm_internal;   /* sysv stupidity */
-};
-
-#ifdef KERNEL
-#ifdef __APPLE_API_PRIVATE
 /*
- * System 5 style catch-all structure for shared memory constants that
- * might be of interest to user programs.  Do we really want/need this?
+ * Technically, we should force all code references to the new structure
+ * definition, not in just the standards conformance case, and leave the
+ * legacy interface there for binary compatibility only.  Currently, we
+ * are only forcing this for programs requesting standards conformance.
  */
-struct shminfo {
-       int     shmmax,         /* max shared memory segment size (bytes) */
-               shmmin,         /* min shared memory segment size (bytes) */
-               shmmni,         /* max number of shared memory identifiers */
-               shmseg,         /* max shared memory segments per process */
-               shmall;         /* max amount of shared memory (pages) */
+#if __DARWIN_UNIX03 || defined(KERNEL)
+/*
+ * Structure used internally.
+ * 
+ * This structure is exposed because standards dictate that it is used as
+ * the third argment to shmctl().
+ *
+ * NOTE:       The field shm_internal is not meaningful in user space,
+ *             and must not be used there.
+ */
+#if (defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE))
+struct shmid_ds
+#else
+#define        shmid_ds        __shmid_ds_new
+struct __shmid_ds_new
+#endif
+{
+       struct __ipc_perm_new shm_perm; /* [XSI] Operation permission value */
+       size_t          shm_segsz;      /* [XSI] Size of segment in bytes */
+       pid_t           shm_lpid;       /* [XSI] PID of last shared memory op */
+       pid_t           shm_cpid;       /* [XSI] PID of creator */
+       shmatt_t        shm_nattch;     /* [XSI] Number of current attaches */
+       time_t          shm_atime;      /* [XSI] Time of last shmat() */
+       time_t          shm_dtime;      /* [XSI] Time of last shmdt() */
+       time_t          shm_ctime;      /* [XSI] Time of last shmctl() change */
+       void            *shm_internal;  /* reserved for kernel use */
 };
-extern struct shminfo  shminfo;
-extern struct shmid_ds *shmsegs;
+#else  /* !__DARWIN_UNIX03 */
+#define        shmid_ds        __shmid_ds_old
+#endif /* !__DARWIN_UNIX03 */
 
-struct proc;
+#if !__DARWIN_UNIX03
+struct __shmid_ds_old {
+       struct __ipc_perm_old shm_perm; /* [XSI] Operation permission value */
+       size_t          shm_segsz;      /* [XSI] Size of segment in bytes */
+       pid_t           shm_lpid;       /* [XSI] PID of last shared memory op */
+       pid_t           shm_cpid;       /* [XSI] PID of creator */
+       shmatt_t        shm_nattch;     /* [XSI] Number of current attaches */
+       time_t          shm_atime;      /* [XSI] Time of last shmat() */
+       time_t          shm_dtime;      /* [XSI] Time of last shmdt() */
+       time_t          shm_ctime;      /* [XSI] Time of last shmctl() change */
+       void            *shm_internal;  /* reserved for kernel use */
+};
+#endif /* !__DARWIN_UNIX03 */
 
-void   shmexit __P((struct proc *));
-void   shmfork __P((struct proc *, struct proc *));
-#endif /* __APPLE_API_PRIVATE */
-#else /* !KERNEL */
+#pragma pack()
 
-#include <sys/cdefs.h>
+#ifndef KERNEL
 
 __BEGIN_DECLS
-int shmsys __P((int, ...));
-void *shmat  __P((int, void *, int));
-int shmget __P((key_t, int, int));
-int shmctl __P((int, int, struct shmid_ds *));
-int shmdt  __P((void *));
+#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
+int    shmsys(int, ...);
+#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+void   *shmat (int, const void *, int);
+int    shmctl(int, int, struct shmid_ds *) __DARWIN_ALIAS(shmctl);
+int    shmdt(const void *);
+int    shmget(key_t, size_t, int);
 __END_DECLS
 
 #endif /* !KERNEL */