module xdc.runtime.GateNull

Empty implementation of IGateProvider

C synopsis
Individual elements
Configuration settings
Individual elements

An instance of this IGateProvider implementation is assigned to all gated modules as a default module-wide gate. Instances of this gate implementation provide no protection for critical sections and should only be used for modules in which the data structures protected by module-level gates are never accessed by concurrent threads.

C synopsis target-domain sourced in xdc/runtime/GateNull.xdc

#include <xdc/runtime/GateNull.h>

Functions
Void	GateNull_construct// Initialize a new instance object inside the provided structure(GateNull_Struct structP, const GateNull_Params params);
GateNull_Handle	GateNull_create// Allocate and initialize a new instance object and return its handle(const GateNull_Params params, Error_Block eb);
Void	GateNull_delete// Finalize and free this previously allocated instance object, setting the referenced handle to NULL(GateNull_Handle *handleP);
Void	GateNull_destruct// Finalize the instance object inside the provided structure(GateNull_Struct *structP);
Void	GateNull_Params_init// Initialize this config-params structure with supplier-specified defaults before instance creation(GateNull_Params *params);
Functions common to all IGateProvider modules
IArg	GateNull_enter// Enter this gate(GateNull_Handle handle);
Void	GateNull_leave// Leave this gate(GateNull_Handle handle, IArg key);
Bool	GateNull_query// Runtime test for a particular gate quality(Int qual);
Functions common to all target instances
	GateNull_handle// Convert this instance structure pointer into an instance handle, GateNull_Handle_downCast// conditionally move one level down the inheritance hierarchy; NULL upon failure, GateNull_Handle_label// The label associated with this instance object, GateNull_Handle_name// The name of this instance object, GateNull_Handle_upCast// unconditionally move one level up the inheritance hierarchy, GateNull_Object_count// The number of statically-created instance objects, GateNull_Object_first// The handle of the first dynamically-created instance object, or NULL, GateNull_Object_get// The handle of the i-th statically-created instance object (array == NULL), GateNull_Object_heap// The heap used to allocate dynamically-created instance objects, GateNull_Object_next// The handle of the next dynamically-created instance object, or NULL, GateNull_struct// Convert this instance handle into an instance structure pointer
Functions common to all target modules
	GateNull_Module_getMask// Returns the diagnostics mask for this module, GateNull_Module_hasMask// Test whether this module has a diagnostics mask, GateNull_Module_heap// The heap from which this module allocates memory, GateNull_Module_id// Get this module's unique id, GateNull_Module_setMask// Set the diagnostics mask for this module, GateNull_Module_startupDone// Test if this module has completed startup
Defines
#define	GateNull_Q_BLOCKING// Blocking quality (Int)1
#define	GateNull_Q_PREEMPTING// Preempting quality (Int)2
Typedefs
typedef GateNull_Object *	GateNull_Handle// Client reference to an instance object;
typedef struct	GateNull_Object// Opaque internal representation of an instance object GateNull_Object;
typedef struct	GateNull_Params// Instance config-params structure ...
typedef struct	GateNull_Struct// Opaque client structure large enough to hold an instance object GateNull_Struct;

const GateNull_Q_BLOCKING