1 /* *********************************************************************

2 * This Source Code Form is copyright of 51 Degrees Mobile Experts Limited.

4 * Caversham, Reading, Berkshire, United Kingdom RG4 7BY

5 *

6 * This Source Code Form is subject to the terms of the Mozilla Public

7 * License, v. 2.0.

8 *

9 * If a copy of the MPL was not distributed with this file, You can obtain

10 * one at http://mozilla.org/MPL/2.0/.

11 *

12 * This Source Code Form is "Incompatible With Secondary Licenses", as

13 * defined by the Mozilla Public License, v. 2.0.

14 * ******************************************************************** */

15

16 #ifndef FIFTYONE_DEGREES_MANAGER_INCLUDED

17 #define FIFTYONE_DEGREES_MANAGER_INCLUDED

18

125 /* Define NDEBUG if needed, to ensure asserts are disabled in release builds */

126 #if !defined(DEBUG) && !defined(_DEBUG) && !defined(NDEBUG)

127 #define NDEBUG

128 #endif

129

130 #include <stdlib.h>

131 #include <stdint.h>

132 #include <assert.h>

133 #ifndef FIFTYONE_DEGREES_NO_THREADING

134 #include "threading.h"

135 #endif

136

137 #ifdef __cplusplus

138 #define EXTERNAL extern "C"

139 #else

140 #define EXTERNAL

141 #endif

142

144 typedef struct fiftyone_degrees_resource_manager_t

145 fiftyoneDegreesResourceManager;

151 typedef struct fiftyone_degrees_resource_handle_t {

152 const void *resource;

153 const fiftyoneDegreesResourceManager *manager;

155 void(*freeResource)(void*);

157 volatile long inUse;

158 } fiftyoneDegreesResourceHandle;

159

163 typedef struct fiftyone_degrees_resource_manager_t {

164 #ifndef FIFTYONE_DEGREES_NO_THREADING

165 fiftyoneDegreesResourceHandle volatile *active;

168 #else

169 fiftyoneDegreesResourceHandle *active;

171 #endif

172 } fiftyoneDegreesResourceManager;

173

191 EXTERNAL void fiftyoneDegreesResourceManagerInit(

192 fiftyoneDegreesResourceManager *manager,

193 void *resource,

194 fiftyoneDegreesResourceHandle **resourceHandle,

195 void(*freeResource)(void*));

196

209 EXTERNAL void fiftyoneDegreesResourceManagerFree(

210 fiftyoneDegreesResourceManager *manager);

211

220 EXTERNAL fiftyoneDegreesResourceHandle* fiftyoneDegreesResourceHandleIncUse(

221 fiftyoneDegreesResourceManager *manager);

222

229 EXTERNAL void fiftyoneDegreesResourceHandleDecUse(

230 fiftyoneDegreesResourceHandle *handle);

231

242 EXTERNAL void fiftyoneDegreesResourceReplace(

243 fiftyoneDegreesResourceManager *manager,

244 void *newResource,

245 fiftyoneDegreesResourceHandle **newResourceHandle);

246

251 #endif

fiftyoneDegreesResourceHandle::manager

const fiftyoneDegreesResourceManager * manager

Pointer to the manager the handle relates to.

Definition: resource.h:153

fiftyoneDegreesResourceHandle::resource

const void * resource

Pointer to the resource being managed.

Definition: resource.h:152

fiftyoneDegreesResourceManagerInit

EXTERNAL void fiftyoneDegreesResourceManagerInit(fiftyoneDegreesResourceManager *manager, void *resource, fiftyoneDegreesResourceHandle **resourceHandle, void(*freeResource)(void *))

Initialise a preallocated resource manager structure with a resource for it to manage access to.

Definition: resource.c:64

fiftyoneDegreesResourceHandleIncUse

EXTERNAL fiftyoneDegreesResourceHandle * fiftyoneDegreesResourceHandleIncUse(fiftyoneDegreesResourceManager *manager)

Increments the usage counter for the resource and returns a handle that can be used to reference it.

Definition: resource.c:102

fiftyoneDegreesResourceReplace

EXTERNAL void fiftyoneDegreesResourceReplace(fiftyoneDegreesResourceManager *manager, void *newResource, fiftyoneDegreesResourceHandle **newResourceHandle)

Replaces the resource with the new resource.

Definition: resource.c:120

fiftyoneDegreesResourceHandle

Tracks the number of active uses of the resource within the manager.

Definition: resource.h:151

fiftyoneDegreesResourceHandle::inUse

volatile long inUse

Tracks active use count of the resource.

Definition: resource.h:157

fiftyoneDegreesResourceHandleDecUse

EXTERNAL void fiftyoneDegreesResourceHandleDecUse(fiftyoneDegreesResourceHandle *handle)

Decrements the usage counter.