Oval_variable
[OVAL Definitions interface]

An oval variable resolves an Oval_value stream which specifies constraints for Oval_objects and Oval_states. More...

Data Structures
struct	oval_variable
	Handle: Oval_variable. More...
struct	oval_variable_iterator
	Handle: Oval_variable iterator. More...
Modules
	Setters
	Oval_variable set methods.
	Getters
	Oval_variable get methods.
	Iterators
	Oval_variable iterator methods.
	Evaluators
	Oval_variable evaluator methods
Functions
struct oval_variable *	oval_variable_new (struct oval_definition_model *model, char *id, oval_variable_type_t type)
	Construct new instance of Oval_variable.
void	oval_variable_free (struct oval_variable *)
	Free instance of Oval_variable.

---

Detailed Description

An oval variable resolves an Oval_value stream which specifies constraints for Oval_objects and Oval_states.

• if oval_variable_type == OVAL_VARIABLE_EXTERNAL
  • The value stream is determined by oval_definition_model_bind_variable_model
• if oval_variable_type == OVAL_VARIABLE_CONSTANT
  • The value stream is determined by a set of specified constants (see oval_variable_add_value)
• if oval_variable_type == OVAL_VARIABLE_LOCAL
  • The value stream is specified by either a single component or a complex function, meaning that a value can be as simple as a literal string or as complex as multiple registry keys concatenated together. Note that if an individual component is used and it returns multiple values, then there will be multiple values associated with the Oval_local. For example, if an object is specified as the local source and it references a file object that identifies a set of 5 files, then the local variable would represent these 5 values.

---

Function Documentation

struct oval_variable* oval_variable_new	(	struct oval_definition_model *	model,
		char *	id,
		oval_variable_type_t	type
	)			[read]

Construct new instance of Oval_variable.

Attribute values shall be initialized:

• id -- initialized to a copy of the id parameter
• type -- initialized to the type parameter
• version -- initialized to zero
• deprecated -- initialized to false
• comment -- initialized to NULL
• datatype -- initialzed to OVAL_DATATYPE_UNKNOWN
• If type == OVAL_VARIABLE_CONSTANT
  • values -- initialized to empty iterator
• If type == OVAL_VARIABLE_EXTERNAL
  • values -- initialized to NULL
• If type == OVAL_VARIABLE_LOCAL
  • component -- initialized to NULL

This method shall not construct a new instance of Oval_variable and shall return NULL

• if the text of the id parameter is not matched by the regular expression ^oval:[\.A-Za-z0-9_\-]+:var:[1-9][0-9]*$.
• if the value of the type parameter is OVAL_VARIABLE_UNKNOWN.

Parameters:

	id	- (Not NULL) the text of the required variable id.
	type	- (Not OVAL_VARIABLE_UNKNOWN) the required type.