[apple/xnu.git] / bsd / sys / msg.h

/*
 * Copyright (c) 2000-2007 Apple 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. 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
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
 */
/*	$NetBSD: msg.h,v 1.4 1994/06/29 06:44:43 cgd Exp $	*/

/*
 * SVID compatible msg.h file
 *
 * Author:  Daniel Boulet
 *
 * Copyright 1993 Daniel Boulet and RTMX Inc.
 *
 * This system call was implemented by Daniel Boulet under contract from RTMX.
 *
 * Redistribution and use in source forms, with and without modification,
 * are permitted provided that this entire comment appears intact.
 *
 * Redistribution in binary form may occur without any restrictions.
 * Obviously, it would be nice if you gave credit where credit is due
 * but requiring it would be too onerous.
 *
 * This software is provided ``AS IS'' without any warranties of any kind.
 */
/*
 * NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce
 * support for mandatory and extensible security protections.  This notice
 * is included in support of clause 2.2 (b) of the Apple Public License,
 * Version 2.0.
 */

#ifndef _SYS_MSG_H_
#define _SYS_MSG_H_

#include <sys/appleapiopts.h>

#include <sys/_types.h>
#include <sys/cdefs.h>

/*
 * [XSI] All of the symbols from <sys/ipc.h> SHALL be defined when this
 * header is included
 */
#include <sys/ipc.h>


/*
 * [XSI] The pid_t, time_t, key_t, size_t, and ssize_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>
 */
#ifndef _PID_T
typedef __darwin_pid_t		pid_t;
#define _PID_T
#endif

#ifndef	_TIME_T
#define	_TIME_T
typedef	__darwin_time_t		time_t;
#endif

#ifndef _SIZE_T
#define _SIZE_T
typedef __darwin_size_t		size_t;
#endif

#ifndef	_SSIZE_T
#define	_SSIZE_T
typedef	__darwin_ssize_t	ssize_t;
#endif

/* [XSI] Used for the number of messages in the message queue */
typedef unsigned long		msgqnum_t;

/* [XSI] Used for the number of bytes allowed in a message queue */
typedef unsigned long		msglen_t;

/*
 * Possible values for the fifth parameter to msgrcv(), in addition to the
 * IPC_NOWAIT flag, which is permitted.
 */
#define MSG_NOERROR	010000		/* [XSI] No error if big message */


/*
 * 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.
 */
#if __DARWIN_UNIX03 || defined(KERNEL)
#pragma pack(4)
/*
 * Structure used internally.
 * 
 * Structure whose address is passed as the third parameter to msgctl()
 * when the second parameter is IPC_SET or IPC_STAT.  In the case of the
 * IPC_SET command, only the msg_perm.{uid|gid|perm} and msg_qbytes are
 * honored.  In the case of IPC_STAT, only the fields indicated as [XSI]
 * mandated fields are guaranteed to meaningful: DO NOT depend on the
 * contents of the other fields.
 *
 * NOTES:	Reserved fields are not preserved across IPC_SET/IPC_STAT.
 */
#if (defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE))
struct msqid_ds
#else
#define	msqid_ds	__msqid_ds_new
struct __msqid_ds_new
#endif
{
	struct __ipc_perm_new	msg_perm; /* [XSI] msg queue permissions */
	__int32_t	msg_first;	/* RESERVED: kernel use only */
	__int32_t	msg_last;	/* RESERVED: kernel use only */
	msglen_t	msg_cbytes;	/* # of bytes on the queue */
	msgqnum_t	msg_qnum;	/* [XSI] number of msgs on the queue */
	msglen_t	msg_qbytes;	/* [XSI] max bytes on the queue */
	pid_t		msg_lspid;	/* [XSI] pid of last msgsnd() */
	pid_t		msg_lrpid;	/* [XSI] pid of last msgrcv() */
	time_t		msg_stime;	/* [XSI] time of last msgsnd() */
	__int32_t	msg_pad1;	/* RESERVED: DO NOT USE */
	time_t		msg_rtime;	/* [XSI] time of last msgrcv() */
	__int32_t	msg_pad2;	/* RESERVED: DO NOT USE */
	time_t		msg_ctime;	/* [XSI] time of last msgctl() */
	__int32_t	msg_pad3;	/* RESERVED: DO NOT USE */
	__int32_t	msg_pad4[4];	/* RESERVED: DO NOT USE */
};
#pragma pack()
#else	/* !__DARWIN_UNIX03 */
#define	msqid_ds	__msqid_ds_old
#endif	/* !__DARWIN_UNIX03 */

