OVALSYS
[OVAL]

Interface for System Characteristics model. More...

Data Structures

struct  oval_syschar_model
 OVAL System Characteristics model. More...
struct  oval_sysinfo
 General instrumented host description. More...
struct  oval_sysinfo_iterator
struct  oval_syschar
 Characteristics bound to an Oval_object. More...
struct  oval_syschar_iterator
struct  oval_sysint
 Network interface description. More...
struct  oval_sysint_iterator
struct  oval_sysdata
 Data item aggregator. More...
struct  oval_sysdata_iterator
struct  oval_sysitem
 Data item aggregator. More...
struct  oval_sysitem_iterator
struct  oval_message
 OVAL message. More...
struct  oval_message_iterator
struct  oval_variable_binding
 Binding of an value to an OVAL variable. More...
struct  oval_variable_binding_iterator

Files

file  oval_system_characteristics.h

Enumerations

enum  oval_syschar_collection_flag_t {
  SYSCHAR_FLAG_UNKNOWN = 0, SYSCHAR_FLAG_ERROR = 1, SYSCHAR_FLAG_COMPLETE = 2, SYSCHAR_FLAG_INCOMPLETE = 3,
  SYSCHAR_FLAG_DOES_NOT_EXIST = 4, SYSCHAR_FLAG_NOT_COLLECTED = 5, SYSCHAR_FLAG_NOT_APPLICABLE = 6
}
 

System characteristics result flag.


enum  oval_syschar_status_t {
  SYSCHAR_STATUS_UNKNOWN = 0, SYSCHAR_STATUS_ERROR = 1, SYSCHAR_STATUS_EXISTS = 2, SYSCHAR_STATUS_DOES_NOT_EXIST = 3,
  SYSCHAR_STATUS_NOT_COLLECTED = 4
}
 

System characteristics status.


enum  oval_message_level_t {
  OVAL_MESSAGE_LEVEL_NONE = 0, OVAL_MESSAGE_LEVEL_DEBUG = 1, OVAL_MESSAGE_LEVEL_INFO = 2, OVAL_MESSAGE_LEVEL_WARNING = 3,
  OVAL_MESSAGE_LEVEL_ERROR = 4, OVAL_MESSAGE_LEVEL_FATAL = 5
}
 

Message level.


Functions

const char * oval_syschar_collection_flag_get_text (oval_syschar_collection_flag_t flag)
const char * oval_syschar_status_get_text (oval_syschar_status_t status)
const char * oval_message_level_text (oval_message_level_t)
struct oval_syschar_modeloval_syschar_model::oval_syschar_model_new (struct oval_definition_model *definition_model)
 Create new oval_syschar_model.
int oval_syschar_model::oval_syschar_model_import (struct oval_syschar_model *model, const char *file)
 Import the content from the file into an oval_syschar_model.
struct oval_syschar_modeloval_syschar_model::oval_syschar_model_clone (struct oval_syschar_model *)
 Copy an oval_syschar_model.
int oval_syschar_model::oval_syschar_model_export (struct oval_syschar_model *, const char *file)
 Export system characteristics into file.
void oval_syschar_model::oval_syschar_model_free (struct oval_syschar_model *model)
 Free memory allocated to a specified syschar model.
