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

2 * This Original Work is copyright of 51 Degrees Mobile Experts Limited.

4 * Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.

5 *

6 * This Original Work is licensed under the European Union Public Licence

7 * (EUPL) v.1.2 and is subject to its terms as set out below.

8 *

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

10 * one at https://opensource.org/licenses/EUPL-1.2.

11 *

12 * The 'Compatible Licences' set out in the Appendix to the EUPL (as may be

13 * amended by the European Commission) shall be deemed incompatible for

14 * the purposes of the Work and the provisions of the compatibility

15 * clause in Article 5 of the EUPL shall not apply.

16 *

17 * If using the Work as, or as part of, a network application, by

18 * including the attribution notice(s) required under Article 5 of the EUPL

19 * in the end user terms of the application under an appropriate heading,

20 * such notice(s) shall fulfill the requirements of that article.

21 * ********************************************************************* */

22

23 #ifndef FIFTYONE_DEGREES_MANAGER_INCLUDED

24 #define FIFTYONE_DEGREES_MANAGER_INCLUDED

25

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

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

134 #define NDEBUG

135 #endif

136

137 #include <stdlib.h>

138 #include <stdint.h>

139 #include <assert.h>

140 #include "threading.h"

141 #include "common.h"

142

144 typedef struct fiftyone_degrees_resource_manager_t

145 fiftyoneDegreesResourceManager;

146

147 typedef struct fiftyone_degrees_resource_handle_t

148 fiftyoneDegreesResourceHandle;

157 typedef struct fiftyone_degrees_resource_handle_t {

158 #ifndef FIFTYONE_DEGREES_NO_THREADING

159 volatile

160 #endif

161 fiftyoneDegreesInterlockDoubleWidth counter;

163 const void* resource;

164 const fiftyoneDegreesResourceManager* manager;

166 void(*freeResource)(void*);

168 } fiftyoneDegreesResourceHandle;

169

173 typedef struct fiftyone_degrees_resource_manager_t {

174 #ifndef FIFTYONE_DEGREES_NO_THREADING

175 volatile fiftyoneDegreesResourceHandle *active;

178 #else

179 fiftyoneDegreesResourceHandle *active;

181 #endif

182 } fiftyoneDegreesResourceManager;

183

197 EXTERNAL void fiftyoneDegreesResourceManagerInit(

198 fiftyoneDegreesResourceManager *manager,

199 void *resource,

200 fiftyoneDegreesResourceHandle **resourceHandle,

201 void(*freeResource)(void*));

202

209 EXTERNAL void fiftyoneDegreesResourceManagerFree(

210 fiftyoneDegreesResourceManager *manager);

211

220 EXTERNAL fiftyoneDegreesResourceHandle* fiftyoneDegreesResourceHandleIncUse(

221 fiftyoneDegreesResourceManager *manager);

222

229 EXTERNAL void fiftyoneDegreesResourceHandleDecUse(

230 fiftyoneDegreesResourceHandle *handle);

231

239 EXTERNAL int32_t fiftyoneDegreesResourceHandleGetUse(

240 fiftyoneDegreesResourceHandle *handle);

241

252 EXTERNAL void fiftyoneDegreesResourceReplace(

253 fiftyoneDegreesResourceManager *manager,

254 void *newResource,

255 fiftyoneDegreesResourceHandle **newResourceHandle);

256

261 #endif

fiftyoneDegreesResourceHandle::manager

const fiftyoneDegreesResourceManager * manager

Pointer to the manager the handle relates to.

Definition: resource.h:164

fiftyoneDegreesResourceHandle::resource

const void * resource

Pointer to the resource being managed.

Definition: resource.h:163

fiftyoneDegreesResourceReplace

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

Replaces the resource with the new resource.

fiftyoneDegreesResourceHandleDecUse

void fiftyoneDegreesResourceHandleDecUse(fiftyoneDegreesResourceHandle *handle)

Decrements the usage counter.

fiftyoneDegreesResourceHandle::counter

volatile fiftyoneDegreesInterlockDoubleWidth counter

Counter for this handle.

Definition: resource.h:161

fiftyoneDegreesResourceManagerFree

void fiftyoneDegreesResourceManagerFree(fiftyoneDegreesResourceManager *manager)

Frees any data associated with the manager and releases the manager.

fiftyoneDegreesResourceHandle

Handle for a shared resource.

Definition: resource.h:157

fiftyoneDegreesResourceManager

Manager structure used to provide access to a shared and changing resource.

Definition: resource.h:173

fiftyoneDegreesResourceHandleIncUse

fiftyoneDegreesResourceHandle * fiftyoneDegreesResourceHandleIncUse(fiftyoneDegreesResourceManager *manager)

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

fiftyoneDegreesResourceManagerInit

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.

fiftyoneDegreesInterlockDoubleWidth

Double width (64 or 128 depending on the architecture) compare and exchange.

Definition: threading.h:422

fiftyoneDegreesResourceManager::active

volatile fiftyoneDegreesResourceHandle * active

Current handle for resource used by the manager.

Definition: resource.h:175

fiftyoneDegreesResourceHandleGetUse

int32_t fiftyoneDegreesResourceHandleGetUse(fiftyoneDegreesResourceHandle *handle)

Return the current usage counter.

51Degrees Device Detection C/C++ 4.4

resource.h