Oval_state
[OVAL Definitions interface]

An Oval_state instance is a collection of one or more characteristics pertaining to a specific object type. More...

Data Structures
struct	oval_state
	Handle: Oval_state. More...
struct	oval_state_iterator
	Handle: Oval_state iterator. More...
Modules
	Setters
	Oval_state set methods.
	Getters
	Oval_state get methods.
	Iterators
	Oval_state iterator methods.
	Evaluators
	Oval_state evaluator methods
Functions
struct oval_state *	oval_state_new (struct oval_definition_model *, char *id)
	Construct new intance of Oval_state.
void	oval_state_free (struct oval_state *)
	Free instance of Oval_state.

---

Detailed Description

An Oval_state instance is a collection of one or more characteristics pertaining to a specific object type.

The Oval_state is used by an during the evaluation of an Oval_test to determine if a set of items queried by an Oval_object on a instrumented host meet certain characteristics.

---

Function Documentation

struct oval_state* oval_state_new	(	struct oval_definition_model *	,
		char *	id
	)			[read]

Construct new intance of Oval_state.

Attribute values shall be initialized:

• family -- initialized to OVAL_FAMILY_UNKNOWN
• subtype -- initialized to OVAL_SUBTYPE_UNKNOWN
• notes -- initialized to empty iterator
• comment -- initialized to NULL
• id -- initialized to a copy of the id parameter
• deprecated -- initialized to false
• version -- initialized to zero
• contents -- initialized to empty iterator

Note:

This method shall not construct a new instance of Oval_state and shall return NULL if the text of the id parameter is not matched by the regular expression ^oval:[\.A-Za-z0-9_\-]+:stt:[1-9][0-9]*$.

Parameters:

id

- (Not NULL) the text of the required state id.