struct oval_sysinfooval_sysinfo::oval_sysinfo_new (struct oval_syschar_model *)
struct oval_sysinfooval_sysinfo::oval_sysinfo_clone (struct oval_syschar_model *new_model, struct oval_sysinfo *old_sysinfo)
void oval_sysinfo::oval_sysinfo_free (struct oval_sysinfo *)
struct oval_syscharoval_syschar::oval_syschar_new (struct oval_syschar_model *, struct oval_object *)
struct oval_syscharoval_syschar::oval_syschar_clone (struct oval_syschar_model *new_model, struct oval_syschar *old_syschar)
void oval_syschar::oval_syschar_free (struct oval_syschar *)
struct oval_sysintoval_sysint::oval_sysint_new (struct oval_syschar_model *)
struct oval_sysintoval_sysint::oval_sysint_clone (struct oval_syschar_model *new_model, struct oval_sysint *old_sysint)
void oval_sysint::oval_sysint_free (struct oval_sysint *)
struct oval_sysdataoval_sysdata::oval_sysdata_new (struct oval_syschar_model *, const char *id)
struct oval_sysdataoval_sysdata::oval_sysdata_clone (struct oval_syschar_model *new_model, struct oval_sysdata *old_data)
void oval_sysdata::oval_sysdata_free (struct oval_sysdata *)
struct oval_sysitemoval_sysitem::oval_sysitem_new (struct oval_syschar_model *)
struct oval_sysitemoval_sysitem::oval_sysitem_clone (struct oval_syschar_model *new_model, struct oval_sysitem *old_item)
void oval_sysitem::oval_sysitem_free (struct oval_sysitem *)
struct oval_messageoval_message::oval_message_new (void)
struct oval_messageoval_message::oval_message_clone (struct oval_message *old_message)
void oval_message::oval_message_free (struct oval_message *)

Getters



oval_syschar_collection_flag_t oval_variable_get_collection_flag (struct oval_variable *)
struct oval_definition_modeloval_syschar_model::oval_syschar_model_get_definition_model (struct oval_syschar_model *model)
 Return related oval_definition_model from an oval_syschar_model.
struct oval_syschar_iteratoroval_syschar_model::oval_syschar_model_get_syschars (struct oval_syschar_model *model)
 Return an iterator over the oval_sychar objects persisted by this model.
struct oval_sysinfooval_syschar_model::oval_syschar_model_get_sysinfo (struct oval_syschar_model *model)
 Return default sysinfo bound to syschar model.
struct oval_syscharoval_syschar_model::oval_syschar_model_get_syschar (struct oval_syschar_model *model, const char *object_id)
 Return the oval_syschar bound to a specified object_id.
int oval_syschar_model::oval_syschar_model_compute_variable (struct oval_syschar_model *, struct oval_variable *)
 Get the oval_values bound to a specified variable.
struct oval_sysdataoval_syschar_model::oval_syschar_model_get_sysdata (struct oval_syschar_model *, const char *)
bool oval_syschar_model::oval_syschar_model_is_locked (struct oval_syschar_model *syschar_model)
 Return true if the syschar_model instance is locked.
char * oval_sysinfo::oval_sysinfo_get_os_name (struct oval_sysinfo *)
 Get operating system name.
char * oval_sysinfo::oval_sysinfo_get_os_version (struct oval_sysinfo *)
 Get operating system version.
char * oval_sysinfo::oval_sysinfo_get_os_architecture (struct oval_sysinfo *)
 Get operating system architecture.
char * oval_sysinfo::oval_sysinfo_get_primary_host_name (struct oval_sysinfo *)
 Get primary host name of the tested machine.
struct oval_sysint_iteratoroval_sysinfo::oval_sysinfo_get_interfaces (struct oval_sysinfo *)
 Get an iterator to the list of network interfaces.
bool oval_sysinfo::oval_sysinfo_is_locked (struct oval_sysinfo *sysinfo)
 Return true if the sysinfo instance is locked.
oval_syschar_collection_flag_t oval_syschar::oval_syschar_get_flag (struct oval_syschar *)
 Get system characteristic flag.
struct oval_message_iteratoroval_syschar::oval_syschar_get_messages (struct oval_syschar *)
 Get messages bound to this system characteristic.
struct oval_objectoval_syschar::oval_syschar_get_object (struct oval_syschar *)
 Get object associated with this system characteristic.
struct
oval_variable_binding_iterator
oval_syschar::oval_syschar_get_variable_bindings (struct oval_syschar *)
 Get system characteristic variable bindings.