#if !__DARWIN_UNIX03
struct __msqid_ds_old {
	struct __ipc_perm_old	msg_perm; /* [XSI] msg queue permissions */
	__int32_t	msg_first;	/* RESERVED: kernel use only */
	__int32_t	msg_last;	/* RESERVED: kernel use only */
	msglen_t	msg_cbytes;	/* # of bytes on the queue */
	msgqnum_t	msg_qnum;	/* [XSI] number of msgs on the queue */
	msglen_t	msg_qbytes;	/* [XSI] max bytes on the queue */
	pid_t		msg_lspid;	/* [XSI] pid of last msgsnd() */
	pid_t		msg_lrpid;	/* [XSI] pid of last msgrcv() */
	time_t		msg_stime;	/* [XSI] time of last msgsnd() */
	__int32_t	msg_pad1;	/* RESERVED: DO NOT USE */
	time_t		msg_rtime;	/* [XSI] time of last msgrcv() */
	__int32_t	msg_pad2;	/* RESERVED: DO NOT USE */
	time_t		msg_ctime;	/* [XSI] time of last msgctl() */
	__int32_t	msg_pad3;	/* RESERVED: DO NOT USE */
	__int32_t	msg_pad4[4];	/* RESERVED: DO NOT USE */
};
#endif	/* !__DARWIN_UNIX03 */

#ifdef KERNEL
#ifdef __APPLE_API_PRIVATE
#include <machine/types.h>

#if __DARWIN_ALIGN_NATURAL
#pragma options align=natural
#endif

typedef user_ulong_t	user_msgqnum_t;
typedef user64_ulong_t	user64_msgqnum_t;
typedef user32_ulong_t	user32_msgqnum_t;

typedef user_ulong_t	user_msglen_t;
typedef user64_ulong_t	user64_msglen_t;
typedef user32_ulong_t	user32_msglen_t;

/* kernel version */
struct user_msqid_ds {
	struct ipc_perm	msg_perm;	/* [XSI] msg queue permissions */
	struct msg	*msg_first;	/* first message in the queue */
	struct msg	*msg_last;	/* last message in the queue */
	user_msglen_t	msg_cbytes;	/* # of bytes on the queue */
	user_msgqnum_t	msg_qnum;	/* [XSI] number of msgs on the queue */
	user_msglen_t	msg_qbytes;	/* [XSI] max bytes on the queue */
	pid_t		msg_lspid;	/* [XSI] pid of last msgsnd() */
	pid_t		msg_lrpid;	/* [XSI] pid of last msgrcv() */
	user_time_t	msg_stime;	/* [XSI] time of last msgsnd() */
	__int32_t	msg_pad1;	/* RESERVED: DO NOT USE */
	user_time_t	msg_rtime;	/* [XSI] time of last msgrcv() */
	__int32_t	msg_pad2;	/* RESERVED: DO NOT USE */
	user_time_t	msg_ctime;	/* [XSI] time of last msgctl() */
	__int32_t	msg_pad3;	/* RESERVED: DO NOT USE */
	__int32_t	msg_pad4[4];
};

/*
 * user64 version - this structure only has to be correct if
 * compiled LP64, because the 32 bit kernel doesn't need it
 */
struct user64_msqid_ds {
	struct ipc_perm	msg_perm;	/* [XSI] msg queue permissions */
	__int32_t	msg_first;	/* RESERVED: kernel use only */
	__int32_t	msg_last;	/* RESERVED: kernel use only */
	user64_msglen_t	msg_cbytes;	/* # of bytes on the queue */
	user64_msgqnum_t	msg_qnum;	/* [XSI] number of msgs on the queue */
	user64_msglen_t	msg_qbytes;	/* [XSI] max bytes on the queue */
	pid_t		msg_lspid;	/* [XSI] pid of last msgsnd() */
	pid_t		msg_lrpid;	/* [XSI] pid of last msgrcv() */
	user64_time_t	msg_stime;	/* [XSI] time of last msgsnd() */
	__int32_t	msg_pad1;	/* RESERVED: DO NOT USE */
	user64_time_t	msg_rtime;	/* [XSI] time of last msgrcv() */
	__int32_t	msg_pad2;	/* RESERVED: DO NOT USE */
	user64_time_t	msg_ctime;	/* [XSI] time of last msgctl() */
	__int32_t	msg_pad3;	/* RESERVED: DO NOT USE */
	__int32_t	msg_pad4[4];
} __attribute__((__packed__));

