1 /*
2 * Copyright (c) 2008 Texas Instruments. All rights reserved.
3 * This program and the accompanying materials are made available under the
4 * terms of the Eclipse Public License v1.0 and Eclipse Distribution License
5 * v. 1.0 which accompanies this distribution. The Eclipse Public License is
6 * available at http://www.eclipse.org/legal/epl-v10.html and the Eclipse
7 * Distribution License is available at
8 * http://www.eclipse.org/org/documents/edl-v10.php.
9 *
10 * Contributors:
11 * Texas Instruments - initial implementation
12 * */
13 /*
14 * ======== SemProcess.xdc ========
15 */
16
17 import xdc.runtime.Error;
18 import xdc.runtime.knl.ISemaphore;
19 import xdc.runtime.knl.ISemProcessSupport;
20
21 /*!
22 * ======== SemProcess ========
23 * SemProcess Manager [EXPERIMENTAL]
24 *
25 * This module manages multi-process semaphores through its proxy
26 * ISemProcessSupport interface. It has a module wide config parameter
27 * {@link #Proxy} which needs to be bound to an OS specific delegate before
28 * this module can be used.
29 *
30 * Here is an example showing how the proxy is bound to an BIOS 6.x specific
31 * delegate.
32 *
33 * var SemProcess = xdc.useModule('xdc.runtime.knl.SemProcess');
34 * SemProcess.Proxy = xdc.useModule('ti.sysbios.xdcruntime.SemProcessSupport');
35 *
36 * Typically the package containing the delegates have a Settings module that
37 * will bind all {@link xdc.runtime.knl} proxies. The following
38 * example sets up all the xdc.runtime.knl proxies.
39 *
40 * xdc.useModule("ti.sysbios.xdcruntime.Settings");
41 *
42 */
43
44 @InstanceInitError /* because initialization can fail */
45 @InstanceFinalize /* have to Semaphore_Proxy_delete(sem) on delete */
46
47 module SemProcess inherits ISemaphore
48 {
49
50 /*! Proxy that needs to be bound to an OS specific delegate. */
51 proxy Proxy inherits ISemProcessSupport;
52
53 instance:
54
55 /*!
56 * ======== create ========
57 * Create a SemProcess object
58 *
59 * This function creates a new `SemProcess` object which is initialized to
60 * count. All semaphores created with the same key reference the same
61 * underlying synchronization object and work between processes.
62 *
63 * @param(count) initial semaphore count
64 * @param(key) globally unique key for SysV-style semaphore
65 */
66 create(Int count, UInt32 key);
67
68 internal:
69
70 struct Instance_State {
71 Proxy.Handle proxyHandle;
72 }
73 }
74 /*
75 * @(#) xdc.runtime.knl; 1, 0, 0,16; 6-9-2009 20:09:52; /db/ztree/library/trees/xdc-t50x/src/packages/
76 */
77