struct oval_sysdata_iteratoroval_syschar::oval_syschar_get_sysdata (struct oval_syschar *)
 Get system characteristic data.
bool oval_syschar::oval_syschar_is_locked (struct oval_syschar *syschar)
 Return true if the syschar instance is locked.
char * oval_sysint::oval_sysint_get_name (struct oval_sysint *)
 Get interface name.
char * oval_sysint::oval_sysint_get_ip_address (struct oval_sysint *)
 Get interface IP address.
char * oval_sysint::oval_sysint_get_mac_address (struct oval_sysint *)
 Get interface MAC address.
bool oval_sysint::oval_sysint_is_locked (struct oval_sysint *sysint)
 Return true if the sysint instance is locked.
char * oval_sysdata::oval_sysdata_get_id (struct oval_sysdata *)
 Get system data ID.
oval_syschar_status_t oval_sysdata::oval_sysdata_get_status (struct oval_sysdata *)
 Get system data status.
struct oval_sysitem_iteratoroval_sysdata::oval_sysdata_get_items (struct oval_sysdata *)
 Get system data individual items.
char * oval_sysdata::oval_sysdata_get_message (struct oval_sysdata *)
 Get system data message.
oval_message_level_t oval_sysdata::oval_sysdata_get_message_level (struct oval_sysdata *)
 Get system data message level.
oval_subtype_t oval_sysdata::oval_sysdata_get_subtype (struct oval_sysdata *)
 Get system data subtype.
bool oval_sysdata::oval_sysdata_is_locked (struct oval_sysdata *sysdata)
 Return true if the sysdata instance is locked.
char * oval_sysitem::oval_sysitem_get_name (struct oval_sysitem *)
 Get system data item name.
char * oval_sysitem::oval_sysitem_get_value (struct oval_sysitem *)
 Get system data item value.
oval_syschar_status_t oval_sysitem::oval_sysitem_get_status (struct oval_sysitem *)
 Get system data item status.
oval_datatype_t oval_sysitem::oval_sysitem_get_datatype (struct oval_sysitem *)
 Get system data item data type.
int oval_sysitem::oval_sysitem_get_mask (struct oval_sysitem *)
 Get system data item mask.
bool oval_sysitem::oval_sysitem_is_locked (struct oval_sysitem *sysitem)
 Return true if the sysitem instance is locked.
char * oval_message::oval_message_get_text (struct oval_message *message)
 Get OVAL message text.
oval_message_level_t oval_message::oval_message_get_level (struct oval_message *message)
 Get OVAL message level.
bool oval_message::oval_message_is_locked (struct oval_message *message)
 return true if the message instance is locked.
struct oval_variableoval_variable_binding::oval_variable_binding_get_variable (struct oval_variable_binding *)
 Get variable for this binding.
char * oval_variable_binding::oval_variable_binding_get_value (struct oval_variable_binding *)
 Get value of this binding.

Setters



void oval_syschar_model::oval_syschar_model_bind_variable_model (struct oval_syschar_model *, struct oval_variable_model *)
 Bind a variable model to the definitions bound to the syschar model.
void oval_syschar_model::oval_syschar_model_add_syschar (struct oval_syschar_model *model, struct oval_syschar *syschar)
void oval_syschar_model::oval_syschar_model_add_sysdata (struct oval_syschar_model *model, struct oval_sysdata *sysdata)
void oval_syschar_model::oval_syschar_model_set_sysinfo (struct oval_syschar_model *model, struct oval_sysinfo *sysinfo)
void oval_syschar_model::oval_syschar_model_add_variable_binding (struct oval_syschar_model *model, struct oval_variable_binding *binding)
void oval_syschar_model::oval_syschar_model_lock (struct oval_syschar_model *syschar_model)
 Lock the syschar_model instance.