struct user32_msqid_ds
{
	struct __ipc_perm_new	msg_perm; /* [XSI] msg queue permissions */
	__int32_t	msg_first;	/* RESERVED: kernel use only */
	__int32_t	msg_last;	/* RESERVED: kernel use only */
	user32_msglen_t	msg_cbytes;	/* # of bytes on the queue */
	user32_msgqnum_t	msg_qnum;	/* [XSI] number of msgs on the queue */
	user32_msglen_t	msg_qbytes;	/* [XSI] max bytes on the queue */
	pid_t		msg_lspid;	/* [XSI] pid of last msgsnd() */
	pid_t		msg_lrpid;	/* [XSI] pid of last msgrcv() */
	user32_time_t		msg_stime;	/* [XSI] time of last msgsnd() */
	__int32_t	msg_pad1;	/* RESERVED: DO NOT USE */
	user32_time_t		msg_rtime;	/* [XSI] time of last msgrcv() */
	__int32_t	msg_pad2;	/* RESERVED: DO NOT USE */
	user32_time_t		msg_ctime;	/* [XSI] time of last msgctl() */
	__int32_t	msg_pad3;	/* RESERVED: DO NOT USE */
	__int32_t	msg_pad4[4];	/* RESERVED: DO NOT USE */
};

#if __DARWIN_ALIGN_NATURAL
#pragma options align=reset
#endif

struct label;

/*
 * Kernel wrapper for the user-level structure
 */
struct msqid_kernel {
	struct	user_msqid_ds u;
	struct	label *label;	/* MAC framework label */
};

#endif	/* __APPLE_API_PRIVATE */
#endif	/* KERNEL */


#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
#ifdef __APPLE_API_UNSTABLE
/* XXX kernel only; protect with macro later */

struct msg {
	struct msg	*msg_next;	/* next msg in the chain */
	long		msg_type;	/* type of this message */
    					/* >0 -> type of this message */
    					/* 0 -> free header */
	unsigned short	msg_ts;		/* size of this message */
	short		msg_spot;	/* location of msg start in buffer */
	struct label	*label;		/* MAC label */
};

/*
 * Example structure describing a message whose address is to be passed as
 * the second argument to the functions msgrcv() and msgsnd().  The only
 * actual hard requirement is that the first field be of type long, and
 * contain the message type.  The user is encouraged to define their own
 * application specific structure; this definition is included solely for
 * backward compatability with existing source code.
 */
struct mymsg {
	long	mtype;		/* message type (+ve integer) */
	char	mtext[1];	/* message body */
};

/*
 * Based on the configuration parameters described in an SVR2 (yes, two)
 * config(1m) man page.
 *
 * Each message is broken up and stored in segments that are msgssz bytes
 * long.  For efficiency reasons, this should be a power of two.  Also,
 * it doesn't make sense if it is less than 8 or greater than about 256.
 * Consequently, msginit in kern/sysv_msg.c checks that msgssz is a power of
 * two between 8 and 1024 inclusive (and panic's if it isn't).
 */
struct msginfo {
	int	msgmax,		/* max chars in a message */
		msgmni,		/* max message queue identifiers */
		msgmnb,		/* max chars in a queue */
		msgtql,		/* max messages in system */
		msgssz,		/* size of a message segment (see notes above) */
		msgseg;		/* number of message segments */
};
#ifdef KERNEL
extern struct msginfo	msginfo;

#ifndef MSGSSZ
#define MSGSSZ	8		/* Each segment must be 2^N long */
#endif
#ifndef MSGSEG
#define MSGSEG	2048		/* must be less than 32767 */
#endif
#define MSGMAX	(MSGSSZ*MSGSEG)
#ifndef MSGMNB
#define MSGMNB	2048		/* max # of bytes in a queue */
#endif
#ifndef MSGMNI
#define MSGMNI	40
#endif
#ifndef MSGTQL
#define MSGTQL	40
#endif

