Oval_object
[OVAL Definitions interface]

An Oval_object instance describes a set of items to look for on an instrumented host platform. More...

Data Structures
struct	oval_object
	Handle: Oval_object. More...
struct	oval_object_iterator
	Handle: Oval_object iterator. More...
Modules
	Setters
	Oval_object set methods.
	Getters
	Oval_object get methods.
	Iterators
	Oval_object iterator methods.
	Evaluators
	Oval_object evaluator methods
Functions
struct oval_object *	oval_object_new (struct oval_definition_model *, char *id)
	Construct new intance of Oval_object.
void	oval_object_free (struct oval_object *)
	Free instance of Oval_object.

---

Detailed Description

An Oval_object instance describes a set of items to look for on an instrumented host platform.

A simple object will usually result in a single file, process, etc being identified. But through the use pattern matches, sets, and variables, multiple matching objects can be identified. Therefore an OVAL Object can identify a set of many individual items on a system. This set of items defined by the OVAL Object can then be used by an OVAL Test and compared against an OVAL State.

---

Function Documentation

struct oval_object* oval_object_new	(	struct oval_definition_model *	,
		char *	id
	)			[read]

Construct new intance of Oval_object.

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
• behaviors -- initialized to empty iterator

Note:

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

Parameters:

id

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