void oval_sysinfo::oval_sysinfo_set_os_name (struct oval_sysinfo *, char *)
void oval_sysinfo::oval_sysinfo_set_os_version (struct oval_sysinfo *, char *)
void oval_sysinfo::oval_sysinfo_set_os_architecture (struct oval_sysinfo *, char *)
void oval_sysinfo::oval_sysinfo_set_primary_host_name (struct oval_sysinfo *, char *)
void oval_sysinfo::oval_sysinfo_add_interface (struct oval_sysinfo *, struct oval_sysint *)
void oval_syschar::oval_syschar_add_variable_binding (struct oval_syschar *, struct oval_variable_binding *)
void oval_syschar::oval_syschar_set_flag (struct oval_syschar *model, oval_syschar_collection_flag_t flag)
void oval_syschar::oval_syschar_set_object (struct oval_syschar *, struct oval_object *)
void oval_syschar::oval_syschar_add_sysdata (struct oval_syschar *, struct oval_sysdata *)
void oval_syschar::oval_syschar_add_message (struct oval_syschar *syschar, struct oval_message *message)
void oval_sysint::oval_sysint_set_name (struct oval_sysint *, char *)
void oval_sysint::oval_sysint_set_ip_address (struct oval_sysint *, char *)
void oval_sysint::oval_sysint_set_mac_address (struct oval_sysint *, char *)
void oval_sysdata::oval_sysdata_set_status (struct oval_sysdata *, oval_syschar_status_t)
void oval_sysdata::oval_sysdata_set_subtype (struct oval_sysdata *sysdata, oval_subtype_t subtype)
void oval_sysdata::oval_sysdata_set_message (struct oval_sysdata *data, char *message)
void oval_sysdata::oval_sysdata_set_message_level (struct oval_sysdata *data, oval_message_level_t level)
void oval_sysdata::oval_sysdata_add_item (struct oval_sysdata *, struct oval_sysitem *)
void oval_sysitem::oval_sysitem_set_name (struct oval_sysitem *sysitem, char *name)
void oval_sysitem::oval_sysitem_set_value (struct oval_sysitem *sysitem, char *value)
void oval_sysitem::oval_sysitem_set_status (struct oval_sysitem *sysitem, oval_syschar_status_t status)
void oval_sysitem::oval_sysitem_set_datatype (struct oval_sysitem *sysitem, oval_datatype_t type)
void oval_sysitem::oval_sysitem_set_mask (struct oval_sysitem *sysitem, int mask)
void oval_message::oval_message_set_text (struct oval_message *, char *)
void oval_message::oval_message_set_level (struct oval_message *, oval_message_level_t)
void oval_variable_binding::oval_variable_binding_set_variable (struct oval_variable_binding *, struct oval_variable *)
void oval_variable_binding::oval_variable_binding_set_value (struct oval_variable_binding *, char *)

Evaluators



bool oval_syschar_model::oval_syschar_model_is_valid (struct oval_syschar_model *syschar_model)
 Return true if the syschar_model instance is valid An oval_syschar_model is valid if all the following are true

  • The sysinfo attribute is valid
  • The associated oval_definition_model is valid
  • All included syschars are valid
  • All included variable_bindings are valid.

bool oval_sysinfo::oval_sysinfo_is_valid (struct oval_sysinfo *sysinfo)
 Return true if the sysinfo instance is valid.
bool oval_syschar::oval_syschar_is_valid (struct oval_syschar *syschar)
 Return true if the syschar instance is valid An oval_syschar is valid if all the following are true

  • The object attribute is valid
  • All included variable_bindings are valid
  • All included sysdata are valid.

bool oval_sysint::oval_sysint_is_valid (struct oval_sysint *sysint)
 Return true if the sysint instance is valid.
bool oval_sysdata::oval_sysdata_is_valid (struct oval_sysdata *sysdata)
 Return true if the sysdata instance is valid An oval_sysdata is valid if all the following are true

  • All included sysitems are valid.

bool oval_sysitem::oval_sysitem_is_valid (struct oval_sysitem *sysitem)
 Return true if the sysitem instance is valid.