/*
 * macros to convert between msqid_ds's and msqid's.
 * (specific to this implementation)
 */
#define MSQID(ix,ds)	((ix) & 0xffff | (((ds).msg_perm.seq << 16) & 0xffff0000))
#define MSQID_IX(id)	((id) & 0xffff)
#define MSQID_SEQ(id)	(((id) >> 16) & 0xffff)

/*
 * The rest of this file is specific to this particular implementation.
 */


/*
 * Stuff allocated in machdep.h
 */
struct msgmap {
	short	next;		/* next segment in buffer */
    				/* -1 -> available */
    				/* 0..(MSGSEG-1) -> index of next segment */
};

/* The following four externs really, really need to die; should be static */
extern char *msgpool;		/* MSGMAX byte long msg buffer pool */
extern struct msgmap *msgmaps;	/* MSGSEG msgmap structures */
extern struct msg *msghdrs;	/* MSGTQL msg headers */
extern struct msqid_kernel *msqids;	/* MSGMNI user_msqid_ds struct's */

#define MSG_LOCKED	01000	/* Is this msqid_ds locked? */

#endif	/* KERNEL */
#endif	/* __APPLE_API_UNSTABLE */
#endif	/* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */

#ifndef KERNEL

__BEGIN_DECLS
#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
int msgsys(int, ...);
#endif	/* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
int msgctl(int, int, struct msqid_ds *) __DARWIN_ALIAS(msgctl);
int msgget(key_t, int);
ssize_t msgrcv(int, void *, size_t, long, int) __DARWIN_ALIAS_C(msgrcv);
int msgsnd(int, const void *, size_t, int) __DARWIN_ALIAS_C(msgsnd);
__END_DECLS

#endif /* !KERNEL */

#endif /* !_SYS_MSG_H_ */
Commit	Line	Data
1c79356b	1	/*
2d21ac55	2	* Copyright (c) 2000-2007 Apple Inc. All rights reserved.
5d5c5d0d	3	*
2d21ac55	4	* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
1c79356b	5	*
2d21ac55 A	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. The rights granted to you under the License
	10	* may not be used to create, or enable the creation or redistribution of,
	11	* unlawful or unlicensed copies of an Apple operating system, or to
	12	* circumvent, violate, or enable the circumvention or violation of, any
	13	* terms of an Apple operating system software license agreement.
8f6c56a5	14	*
2d21ac55 A	15	* Please obtain a copy of the License at
	16	* http://www.opensource.apple.com/apsl/ and read it before using this file.
	17	*
	18	* The Original Code and all software distributed under the License are
	19	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
8f6c56a5 A	20	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
8f6c56a5 A	21	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
2d21ac55 A	22	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	23	* Please see the License for the specific language governing rights and
	24	* limitations under the License.
8f6c56a5	25	*
2d21ac55	26	* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
1c79356b A	27	*/
	28	/* $NetBSD: msg.h,v 1.4 1994/06/29 06:44:43 cgd Exp $ */
	29
	30	/*
	31	* SVID compatible msg.h file
	32	*
	33	* Author: Daniel Boulet
	34	*
	35	* Copyright 1993 Daniel Boulet and RTMX Inc.
	36	*
	37	* This system call was implemented by Daniel Boulet under contract from RTMX.
	38	*
	39	* Redistribution and use in source forms, with and without modification,
	40	* are permitted provided that this entire comment appears intact.
	41	*
	42	* Redistribution in binary form may occur without any restrictions.
	43	* Obviously, it would be nice if you gave credit where credit is due
	44	* but requiring it would be too onerous.
	45	*
	46	* This software is provided ``AS IS'' without any warranties of any kind.
	47	*/
2d21ac55 A	48	/*
	49	* NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce
	50	* support for mandatory and extensible security protections. This notice
	51	* is included in support of clause 2.2 (b) of the Apple Public License,
	52	* Version 2.0.
	53	*/
1c79356b A	54
	55	#ifndef _SYS_MSG_H_
	56	#define _SYS_MSG_H_
	57
