Lines Matching refs:entity

44 Each of these configuration components is referred to as an 'entity'.
108 Access to entities is attained via an entity-specific handle. These
109 handles can be obtained via calls to nwam_<entity>_create() or
110 nwam_<entity>_read(), and freed (in memory) via calls to nwam_<entity>_free().
111 nwam_<entity>_create() will create an in-memory representation of the
112 entity, but that entity will not be stored until nwam_<entity>_commit() is
113 called.  Persistently stored entitites are retrieved via nwam_<entity>_read(),
115 via nwam_<entity>_commit().  Entities can also be copied with
116 nwam_<entity>_copy().
118 All changes made after binding a handle to an entity, and prior to calling 
119 nwam_<entity>_commit() are carried out on the in-memory representation of that
120 entity. nwam_<entity>_commit() updates persistent storage in an all-or-none
124 To destroy an entity in persistent storage, nwam_<entity>_destroy() is
125 used. This is distinct from nwam_<entity>_free(), which simply frees 
129 To summarize, the pattern of interactions with an entity is
130  - nwam_<entity>_read(), nwam_<entity>_create() or nwam_<entity>_copy()
131  - possibly modify entity properties
132  - nwam_<entity>_commit() or nwam_<entity>_destroy()
133  - nwam_<entity>_handle_free()
139 entity (i.e. _read() cannot collide with another entity _commit()ting
141 outdated view of an entity, if after the _read() completes, another
142 entity _commit()s changes. In other words, lost updates are possible.
148 via a call to nwam_<entity>_validate(), and individual property values
149 can be validated via nwam_<entity>_validate_prop().
151 Storage and retrieval of properties is done via nwam_<entity>_set_prop_value()
152 and nwam_<entity>_get_prop_value().  These functions require an nwam_value_t as
158 A property can also be delete with nwam_<entity>_delete_prop().
160 Implicit validation occurs as part of the nwam_<entity>_set_prop_value()
161 and nwam_<entity>_commit() functions.
509 	NWAM_HANDLE_UNBOUND		Handle not bound to entity
514 	NWAM_ENTITY_IN_USE		Another user is interacting with entity
518 	NWAM_ENTITY_INVALID		Validation of entity failed
520 	NWAM_ENTITY_INVALID_VALUE	Validation of entity value failed
521 	NWAM_ENTITY_NO_VALUE		No value associated with entity   
522 	NWAM_ENTITY_MULTIPLE_VALUES,	Multiple values for entity