bool oval_message::oval_message_is_valid (struct oval_message *message)
 Return true if the message instance is valid.
struct oval_variable_bindingoval_variable_binding::oval_variable_binding_new (struct oval_variable *, char *)
struct oval_variable_bindingoval_variable_binding::oval_variable_binding_clone (struct oval_variable_binding *, struct oval_definition_model *)
void oval_variable_binding::oval_variable_binding_free (struct oval_variable_binding *)

Iterators



bool oval_sysinfo_iterator::oval_sysinfo_iterator_has_more (struct oval_sysinfo_iterator *)
struct oval_sysinfooval_sysinfo_iterator::oval_sysinfo_iterator_next (struct oval_sysinfo_iterator *)
void oval_sysinfo_iterator::oval_sysinfo_iterator_free (struct oval_sysinfo_iterator *)
bool oval_syschar_iterator::oval_syschar_iterator_has_more (struct oval_syschar_iterator *)
struct oval_syscharoval_syschar_iterator::oval_syschar_iterator_next (struct oval_syschar_iterator *)
void oval_syschar_iterator::oval_syschar_iterator_free (struct oval_syschar_iterator *)
bool oval_sysint_iterator::oval_sysint_iterator_has_more (struct oval_sysint_iterator *)
struct oval_sysintoval_sysint_iterator::oval_sysint_iterator_next (struct oval_sysint_iterator *)
void oval_sysint_iterator::oval_sysint_iterator_free (struct oval_sysint_iterator *)
bool oval_sysdata_iterator::oval_sysdata_iterator_has_more (struct oval_sysdata_iterator *)
struct oval_sysdataoval_sysdata_iterator::oval_sysdata_iterator_next (struct oval_sysdata_iterator *)
void oval_sysdata_iterator::oval_sysdata_iterator_free (struct oval_sysdata_iterator *)
bool oval_sysitem_iterator::oval_sysitem_iterator_has_more (struct oval_sysitem_iterator *)
struct oval_sysitemoval_sysitem_iterator::oval_sysitem_iterator_next (struct oval_sysitem_iterator *)
void oval_sysitem_iterator::oval_sysitem_iterator_free (struct oval_sysitem_iterator *)
bool oval_message_iterator::oval_message_iterator_has_more (struct oval_message_iterator *oc_message)
struct oval_messageoval_message_iterator::oval_message_iterator_next (struct oval_message_iterator *oc_message)
void oval_message_iterator::oval_message_iterator_free (struct oval_message_iterator *oc_message)
bool oval_variable_binding_iterator::oval_variable_binding_iterator_has_more (struct oval_variable_binding_iterator *)
struct oval_variable_bindingoval_variable_binding_iterator::oval_variable_binding_iterator_next (struct oval_variable_binding_iterator *)
void oval_variable_binding_iterator::oval_variable_binding_iterator_free (struct oval_variable_binding_iterator *)

Detailed Description

Interface for System Characteristics model.

Class diagram

system_characteristic.png

Function Documentation

struct oval_message * oval_message_clone ( struct oval_message old_message  )  [read, inherited]
Returns:
A copy of the specified oval_message.
bool oval_message_is_locked ( struct oval_message message  )  [inherited]

return true if the message instance is locked.

The state of a locked instance cannot be changed.

struct oval_syschar * oval_syschar_clone ( struct oval_syschar_model new_model,
struct oval_syschar old_syschar 
) [read, inherited]
Returns:
A copy of the specified oval_syschar.
bool oval_syschar_is_locked ( struct oval_syschar syschar  )  [inherited]

Return true if the syschar instance is locked.

The state of a locked instance cannot be changed.

struct oval_syschar_model * oval_syschar_model_clone ( struct oval_syschar_model  )  [read, inherited]

Copy an oval_syschar_model.

Returns:
A copy of the specified oval_syschar_model.
void oval_syschar_model_free ( struct oval_syschar_model model  )  [inherited]

