[apple/xnu.git] / osfmk / kern / sync_lock.h

/*
 * Copyright (c) 2000-2004 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. 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@
 */
/*
 * @OSF_COPYRIGHT@
 * 
 */
/*
 *	File:	kern/sync_lock.h
 *	Author:	Joseph CaraDonna
 *
 *	Contains RT distributed lock synchronization service definitions.
 */

#ifndef _KERN_SYNC_LOCK_H_
#define _KERN_SYNC_LOCK_H_

#include <mach/mach_types.h>

#ifdef	MACH_KERNEL_PRIVATE

#include <kern/wait_queue.h>
#include <kern/macro_help.h>
#include <kern/queue.h>
#include <kern/locks.h>

typedef struct ulock {
	queue_chain_t	thread_link;	/* ulocks owned by thread MUST BE FIRST */
	queue_chain_t	held_link;	/* ulocks held in the lock set	    */
	queue_chain_t	handoff_link;	/* ulocks w/ active handoffs	    */
	struct lock_set *lock_set;	/* the retaining lock set	    */
	thread_t	holder;		/* thread that holds the lock       */

	struct wait_queue wait_queue;	/* queue of blocked threads	    */

	decl_lck_mtx_data(,lock)	/* ulock lock			    */

	unsigned int			/* flags                            */
	/* boolean_t */ blocked:1,	/*     did threads block waiting?   */
	/* boolean_t */	unstable:1,	/*     unstable? (holder died)	    */
	/* boolean_t */ ho_wait:1,	/*     handoff thread waiting?	    */
	/* boolean_t */ accept_wait:1,	/*     accepting thread waiting?    */
			:0;		/*     force to long boundary       */
} Ulock;

typedef struct ulock *ulock_t;

typedef struct lock_set {
	queue_chain_t	task_link;   /* lock sets owned by a task MUST BE FIRST */
	task_t		owner;	     /* task that owns the lock set	    */
	ipc_port_t	port;	     /* lock set port			    */
	decl_lck_mtx_data(,lock)     /* lock set lock			    */
	uint32_t	ref_count;   /* reference count			    */

	boolean_t	active;	     /* active status			    */
	int		n_ulocks;    /* number of ulocks in the lock set    */

	struct ulock	ulock_list[1];	/* ulock group list place holder    */
} Lock_Set;

#define ULOCK_NULL	((ulock_t) 0)

#define ULOCK_FREE	0
#define ULOCK_HELD	1

extern lck_grp_t	lock_set_grp;
extern lck_attr_t	lock_set_attr;

/*
 *  Data structure internal lock macros
 */

#define lock_set_lock_init(ls)	lck_mtx_init(&(ls)->lock, &lock_set_grp, &lock_set_attr)
#define lock_set_lock(ls)		lck_mtx_lock(&(ls)->lock)
#define lock_set_unlock(ls)		lck_mtx_unlock(&(ls)->lock)

#define ulock_lock_init(ul)		lck_mtx_init(&(ul)->lock, &lock_set_grp, &lock_set_attr)
#define ulock_lock(ul)			lck_mtx_lock(&(ul)->lock)
#define ulock_unlock(ul)		lck_mtx_unlock(&(ul)->lock)

extern void lock_set_init(void) __attribute__((section("__TEXT, initcode")));

extern	kern_return_t	ulock_release_internal(
					ulock_t		ulock,
					thread_t	thread);

extern	kern_return_t	lock_make_unstable(
					ulock_t 	ulock, 
					thread_t 	thread);

extern	void	ulock_release_all(
					thread_t	thread);

extern	void		lock_set_reference	(lock_set_t lock_set);
extern	void		lock_set_dereference	(lock_set_t lock_set);

#endif	/* MACH_KERNEL_PRIVATE */

#endif /* _KERN_SYNC_LOCK_H_ */
Commit	Line	Data
1c79356b	1	/*
91447636	2	* Copyright (c) 2000-2004 Apple Computer, Inc. All rights reserved.
1c79356b	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	/*
	29	* @OSF_COPYRIGHT@
	30	*
	31	*/
	32	/*
	33	* File: kern/sync_lock.h
	34	* Author: Joseph CaraDonna
	35	*
	36	* Contains RT distributed lock synchronization service definitions.
	37	*/
	38
	39	#ifndef _KERN_SYNC_LOCK_H_
	40	#define _KERN_SYNC_LOCK_H_
	41
	42	#include <mach/mach_types.h>
	43
