Loading...
Searching...
No Matches
item.h
/*
* Copyright 2009--2013 Red Hat Inc., Durham, North Carolina.
* All Rights Reserved.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
* Authors:
* Lukas Kuklinek <lkuklinek@redhat.com>
*/
#ifndef XCCDF_ITEM_
#define XCCDF_ITEM_
#include <assert.h>
#include "public/xccdf_benchmark.h"
#include "elements.h"
#include "common/reference_priv.h"
#include "common/list.h"
#include "common/util.h"
#include "common/text_priv.h"
struct xccdf_flags {
bool selected:1;
bool hidden:1;
bool resolved:1;
bool abstract:1;
bool prohibit_changes:1;
bool interactive:1;
bool multiple:1;
};
struct xccdf_defflags {
bool selected:1;
bool hidden:1;
bool resolved:1;
bool abstract:1;
bool prohibit_changes:1;
bool interactive:1;
bool multiple:1;
bool weight:1;
bool role:1;
bool severity:1;
};
struct xccdf_item;
struct xccdf_check;
struct xccdf_item_base {
char *id;
char *cluster_id;
float weight;
struct oscap_list *title;
struct oscap_list *description;
struct oscap_list *question;
struct oscap_list *rationale;
struct oscap_list *warnings;
char *version;
char *version_update;
char *version_time;
struct xccdf_item *parent;
char *extends;
struct oscap_list *statuses;
struct oscap_list *dc_statuses;
struct oscap_list *references;
struct oscap_list *platforms;
struct xccdf_flags flags;
struct xccdf_defflags defined_flags;
struct oscap_list *metadata;
};
struct xccdf_rule_item {
char *impact_metric;
xccdf_role_t role;
xccdf_level_t severity;
struct oscap_list *requires_;
struct oscap_list *conflicts;
struct oscap_list *profile_notes;
struct oscap_list *idents;
struct oscap_list *checks;
struct oscap_list *fixes;
struct oscap_list *fixtexts;
};
struct xccdf_group_item {
struct oscap_list *requires_;
struct oscap_list *conflicts;
struct oscap_list *values;
struct oscap_list *content;
};
/* This structure is used for multiple-count attributes for Item (0-n) */
struct xccdf_value_instance {
char *selector;
xccdf_value_type_t type; /* Value::type */
char *value; /* Value::value */
char *defval; /* Value::default */
struct oscap_list *choices; /* Value::choices */
xccdf_numeric lower_bound;
xccdf_numeric upper_bound;
char *match;
struct {
bool value_given : 1;
bool defval_given : 1;
bool must_match_given : 1;
bool must_match : 1;
} flags;
};
struct xccdf_value_item {
xccdf_value_type_t type; /* Value::type */
xccdf_interface_hint_t interface_hint; /* Value::interfaceHint */
xccdf_operator_t oper; /* Value::operator */
struct oscap_list *instances;
struct oscap_list *sources; /* Value::source */
};
struct xccdf_result_item {
const struct xccdf_version_info *schema_version;
char *start_time;
char *end_time;
char *test_system;
char *benchmark_uri;
char *profile;
struct oscap_list *identities;
struct oscap_list *targets;
struct oscap_list *organizations;
struct oscap_list *remarks;
struct oscap_list *target_addresses;
struct oscap_list *target_facts;
struct oscap_list *target_id_refs;
struct oscap_list *applicable_platforms;
struct oscap_list *setvalues;
struct oscap_list *rule_results;
struct oscap_list *scores;
};
struct xccdf_profile_item {
char *note_tag;
struct oscap_list *selects;
struct oscap_list *setvalues;
struct oscap_list *refine_values;
struct oscap_list *refine_rules;
bool tailoring;
};
struct xccdf_tailoring {
// optional, only relevant when Tailoring is saved as a root element
char *id;
// The ref is "just informative" according to the spec, we never
// interpret it and just load and save it as a string.
char *benchmark_ref;
// Also just informative
char *benchmark_ref_version;
struct oscap_list *statuses;
struct oscap_list *dc_statuses;
char *version;
char *version_update;
char *version_time;
struct oscap_list *metadata;
struct oscap_list *profiles;
};
struct xccdf_benchmark_item {
const struct xccdf_version_info *schema_version;
struct oscap_htable *items_dict; /* Stores only xccdf:Item */
struct oscap_htable *profiles_dict; /* xccdf:Profile */
struct oscap_htable *results_dict; /* xccdf:TestResult */
struct oscap_htable *clusters_dict; /* xccdf:items by cluster-id */
struct oscap_list *notices;
struct oscap_list *plain_texts;
struct cpe_dict_model *cpe_list;
struct cpe_lang_model *cpe_lang_model;
char *style;
char *style_href;
char *lang;
struct oscap_list *front_matter;
struct oscap_list *rear_matter;
struct oscap_list *models;
struct oscap_list *profiles;
struct oscap_list *values;
struct oscap_list *content;
struct oscap_list *results;
};
struct xccdf_item {
xccdf_type_t type;
struct xccdf_item_base item;
union {
struct xccdf_profile_item profile;
struct xccdf_benchmark_item benchmark;
struct xccdf_rule_item rule;
struct xccdf_group_item group;
struct xccdf_value_item value;
struct xccdf_result_item result;
} sub;
};
struct xccdf_warning {
struct oscap_text *text;
xccdf_warning_category_t category;
};
struct xccdf_notice {
char *id;
struct oscap_text *text;
};
struct xccdf_status {
xccdf_status_type_t status;
time_t date;
};
struct xccdf_model {
char *system;
struct oscap_htable *params; // TODO: to list + accessors
};
struct xccdf_select {
char *item;
bool selected;
struct oscap_list *remarks;
};
struct xccdf_refine_rule {
char *item;
char *selector;
xccdf_role_t role;
xccdf_level_t severity;
xccdf_numeric weight;
struct oscap_list *remarks;
};
struct xccdf_refine_value {
char *item;
char *selector;
xccdf_operator_t oper;
struct oscap_list *remarks;
};
struct xccdf_setvalue {
char *item;
char *value;
};
struct xccdf_ident {
char *id;
char *system;
};
struct xccdf_check {
xccdf_bool_operator_t oper;
struct oscap_list *children;
char *id;
char *system;
char *selector;
char *content;
struct _xccdf_check_flags {
bool multicheck:1;
bool def_multicheck:1;
bool negate:1;
bool def_negate:1;
} flags;
struct oscap_list *imports;
struct oscap_list *exports;
struct oscap_list *content_refs;
};
struct xccdf_check_content_ref {
char *href;
char *name;
};
struct xccdf_check_import {
char *name;
char *xpath;
char *content;
};
struct xccdf_check_export {
char *name;
char *value;
};
struct xccdf_profile_note {
struct oscap_text *text;
char *reftag;
};
struct xccdf_fix {
bool reboot;
xccdf_strategy_t strategy;
xccdf_level_t disruption;
xccdf_level_t complexity;
char *id;
char *content;
char *system;
char *platform;
};
struct xccdf_fixtext {
struct oscap_text *text;
bool reboot;
xccdf_strategy_t strategy;
xccdf_level_t disruption;
xccdf_level_t complexity;
char *fixref;
};
struct xccdf_rule_result {
char *idref;
xccdf_role_t role;
char *time;
float weight;
xccdf_level_t severity;
xccdf_test_result_type_t result;
char *version;
struct oscap_list *overrides;
struct oscap_list *idents;
struct oscap_list *messages;
struct oscap_list *instances;
struct oscap_list *fixes;
struct oscap_list *checks;
};
struct xccdf_identity {
struct {
bool authenticated : 1;
bool privileged : 1;
} sub;
char *name;
};
struct xccdf_score {
xccdf_numeric maximum;
xccdf_numeric score;
char *system;
};
struct xccdf_override {
char *time;
char *authority;
xccdf_test_result_type_t old_result;
xccdf_test_result_type_t new_result;
struct oscap_text *remark;
};
struct xccdf_message {
xccdf_message_severity_t severity;
char *content;
};
struct xccdf_target_fact {
xccdf_value_type_t type;
char *name;
char *value;
};
struct xccdf_target_identifier {
bool any_element; // if false, this represents <target-id-ref>, else it's any element
xmlNodePtr element;
char *system;
char *href;
char *name;
};
struct xccdf_instance {
char *context;
char *parent_context;
char *content;
};
struct xccdf_plain_text {
char *id;
char *text;
};
extern const struct oscap_string_map XCCDF_LEVEL_MAP[];
extern const struct oscap_string_map XCCDF_ROLE_MAP[];
extern const struct oscap_string_map XCCDF_OPERATOR_MAP[];
extern const struct oscap_string_map XCCDF_BOOLOP_MAP[];
extern const struct oscap_string_map XCCDF_STRATEGY_MAP[];
extern const struct oscap_string_map XCCDF_FACT_TYPE_MAP[];
extern const struct oscap_string_map XCCDF_RESULT_MAP[];
extern const struct oscap_text_traits XCCDF_TEXT_PLAIN;
extern const struct oscap_text_traits XCCDF_TEXT_HTML;
extern const struct oscap_text_traits XCCDF_TEXT_PLAINSUB;
extern const struct oscap_text_traits XCCDF_TEXT_HTMLSUB;
extern const struct oscap_text_traits XCCDF_TEXT_NOTICE;
extern const struct oscap_text_traits XCCDF_TEXT_PROFNOTE;
extern const size_t XCCDF_NUMERIC_SIZE;
extern const char *XCCDF_NUMERIC_FORMAT;
struct xccdf_item *xccdf_item_new(xccdf_type_t type, struct xccdf_item *parent);
void xccdf_item_release(struct xccdf_item *item);
void xccdf_item_print(struct xccdf_item *item, int depth);
void xccdf_item_dump(struct xccdf_item *item, int depth);
struct xccdf_item* xccdf_item_get_benchmark_internal(struct xccdf_item* item);
bool xccdf_benchmark_parse(struct xccdf_item *benchmark, xmlTextReaderPtr reader);
void xccdf_benchmark_dump(struct xccdf_benchmark *benchmark);
int xccdf_benchmark_include_tailored_profiles(struct xccdf_benchmark *benchmark);
struct oscap_htable_iterator *xccdf_benchmark_get_cluster_items(struct xccdf_benchmark *benchmark, const char *cluster_id);
bool xccdf_benchmark_register_item(struct xccdf_benchmark *benchmark, struct xccdf_item *item);
bool xccdf_benchmark_unregister_item(struct xccdf_item *item);
bool xccdf_benchmark_rename_item(struct xccdf_item *item, const char *newid);
char *xccdf_benchmark_gen_id(struct xccdf_benchmark *benchmark, xccdf_type_t type, const char *prefix);
struct xccdf_result *xccdf_benchmark_get_result_by_id(struct xccdf_benchmark *benchmark, const char *testresult_id);
struct xccdf_result *xccdf_benchmark_get_result_by_id_suffix(struct xccdf_benchmark *benchmark, const char *testresult_suffix);
bool xccdf_add_item(struct oscap_list *list, struct xccdf_item *parent, struct xccdf_item *item, const char *prefix);
struct xccdf_tailoring *xccdf_tailoring_parse(xmlTextReaderPtr reader, struct xccdf_item* benchmark);
xmlNodePtr xccdf_tailoring_to_dom(struct xccdf_tailoring *tailoring, xmlDocPtr doc, xmlNodePtr parent, const struct xccdf_version_info *version_info);
struct xccdf_item *xccdf_profile_new_internal(struct xccdf_item *bench);
struct xccdf_item *xccdf_profile_parse(xmlTextReaderPtr reader, struct xccdf_item *bench);
void xccdf_profile_dump(struct xccdf_item *prof, int depth);
bool xccdf_item_process_attributes(struct xccdf_item *item, xmlTextReaderPtr reader);
bool xccdf_item_process_element(struct xccdf_item *item, xmlTextReaderPtr reader);
bool xccdf_content_parse(xmlTextReaderPtr reader, struct xccdf_item *parent);
struct xccdf_item *xccdf_group_parse(xmlTextReaderPtr reader, struct xccdf_item *parent);
struct xccdf_item *xccdf_group_new_internal(struct xccdf_item *parent);
void xccdf_group_dump(struct xccdf_item *group, int depth);
struct xccdf_item *xccdf_rule_new_internal(struct xccdf_item *parent);
struct xccdf_item *xccdf_rule_parse(xmlTextReaderPtr reader, struct xccdf_item *parent);
void xccdf_rule_dump(struct xccdf_item *rule, int depth);
struct xccdf_check_iterator *xccdf_rule_get_checks_filtered(struct xccdf_item *rule, char *selector);
struct xccdf_check_iterator *xccdf_rule_get_complex_checks(struct xccdf_item *rule);
struct xccdf_item *xccdf_value_parse(xmlTextReaderPtr reader, struct xccdf_item *parent);
struct xccdf_item *xccdf_value_new_internal(struct xccdf_item *parent, xccdf_value_type_t type);
void xccdf_value_dump(struct xccdf_item *value, int depth);
struct xccdf_notice *xccdf_notice_new_parse(xmlTextReaderPtr reader);
void xccdf_notice_dump(struct xccdf_notice *notice, int depth);
void xccdf_status_dump(struct xccdf_status *status, int depth);
struct xccdf_model *xccdf_model_new_xml(xmlTextReaderPtr reader);
void xccdf_cstring_dump(const char *data, int depth);
void xccdf_result_dump(struct xccdf_result *res, int depth);
struct xccdf_result *xccdf_result_new_parse(xmlTextReaderPtr reader);
int xccdf_rule_result_set_time_current(struct xccdf_rule_result *item);
int xccdf_result_set_start_time_current(struct xccdf_result *item);
int xccdf_result_set_end_time_current(struct xccdf_result *item);
const struct xccdf_version_info* xccdf_result_get_schema_version(const struct xccdf_result *item);
bool xccdf_result_set_schema_version(struct xccdf_result *item, const struct xccdf_version_info* newval);
struct xccdf_check *xccdf_check_parse(xmlTextReaderPtr reader);
void xccdf_check_dump(struct xccdf_check *check, int depth);
bool xccdf_check_inject_content_ref(struct xccdf_check *check, const struct xccdf_check_content_ref *content, const char *name);
void xccdf_check_content_ref_dump(struct xccdf_check_content_ref *ref, int depth);
struct xccdf_ident *xccdf_ident_parse(xmlTextReaderPtr reader);
void xccdf_ident_dump(struct xccdf_ident *ident, int depth);
struct xccdf_fix *xccdf_fix_parse(xmlTextReaderPtr reader);
struct xccdf_fixtext *xccdf_fixtext_parse(xmlTextReaderPtr reader);
struct xccdf_setvalue *xccdf_setvalue_new_parse(xmlTextReaderPtr reader);
void xccdf_setvalue_dump(struct xccdf_setvalue *sv, int depth);
struct xccdf_warning *xccdf_warning_new_parse(xmlTextReaderPtr reader);
//private methods for cloning items
//Will clone the item member of a xccdf_item object
void xccdf_item_base_clone(struct xccdf_item_base *new_base, const struct xccdf_item_base *old_base);
//clones the specific types of items
void xccdf_profile_item_clone(struct xccdf_profile_item *clone, const struct xccdf_profile_item * item);
struct xccdf_benchmark_item * xccdf_benchmark_item_clone(struct xccdf_item *clone, const struct xccdf_benchmark * bench);
void xccdf_rule_item_clone(struct xccdf_rule_item *clone, const struct xccdf_rule_item * item);
void xccdf_group_item_clone(struct xccdf_item *parent, const struct xccdf_group_item * item);
void xccdf_value_item_clone(struct xccdf_value_item *clone, const struct xccdf_value_item * item);
struct xccdf_value_instance * xccdf_value_instance_clone(const struct xccdf_value_instance * val);
void xccdf_result_item_clone(struct xccdf_result_item *clone, const struct xccdf_result_item * item);
struct xccdf_profile_note * xccdf_profile_note_clone(const struct xccdf_profile_note * note);
void xccdf_reparent_list(struct oscap_list * item_list, struct xccdf_item * parent);
void xccdf_reparent_item(struct xccdf_item * item, struct xccdf_item * parent);
void xccdf_texts_to_dom(struct oscap_text_iterator *texts, xmlNode *parent, const char *elname);
void xccdf_item_add_applicable_platform(struct xccdf_item *item, xmlTextReaderPtr reader);
#include "unused.h"
#endif
xccdf_interface_hint_t
xccdf_interface_hint_t
Interface hint.
Definition xccdf_benchmark.h:74
xccdf_message_severity_t
xccdf_message_severity_t
Severity of an xccdf_message.
Definition xccdf_benchmark.h:128
xccdf_type_t
xccdf_type_t
Type of an XCCDF object.
Definition xccdf_benchmark.h:57
xccdf_level_t
xccdf_level_t
XCCDF error, complexity, disruption, or severity level.
Definition xccdf_benchmark.h:118
xccdf_operator_t
xccdf_operator_t
Operator to be applied on an xccdf_value.
Definition xccdf_benchmark.h:101
xccdf_strategy_t
xccdf_strategy_t
Fix strategy type.
Definition xccdf_benchmark.h:157
xccdf_role_t
xccdf_role_t
XCCDF role.
Definition xccdf_benchmark.h:136
xccdf_warning_category_t
xccdf_warning_category_t
Category of xccdf_warning.
Definition xccdf_benchmark.h:143
xccdf_numeric
float xccdf_numeric
Type of a numerical content for a XCCDF value.
Definition xccdf_benchmark.h:198
xccdf_value_type_t
xccdf_value_type_t
Type of an xccdf_value.
Definition xccdf_benchmark.h:94
xccdf_test_result_type_t
xccdf_test_result_type_t
Test result.
Definition xccdf_benchmark.h:170
xccdf_status_type_t
xccdf_status_type_t
Status of an XCCDF item.
Definition xccdf_benchmark.h:84
xccdf_bool_operator_t
xccdf_bool_operator_t
Boolean operators for logical expressions.
Definition xccdf_benchmark.h:112
cpe_dict_model
Structure representing a CPE dictionary.
Definition cpedict_priv.h:139
oscap_htable_iterator
Definition list.c:572
oscap_htable
Definition list.h:179
oscap_list
Definition list.h:53
oscap_string_map
Define mapping between symbolic constant and its string representation.
Definition util.h:296
oscap_text_iterator
Internationalized string iterator.
oscap_text_traits
oscap_text traits
Definition text_priv.h:38
oscap_text
Representation of internationalizable character strings.
Definition text_priv.h:46
xccdf_benchmark_item
Definition item.h:193
xccdf_benchmark
Top level XCCDF structure containing profiles, rules, values and results.
xccdf_check::_xccdf_check_flags
Definition item.h:292
xccdf_check_content_ref
XCCDF check content reference.
Definition item.h:303
xccdf_check_export
XCCDF check export.
Definition item.h:314
xccdf_check_import
XCCDF check import.
Definition item.h:308
xccdf_check_iterator
Check iterator.
xccdf_check
XCCDF simple or complex check.
Definition item.h:285
xccdf_defflags
Definition item.h:47
xccdf_fix
XCCDF automatic fix.
Definition item.h:324
xccdf_fixtext
XCCDF textual fix instructions.
Definition item.h:335
xccdf_flags
Definition item.h:37
xccdf_group_item
Definition item.h:105
xccdf_ident
XCCDF rule ident URI.
Definition item.h:280
xccdf_identity
XCCDF identity.
Definition item.h:361
xccdf_instance
XCCDF instance.
Definition item.h:404
xccdf_item_base
Definition item.h:63
xccdf_item
A base class for XCCDF items.
Definition item.h:220
xccdf_message
XCCDF message.
Definition item.h:383
xccdf_model
XCCDF scoring model.
Definition item.h:248
xccdf_notice
XCCDF benchmark legal notice.
Definition item.h:238
xccdf_override
XCCDF override.
Definition item.h:375
xccdf_plain_text
XCCDF target fact.
Definition item.h:410
xccdf_profile_item
Definition item.h:162
xccdf_profile_note
XCCDF note for given rule in context of given profile.
Definition item.h:319
xccdf_refine_rule
XCCDF refine rule option used in the profile.
Definition item.h:259
xccdf_refine_value
XCCDF refine value option used in the profile.
Definition item.h:268
xccdf_result_item
Definition item.h:140
xccdf_result
Actual results of running a XCCDF test or profile.
xccdf_rule_item
Definition item.h:90
xccdf_rule_result
XCCDF rule result.
Definition item.h:344
xccdf_score
XCCDF score.
Definition item.h:369
xccdf_select
XCCDF select option usen in the profile.
Definition item.h:253
xccdf_setvalue
XCCDF set value option used in the profile.
Definition item.h:275
xccdf_status
XCCDF item status.
Definition item.h:243
xccdf_tailoring
Stores content from xccdf:Tailoring element which can be loaded from a separate file.
Definition item.h:171
xccdf_target_fact
XCCDF target fact.
Definition item.h:388
xccdf_target_identifier
Can be either <target-id-ref> or some other element.
Definition item.h:394
xccdf_value_instance
Definition item.h:114
xccdf_value_item
Definition item.h:131
xccdf_version_info
Definition XCCDF/elements.c:42
xccdf_warning
XCCDF warning.
Definition item.h:233
xccdf_benchmark.h
Open-scap XCCDF library interface.