Free memory allocated to a specified syschar model.

Parameters:
model the specified syschar model
struct oval_definition_model * oval_syschar_model_get_definition_model ( struct oval_syschar_model model  )  [read, inherited]

Return related oval_definition_model from an oval_syschar_model.

Parameters:
model the specified oval_syschar_model.
struct oval_syschar * oval_syschar_model_get_syschar ( struct oval_syschar_model model,
const char *  object_id 
) [read, inherited]

Return the oval_syschar bound to a specified object_id.

Returns NULL if the object_id does not resolve to an oval_object in the bound oval_definition_model.

Parameters:
model the queried oval_syschar_model.
object_id the specified object_id.
struct oval_syschar_iterator * oval_syschar_model_get_syschars ( struct oval_syschar_model model  )  [read, inherited]

Return an iterator over the oval_sychar objects persisted by this model.

Parameters:
model the specified oval_syschar_model.
struct oval_sysinfo * oval_syschar_model_get_sysinfo ( struct oval_syschar_model model  )  [read, inherited]

Return default sysinfo bound to syschar model.

Parameters:
model the specified oval_syschar_model.
int oval_syschar_model_import ( struct oval_syschar_model model,
const char *  file 
) [inherited]

Import the content from the file into an oval_syschar_model.

If imported content specifies a model entity that is already registered within the model its content is overwritten.

Parameters:
model the merge target model
file filename
Returns:
-1 if an error occurred
bool oval_syschar_model_is_locked ( struct oval_syschar_model syschar_model  )  [inherited]

Return true if the syschar_model instance is locked.

The state of a locked instance cannot be changed.

void oval_syschar_model_lock ( struct oval_syschar_model syschar_model  )  [inherited]

Lock the syschar_model instance.

The state of a locked instance cannot be changed. This operation has no effect if the model is already locked.

struct oval_syschar_model * oval_syschar_model_new ( struct oval_definition_model definition_model  )  [read, inherited]

Create new oval_syschar_model.

The new model is bound to a specified oval_definition_model and variable bindings.

Parameters:
definition_model the specified oval_definition_model.
struct oval_sysdata * oval_sysdata_clone ( struct oval_syschar_model new_model,
struct oval_sysdata old_data 
) [read, inherited]
Returns:
A copy of the specified oval_sysdata.
bool oval_sysdata_is_locked ( struct oval_sysdata sysdata  )  [inherited]

Return true if the sysdata instance is locked.

The state of a locked instance cannot be changed.

struct oval_sysinfo * oval_sysinfo_clone ( struct oval_syschar_model new_model,
struct oval_sysinfo old_sysinfo 
) [read, inherited]
Returns:
A copy of the specified oval_sysinfo.
bool oval_sysinfo_is_locked ( struct oval_sysinfo sysinfo  )  [inherited]

Return true if the sysinfo instance is locked.

The state of a locked instance cannot be changed.

struct oval_sysint * oval_sysint_clone ( struct oval_syschar_model new_model,
struct oval_sysint old_sysint 
) [read, inherited]
Returns:
A copy of the specified oval_sysint.
bool oval_sysint_is_locked ( struct oval_sysint sysint  )  [inherited]

Return true if the sysint instance is locked.

The state of a locked instance cannot be changed.

struct oval_sysitem * oval_sysitem_clone ( struct oval_syschar_model new_model,
struct oval_sysitem old_item 
) [read, inherited]
Returns:
A copy of the specified oval_sysitem.
bool oval_sysitem_is_locked ( struct oval_sysitem sysitem  )  [inherited]

Return true if the sysitem instance is locked.

The state of a locked instance cannot be changed.

struct oval_variable_binding * oval_variable_binding_clone ( struct oval_variable_binding ,
struct oval_definition_model  
) [read, inherited]
Returns:
A copy of the specified oval_variable_binding.

Generated on 14 Jul 2010 for Open SCAP Library by  doxygen 1.6.1