]> git.saurik.com Git - apple/xnu.git/blame - osfmk/mach/semaphore.h
xnu-1228.3.13.tar.gz
[apple/xnu.git] / osfmk / mach / semaphore.h
CommitLineData
1c79356b 1/*
91447636 2 * Copyright (c) 2000-2005 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,
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#ifndef _MACH_SEMAPHORE_H_
30#define _MACH_SEMAPHORE_H_
31
32#include <mach/port.h>
33#include <mach/mach_types.h>
34#include <mach/kern_return.h>
35#include <mach/sync_policy.h>
36
1c79356b
A
37/*
38 * Forward Declarations
39 *
40 * The semaphore creation and deallocation routines are
41 * defined with the Mach task APIs in <mach/task.h>.
42 *
43 * kern_return_t semaphore_create(task_t task,
44 * semaphore_t *new_semaphore,
45 * sync_policy_t policy,
46 * int value);
47 *
48 * kern_return_t semaphore_destroy(task_t task,
49 * semaphore_t semaphore);
50 */
51
91447636
A
52#include <sys/cdefs.h>
53__BEGIN_DECLS
54
1c79356b
A
55extern kern_return_t semaphore_signal (semaphore_t semaphore);
56extern kern_return_t semaphore_signal_all (semaphore_t semaphore);
57extern kern_return_t semaphore_signal_thread (semaphore_t semaphore,
91447636 58 thread_t thread);
1c79356b
A
59
60extern kern_return_t semaphore_wait (semaphore_t semaphore);
61extern kern_return_t semaphore_timedwait (semaphore_t semaphore,
62 mach_timespec_t wait_time);
63
64extern kern_return_t semaphore_wait_signal (semaphore_t wait_semaphore,
65 semaphore_t signal_semaphore);
66
67extern kern_return_t semaphore_timedwait_signal(semaphore_t wait_semaphore,
68 semaphore_t signal_semaphore,
69 mach_timespec_t wait_time);
91447636 70__END_DECLS
1c79356b 71
91447636 72#ifdef PRIVATE
9bccf70c
A
73
74#define SEMAPHORE_OPTION_NONE 0x00000000
75
76#define SEMAPHORE_SIGNAL 0x00000001
77#define SEMAPHORE_WAIT 0x00000002
78#define SEMAPHORE_WAIT_ON_SIGNAL 0x00000008
79
80#define SEMAPHORE_SIGNAL_TIMEOUT 0x00000010
81#define SEMAPHORE_SIGNAL_ALL 0x00000020
82#define SEMAPHORE_SIGNAL_INTERRUPT 0x00000040 /* libmach implements */
83#define SEMAPHORE_SIGNAL_PREPOST 0x00000080
84
85#define SEMAPHORE_WAIT_TIMEOUT 0x00000100
86#define SEMAPHORE_WAIT_INTERRUPT 0x00000400 /* libmach implements */
87
88#define SEMAPHORE_TIMEOUT_NOBLOCK 0x00100000
89#define SEMAPHORE_TIMEOUT_RELATIVE 0x00200000
90
91#define SEMAPHORE_USE_SAVED_RESULT 0x01000000 /* internal use only */
92#define SEMAPHORE_SIGNAL_RELEASE 0x02000000 /* internal use only */
93
91447636 94#endif /* PRIVATE */
9bccf70c 95
91447636 96#endif /* _MACH_SEMAPHORE_H_ */