9bccf70c A	58	#include <sys/appleapiopts.h>
9bccf70c A	59
91447636 A	60	#include <sys/_types.h>
	61	#include <sys/cdefs.h>
	62
	63	/*
	64	* [XSI] All of the symbols from <sys/ipc.h> SHALL be defined when this
	65	* header is included
	66	*/
1c79356b A	67	#include <sys/ipc.h>
1c79356b A	68
9bccf70c	69
1c79356b	70	/*
91447636 A	71	* [XSI] The pid_t, time_t, key_t, size_t, and ssize_t types shall be
	72	* defined as described in <sys/types.h>.
	73	*
	74	* NOTE: The definition of the key_t type is implicit from the
	75	* inclusion of <sys/ipc.h>
	76	*/
	77	#ifndef _PID_T
	78	typedef __darwin_pid_t pid_t;
	79	#define _PID_T
	80	#endif
	81
	82	#ifndef _TIME_T
	83	#define _TIME_T
	84	typedef __darwin_time_t time_t;
	85	#endif
	86
	87	#ifndef _SIZE_T
	88	#define _SIZE_T
	89	typedef __darwin_size_t size_t;
	90	#endif
	91
	92	#ifndef _SSIZE_T
	93	#define _SSIZE_T
	94	typedef __darwin_ssize_t ssize_t;
	95	#endif
	96
	97	/* [XSI] Used for the number of messages in the message queue */
	98	typedef unsigned long msgqnum_t;
	99
	100	/* [XSI] Used for the number of bytes allowed in a message queue */
	101	typedef unsigned long msglen_t;
91447636 A	102
	103	/*
	104	* Possible values for the fifth parameter to msgrcv(), in addition to the
	105	* IPC_NOWAIT flag, which is permitted.
1c79356b	106	*/
91447636 A	107	#define MSG_NOERROR 010000 /* [XSI] No error if big message */
91447636 A	108
1c79356b	109
91447636 A	110	/*
	111	* Technically, we should force all code references to the new structure
	112	* definition, not in just the standards conformance case, and leave the
	113	* legacy interface there for binary compatibility only. Currently, we
	114	* are only forcing this for programs requesting standards conformance.
	115	*/
2d21ac55 A	116	#if __DARWIN_UNIX03 \|\| defined(KERNEL)
2d21ac55 A	117	#pragma pack(4)
91447636 A	118	/*
	119	* Structure used internally.
	120	*
	121	* Structure whose address is passed as the third parameter to msgctl()
	122	* when the second parameter is IPC_SET or IPC_STAT. In the case of the
	123	* IPC_SET command, only the msg_perm.{uid\|gid\|perm} and msg_qbytes are
	124	* honored. In the case of IPC_STAT, only the fields indicated as [XSI]
	125	* mandated fields are guaranteed to meaningful: DO NOT depend on the
	126	* contents of the other fields.
	127	*
	128	* NOTES: Reserved fields are not preserved across IPC_SET/IPC_STAT.
	129	*/
2d21ac55 A	130	#if (defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE))
	131	struct msqid_ds
	132	#else
	133	#define msqid_ds __msqid_ds_new
	134	struct __msqid_ds_new
	135	#endif
	136	{
91447636 A	137	struct __ipc_perm_new msg_perm; /* [XSI] msg queue permissions */
	138	__int32_t msg_first; /* RESERVED: kernel use only */
	139	__int32_t msg_last; /* RESERVED: kernel use only */
	140	msglen_t msg_cbytes; /* # of bytes on the queue */
	141	msgqnum_t msg_qnum; /* [XSI] number of msgs on the queue */
	142	msglen_t msg_qbytes; /* [XSI] max bytes on the queue */
	143	pid_t msg_lspid; /* [XSI] pid of last msgsnd() */
	144	pid_t msg_lrpid; /* [XSI] pid of last msgrcv() */
	145	time_t msg_stime; /* [XSI] time of last msgsnd() */
	146	__int32_t msg_pad1; /* RESERVED: DO NOT USE */
	147	time_t msg_rtime; /* [XSI] time of last msgrcv() */
	148	__int32_t msg_pad2; /* RESERVED: DO NOT USE */
	149	time_t msg_ctime; /* [XSI] time of last msgctl() */
	150	__int32_t msg_pad3; /* RESERVED: DO NOT USE */
	151	__int32_t msg_pad4[4]; /* RESERVED: DO NOT USE */
	152	};