9bccf70c	44	#ifdef MACH_KERNEL_PRIVATE
1c79356b A	45
	46	#include <kern/wait_queue.h>
	47	#include <kern/macro_help.h>
	48	#include <kern/queue.h>
b0d623f7	49	#include <kern/locks.h>
1c79356b A	50
1c79356b A	51	typedef struct ulock {
b0d623f7	52	queue_chain_t thread_link; /* ulocks owned by thread MUST BE FIRST */
1c79356b A	53	queue_chain_t held_link; /* ulocks held in the lock set */
1c79356b A	54	queue_chain_t handoff_link; /* ulocks w/ active handoffs */
b0d623f7 A	55	struct lock_set lock_set; / the retaining lock set */
	56	thread_t holder; /* thread that holds the lock */
	57
	58	struct wait_queue wait_queue; /* queue of blocked threads */
1c79356b	59
b0d623f7	60	decl_lck_mtx_data(,lock) /* ulock lock */
1c79356b	61
1c79356b A	62	unsigned int /* flags */
	63	/* boolean_t / blocked:1, / did threads block waiting? */
	64	/* boolean_t / unstable:1, / unstable? (holder died) */
	65	/* boolean_t / ho_wait:1, / handoff thread waiting? */
	66	/* boolean_t / accept_wait:1, / accepting thread waiting? */
	67	:0; /* force to long boundary */
1c79356b A	68	} Ulock;
	69
	70	typedef struct ulock *ulock_t;
	71
	72	typedef struct lock_set {
b0d623f7	73	queue_chain_t task_link; /* lock sets owned by a task MUST BE FIRST */
1c79356b A	74	task_t owner; /* task that owns the lock set */
1c79356b A	75	ipc_port_t port; /* lock set port */
b0d623f7 A	76	decl_lck_mtx_data(,lock) /* lock set lock */
b0d623f7 A	77	uint32_t ref_count; /* reference count */
1c79356b A	78
	79	boolean_t active; /* active status */
	80	int n_ulocks; /* number of ulocks in the lock set */
	81
	82	struct ulock ulock_list[1]; /* ulock group list place holder */
	83	} Lock_Set;
	84
	85	#define ULOCK_NULL ((ulock_t) 0)
	86
	87	#define ULOCK_FREE 0
	88	#define ULOCK_HELD 1
	89
b0d623f7 A	90	extern lck_grp_t lock_set_grp;
	91	extern lck_attr_t lock_set_attr;
	92
1c79356b A	93	/*
	94	* Data structure internal lock macros
	95	*/
	96
b0d623f7 A	97	#define lock_set_lock_init(ls) lck_mtx_init(&(ls)->lock, &lock_set_grp, &lock_set_attr)
	98	#define lock_set_lock(ls) lck_mtx_lock(&(ls)->lock)
	99	#define lock_set_unlock(ls) lck_mtx_unlock(&(ls)->lock)
1c79356b	100
b0d623f7 A	101	#define ulock_lock_init(ul) lck_mtx_init(&(ul)->lock, &lock_set_grp, &lock_set_attr)
	102	#define ulock_lock(ul) lck_mtx_lock(&(ul)->lock)
	103	#define ulock_unlock(ul) lck_mtx_unlock(&(ul)->lock)
1c79356b	104
b0d623f7	105	extern void lock_set_init(void) __attribute__((section("__TEXT, initcode")));
1c79356b	106
91447636 A	107	extern kern_return_t ulock_release_internal(
	108	ulock_t ulock,
	109	thread_t thread);
1c79356b	110
91447636 A	111	extern kern_return_t lock_make_unstable(
	112	ulock_t ulock,
	113	thread_t thread);
1c79356b	114
91447636 A	115	extern void ulock_release_all(
91447636 A	116	thread_t thread);
1c79356b A	117
	118	extern void lock_set_reference (lock_set_t lock_set);
	119	extern void lock_set_dereference (lock_set_t lock_set);
	120
91447636 A	121	#endif /* MACH_KERNEL_PRIVATE */
91447636 A	122
1c79356b	123	#endif /* _KERN_SYNC_LOCK_H_ */