2d21ac55 A	153	#pragma pack()
2d21ac55 A	154	#else /* !__DARWIN_UNIX03 */
91447636	155	#define msqid_ds __msqid_ds_old
2d21ac55	156	#endif /* !__DARWIN_UNIX03 */
91447636	157
2d21ac55	158	#if !__DARWIN_UNIX03
91447636 A	159	struct __msqid_ds_old {
	160	struct __ipc_perm_old msg_perm; /* [XSI] msg queue permissions */
	161	__int32_t msg_first; /* RESERVED: kernel use only */
	162	__int32_t msg_last; /* RESERVED: kernel use only */
	163	msglen_t msg_cbytes; /* # of bytes on the queue */
	164	msgqnum_t msg_qnum; /* [XSI] number of msgs on the queue */
	165	msglen_t msg_qbytes; /* [XSI] max bytes on the queue */
	166	pid_t msg_lspid; /* [XSI] pid of last msgsnd() */
	167	pid_t msg_lrpid; /* [XSI] pid of last msgrcv() */
	168	time_t msg_stime; /* [XSI] time of last msgsnd() */
	169	__int32_t msg_pad1; /* RESERVED: DO NOT USE */
	170	time_t msg_rtime; /* [XSI] time of last msgrcv() */
	171	__int32_t msg_pad2; /* RESERVED: DO NOT USE */
	172	time_t msg_ctime; /* [XSI] time of last msgctl() */
	173	__int32_t msg_pad3; /* RESERVED: DO NOT USE */
	174	__int32_t msg_pad4[4]; /* RESERVED: DO NOT USE */
1c79356b	175	};
2d21ac55	176	#endif /* !__DARWIN_UNIX03 */
91447636 A	177
	178	#ifdef KERNEL
	179	#ifdef __APPLE_API_PRIVATE
	180	#include <machine/types.h>
	181
91447636 A	182	#if __DARWIN_ALIGN_NATURAL
	183	#pragma options align=natural
	184	#endif
	185
b0d623f7 A	186	typedef user_ulong_t user_msgqnum_t;
	187	typedef user64_ulong_t user64_msgqnum_t;
	188	typedef user32_ulong_t user32_msgqnum_t;
	189
	190	typedef user_ulong_t user_msglen_t;
	191	typedef user64_ulong_t user64_msglen_t;
	192	typedef user32_ulong_t user32_msglen_t;
	193
	194	/* kernel version */
91447636 A	195	struct user_msqid_ds {
	196	struct ipc_perm msg_perm; /* [XSI] msg queue permissions */
	197	struct msg msg_first; / first message in the queue */
	198	struct msg msg_last; / last message in the queue */
2d21ac55 A	199	user_msglen_t msg_cbytes; /* # of bytes on the queue */
	200	user_msgqnum_t msg_qnum; /* [XSI] number of msgs on the queue */
	201	user_msglen_t msg_qbytes; /* [XSI] max bytes on the queue */
91447636 A	202	pid_t msg_lspid; /* [XSI] pid of last msgsnd() */
	203	pid_t msg_lrpid; /* [XSI] pid of last msgrcv() */
	204	user_time_t msg_stime; /* [XSI] time of last msgsnd() */
	205	__int32_t msg_pad1; /* RESERVED: DO NOT USE */
	206	user_time_t msg_rtime; /* [XSI] time of last msgrcv() */
	207	__int32_t msg_pad2; /* RESERVED: DO NOT USE */
	208	user_time_t msg_ctime; /* [XSI] time of last msgctl() */
	209	__int32_t msg_pad3; /* RESERVED: DO NOT USE */
	210	__int32_t msg_pad4[4];
	211	};
	212
b0d623f7 A	213	/*
	214	* user64 version - this structure only has to be correct if
	215	* compiled LP64, because the 32 bit kernel doesn't need it
	216	*/
	217	struct user64_msqid_ds {
	218	struct ipc_perm msg_perm; /* [XSI] msg queue permissions */
	219	__int32_t msg_first; /* RESERVED: kernel use only */
	220	__int32_t msg_last; /* RESERVED: kernel use only */
	221	user64_msglen_t msg_cbytes; /* # of bytes on the queue */
	222	user64_msgqnum_t msg_qnum; /* [XSI] number of msgs on the queue */
	223	user64_msglen_t msg_qbytes; /* [XSI] max bytes on the queue */
	224	pid_t msg_lspid; /* [XSI] pid of last msgsnd() */
	225	pid_t msg_lrpid; /* [XSI] pid of last msgrcv() */
	226	user64_time_t msg_stime; /* [XSI] time of last msgsnd() */
	227	__int32_t msg_pad1; /* RESERVED: DO NOT USE */
	228	user64_time_t msg_rtime; /* [XSI] time of last msgrcv() */
	229	__int32_t msg_pad2; /* RESERVED: DO NOT USE */
	230	user64_time_t msg_ctime; /* [XSI] time of last msgctl() */
	231	__int32_t msg_pad3; /* RESERVED: DO NOT USE */
	232	__int32_t msg_pad4[4];
	233	} __attribute__((__packed__));
	234
	235	struct user32_msqid_ds
	236	{
	237	struct __ipc_perm_new msg_perm; /* [XSI] msg queue permissions */
	238	__int32_t msg_first; /* RESERVED: kernel use only */
	239	__int32_t msg_last; /* RESERVED: kernel use only */
	240	user32_msglen_t msg_cbytes; /* # of bytes on the queue */
	241	user32_msgqnum_t msg_qnum; /* [XSI] number of msgs on the queue */
	242	user32_msglen_t msg_qbytes; /* [XSI] max bytes on the queue */
	243	pid_t msg_lspid; /* [XSI] pid of last msgsnd() */
	244	pid_t msg_lrpid; /* [XSI] pid of last msgrcv() */
	245	user32_time_t msg_stime; /* [XSI] time of last msgsnd() */
	246	__int32_t msg_pad1; /* RESERVED: DO NOT USE */
	247	user32_time_t msg_rtime; /* [XSI] time of last msgrcv() */
	248	__int32_t msg_pad2; /* RESERVED: DO NOT USE */
	249	user32_time_t msg_ctime; /* [XSI] time of last msgctl() */
	250	__int32_t msg_pad3; /* RESERVED: DO NOT USE */
	251	__int32_t msg_pad4[4]; /* RESERVED: DO NOT USE */
	252	};
	253
91447636 A	254	#if __DARWIN_ALIGN_NATURAL
	255	#pragma options align=reset
	256	#endif
	257
2d21ac55 A	258	struct label;
	259
	260	/*
	261	* Kernel wrapper for the user-level structure
	262	*/
	263	struct msqid_kernel {
	264	struct user_msqid_ds u;
	265	struct label label; / MAC framework label */
	266	};
	267
91447636 A	268	#endif /* __APPLE_API_PRIVATE */
	269	#endif /* KERNEL */
	270
	271
2d21ac55	272	#if !defined(_POSIX_C_SOURCE) \|\| defined(_DARWIN_C_SOURCE)
91447636 A	273	#ifdef __APPLE_API_UNSTABLE
91447636 A	274	/* XXX kernel only; protect with macro later */
1c79356b A	275
1c79356b A	276	struct msg {
91447636 A	277	struct msg msg_next; / next msg in the chain */
	278	long msg_type; /* type of this message */
	279	/* >0 -> type of this message */
	280	/* 0 -> free header */
	281	unsigned short msg_ts; /* size of this message */
	282	short msg_spot; /* location of msg start in buffer */
2d21ac55	283	struct label label; / MAC label */
1c79356b A	284	};
	285
	286	/*
91447636 A	287	* Example structure describing a message whose address is to be passed as
	288	* the second argument to the functions msgrcv() and msgsnd(). The only
	289	* actual hard requirement is that the first field be of type long, and
	290	* contain the message type. The user is encouraged to define their own
	291	* application specific structure; this definition is included solely for
	292	* backward compatability with existing source code.
1c79356b A	293	*/
	294	struct mymsg {
	295	long mtype; /* message type (+ve integer) */
	296	char mtext[1]; /* message body */
	297	};
	298
	299	/*
	300	* Based on the configuration parameters described in an SVR2 (yes, two)
	301	* config(1m) man page.
	302	*
	303	* Each message is broken up and stored in segments that are msgssz bytes
	304	* long. For efficiency reasons, this should be a power of two. Also,
	305	* it doesn't make sense if it is less than 8 or greater than about 256.
	306	* Consequently, msginit in kern/sysv_msg.c checks that msgssz is a power of
	307	* two between 8 and 1024 inclusive (and panic's if it isn't).
	308	*/
	309	struct msginfo {
	310	int msgmax, /* max chars in a message */
	311	msgmni, /* max message queue identifiers */
	312	msgmnb, /* max chars in a queue */
	313	msgtql, /* max messages in system */
	314	msgssz, /* size of a message segment (see notes above) */
	315	msgseg; /* number of message segments */
	316	};
	317	#ifdef KERNEL
	318	extern struct msginfo msginfo;
	319
	320	#ifndef MSGSSZ
	321	#define MSGSSZ 8 /* Each segment must be 2^N long */
	322	#endif
	323	#ifndef MSGSEG
	324	#define MSGSEG 2048 /* must be less than 32767 */
	325	#endif
	326	#define MSGMAX (MSGSSZ*MSGSEG)
	327	#ifndef MSGMNB
	328	#define MSGMNB 2048 /* max # of bytes in a queue */
	329	#endif
	330	#ifndef MSGMNI
	331	#define MSGMNI 40
	332	#endif
	333	#ifndef MSGTQL
	334	#define MSGTQL 40
	335	#endif
	336
	337	/*
	338	* macros to convert between msqid_ds's and msqid's.
	339	* (specific to this implementation)
	340	*/
	341	#define MSQID(ix,ds) ((ix) & 0xffff \| (((ds).msg_perm.seq << 16) & 0xffff0000))
	342	#define MSQID_IX(id) ((id) & 0xffff)
	343	#define MSQID_SEQ(id) (((id) >> 16) & 0xffff)
	344
	345	/*
	346	* The rest of this file is specific to this particular implementation.
	347	*/
	348
	349
	350	/*
	351	* Stuff allocated in machdep.h
	352	*/
	353	struct msgmap {
	354	short next; /* next segment in buffer */
	355	/* -1 -> available */
	356	/* 0..(MSGSEG-1) -> index of next segment */
357	};
358
91447636	359	/* The following four externs really, really need to die; should be static */
1c79356b A	360	extern char msgpool; / MSGMAX byte long msg buffer pool */
	361	extern struct msgmap msgmaps; / MSGSEG msgmap structures */
	362	extern struct msg msghdrs; / MSGTQL msg headers */
2d21ac55	363	extern struct msqid_kernel msqids; / MSGMNI user_msqid_ds struct's */
1c79356b A	364
	365	#define MSG_LOCKED 01000 /* Is this msqid_ds locked? */
	366
91447636 A	367	#endif /* KERNEL */
91447636 A	368	#endif /* __APPLE_API_UNSTABLE */
2d21ac55	369	#endif /* (!_POSIX_C_SOURCE \|\| _DARWIN_C_SOURCE) */
1c79356b A	370
1c79356b A	371	#ifndef KERNEL
1c79356b A	372
1c79356b A	373	__BEGIN_DECLS
2d21ac55	374	#if !defined(_POSIX_C_SOURCE) \|\| defined(_DARWIN_C_SOURCE)
91447636	375	int msgsys(int, ...);
2d21ac55	376	#endif /* (!_POSIX_C_SOURCE \|\| _DARWIN_C_SOURCE) */
91447636 A	377	int msgctl(int, int, struct msqid_ds *) __DARWIN_ALIAS(msgctl);
91447636 A	378	int msgget(key_t, int);
2d21ac55 A	379	ssize_t msgrcv(int, void *, size_t, long, int) __DARWIN_ALIAS_C(msgrcv);
2d21ac55 A	380	int msgsnd(int, const void *, size_t, int) __DARWIN_ALIAS_C(msgsnd);
1c79356b	381	__END_DECLS
91447636	382
1c79356b A	383	#endif /* !KERNEL */
	384
	385	#endif /* !_SYS_MSG_H_ */
2d21ac55 A	386
2d21ac55 A	387