cpe_dict.h

Go to the documentation of this file.

 
/*
 * Copyright 2009--2014 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:
 *      Maros Barabas <mbarabas@redhat.com>
 *      Lukas Kuklinek <lkuklinek@redhat.com>
 *      Šimon Lukašík
 */
 
#ifndef CPEDICT_H_
#define CPEDICT_H_
 
#include "oscap.h"
#include "cpe_name.h"
#include "oscap_text.h"
#include "oscap_source.h"
#include "oscap_export.h"
 
struct cpe_dict_model;
 
struct cpe_item;
 
struct cpe_vendor;
 
struct cpe_generator;
 
struct cpe_check;
 
struct cpe_reference;
 
struct cpe_item_metadata;
 
struct cpe_product;
struct cpe_version;
struct cpe_update;
struct cpe_edition;
struct cpe_language;
 
/************************************************************/
OSCAP_API const char *cpe_item_metadata_get_modification_date(const struct cpe_item_metadata *item);
 
OSCAP_API const char *cpe_item_metadata_get_status(const struct cpe_item_metadata *item);
 
OSCAP_API const char *cpe_item_metadata_get_nvd_id(const struct cpe_item_metadata *item);
 
OSCAP_API const char *cpe_item_metadata_get_deprecated_by_nvd_id(const struct cpe_item_metadata *item);
 
OSCAP_API const char *cpe_check_get_system(const struct cpe_check *item);
 
OSCAP_API const char *cpe_check_get_href(const struct cpe_check *item);
 
OSCAP_API const char *cpe_check_get_identifier(const struct cpe_check *item);
 
OSCAP_API const char *cpe_reference_get_href(const struct cpe_reference *item);
 
OSCAP_API const char *cpe_reference_get_content(const struct cpe_reference *item);
 
OSCAP_API struct cpe_name *cpe_item_get_name(const struct cpe_item *item);
 
OSCAP_API struct cpe_name *cpe_item_get_deprecated_by(const struct cpe_item *item);
 
OSCAP_API const char *cpe_item_get_deprecation_date(const struct cpe_item *item);
 
OSCAP_API struct cpe_item_metadata *cpe_item_get_metadata(const struct cpe_item *item);
 
OSCAP_API struct cpe_reference_iterator *cpe_item_get_references(const struct cpe_item *item);
 
OSCAP_API struct cpe_check_iterator *cpe_item_get_checks(const struct cpe_item *item);
 
OSCAP_API struct oscap_text_iterator *cpe_item_get_titles(const struct cpe_item *item);
 
OSCAP_API const char *cpe_generator_get_product_name(const struct cpe_generator *item);
 
OSCAP_API const char *cpe_generator_get_product_version(const struct cpe_generator *item);
 
OSCAP_API const char *cpe_generator_get_schema_version(const struct cpe_generator *item);
 
OSCAP_API const char *cpe_generator_get_timestamp(const struct cpe_generator *item);
 
OSCAP_API int cpe_dict_model_get_base_version(const struct cpe_dict_model *item);
 
OSCAP_API bool cpe_dict_model_set_base_version(struct cpe_dict_model *item, int base_version);
 
OSCAP_API struct cpe_generator *cpe_dict_model_get_generator(const struct cpe_dict_model *item);
 
OSCAP_API struct cpe_item_iterator *cpe_dict_model_get_items(const struct cpe_dict_model *item);
 
OSCAP_API struct cpe_vendor_iterator *cpe_dict_model_get_vendors(const struct cpe_dict_model *item);
 
OSCAP_API const char *cpe_vendor_get_value(const struct cpe_vendor *item);
 
OSCAP_API struct oscap_text_iterator *cpe_vendor_get_titles(const struct cpe_vendor *item);
 
OSCAP_API struct cpe_product_iterator *cpe_vendor_get_products(const struct cpe_vendor *item);
 
OSCAP_API const char *cpe_product_get_value(const struct cpe_product *item);
 
OSCAP_API cpe_part_t cpe_product_get_part(const struct cpe_product *item);
 
OSCAP_API struct cpe_version_iterator *cpe_product_get_versions(const struct cpe_product *item);
 
OSCAP_API const char *cpe_version_get_value(const struct cpe_version *item);
 
OSCAP_API struct cpe_update_iterator *cpe_version_get_updates(const struct cpe_version *item);
 
OSCAP_API const char *cpe_update_get_value(const struct cpe_update *item);
 
OSCAP_API struct cpe_edition_iterator *cpe_update_get_editions(const struct cpe_update *item);
 
OSCAP_API const char *cpe_edition_get_value(const struct cpe_edition *item);
 
OSCAP_API struct cpe_language_iterator *cpe_edition_get_languages(const struct cpe_edition *item);
 
OSCAP_API const char *cpe_language_get_value(const struct cpe_language *item);
 
/************************************************************/
OSCAP_API void cpe_check_free(struct cpe_check *check);
OSCAP_API void cpe_reference_free(struct cpe_reference *ref);
OSCAP_API void cpe_vendor_free(struct cpe_vendor *vendor);
OSCAP_API void cpe_product_free(struct cpe_product *product);
OSCAP_API void cpe_version_free(struct cpe_version *version);
OSCAP_API void cpe_update_free(struct cpe_update *update);
OSCAP_API void cpe_edition_free(struct cpe_edition *edition);
OSCAP_API void cpe_language_free(struct cpe_language *language);
OSCAP_API void cpe_itemmetadata_free(struct cpe_item_metadata *meta);
OSCAP_API void cpe_dict_model_free(struct cpe_dict_model *dict);
OSCAP_API void cpe_generator_free(struct cpe_generator *generator);
OSCAP_API void cpe_item_free(struct cpe_item *item);
 
OSCAP_API struct cpe_dict_model *cpe_dict_model_new(void);
OSCAP_API struct cpe_generator *cpe_generator_new(void);
OSCAP_API struct cpe_check *cpe_check_new(void);
OSCAP_API struct cpe_reference *cpe_reference_new(void);
OSCAP_API struct cpe_item *cpe_item_new(void);
OSCAP_API struct cpe_vendor *cpe_vendor_new(void);
OSCAP_API struct cpe_product *cpe_product_new(void);
OSCAP_API struct cpe_version *cpe_version_new(void);
OSCAP_API struct cpe_update *cpe_update_new(void);
OSCAP_API struct cpe_edition *cpe_edition_new(void);
OSCAP_API struct cpe_language *cpe_language_new(void);
OSCAP_API struct cpe_item_metadata *cpe_item_metadata_new(void);
 
/************************************************************/
OSCAP_API bool cpe_item_set_name(struct cpe_item *item, struct cpe_name *new_name);
 
OSCAP_API bool cpe_item_set_deprecated_by(struct cpe_item *item, struct cpe_name *new_deprecated_by);
 
OSCAP_API bool cpe_item_set_deprecation_date(struct cpe_item *item, const char *new_deprecation_date);
 
OSCAP_API bool cpe_item_metadata_set_modification_date(struct cpe_item_metadata *item_metadata,
                                             const char *new_modification_date);
 
OSCAP_API bool cpe_item_metadata_set_status(struct cpe_item_metadata *item_metadata, const char *new_status);
 
OSCAP_API bool cpe_item_metadata_set_nvd_id(struct cpe_item_metadata *item_metadata, const char *new_nvd_id);
 
OSCAP_API bool cpe_item_metadata_set_deprecated_by_nvd_id(struct cpe_item_metadata *item_metadata,
                                                const char *new_deprecated_by_nvd_id);
 
OSCAP_API bool cpe_check_set_system(struct cpe_check *check, const char *new_system);
 
OSCAP_API bool cpe_check_set_href(struct cpe_check *check, const char *new_href);
 
OSCAP_API bool cpe_check_set_identifier(struct cpe_check *check, const char *new_identifier);
 
OSCAP_API bool cpe_reference_set_href(struct cpe_reference *reference, const char *new_href);
 
OSCAP_API bool cpe_reference_set_content(struct cpe_reference *reference, const char *new_content);
 
OSCAP_API bool cpe_generator_set_product_name(struct cpe_generator *generator, const char *new_product_name);
 
OSCAP_API bool cpe_generator_set_product_version(struct cpe_generator *generator, const char *new_product_version);
 
OSCAP_API bool cpe_generator_set_schema_version(struct cpe_generator *generator, const char *new_schema_version);
 
OSCAP_API bool cpe_generator_set_timestamp(struct cpe_generator *generator, const char *new_timestamp);
 
OSCAP_API bool cpe_vendor_set_value(struct cpe_vendor *vendor, const char *new_value);
 
OSCAP_API bool cpe_product_set_value(struct cpe_product *product, const char *new_value);
 
OSCAP_API bool cpe_product_set_part(struct cpe_product *product, cpe_part_t new_part);
 
OSCAP_API bool cpe_version_set_value(struct cpe_version *version, const char *new_value);
 
OSCAP_API bool cpe_update_set_value(struct cpe_update *update, const char *new_value);
 
OSCAP_API bool cpe_edition_set_value(struct cpe_edition *edition, const char *new_value);
 
OSCAP_API bool cpe_language_set_value(struct cpe_language *language, const char *new_value);
 
/*
 * Add functions
 */
 
OSCAP_API bool cpe_item_add_reference(struct cpe_item *item, struct cpe_reference *new_reference);
 
OSCAP_API bool cpe_item_add_check(struct cpe_item *item, struct cpe_check *new_check);
 
OSCAP_API bool cpe_item_add_title(struct cpe_item *item, struct oscap_text *new_title);
 
OSCAP_API bool cpe_dict_model_add_item(struct cpe_dict_model *dict, struct cpe_item *new_item);
 
OSCAP_API bool cpe_dict_model_add_vendor(struct cpe_dict_model *dict, struct cpe_vendor *new_vendor);
 
OSCAP_API bool cpe_vendor_add_title(struct cpe_vendor *vendor, struct oscap_text *new_title);
 
OSCAP_API bool cpe_vendor_add_product(struct cpe_vendor *vendor, struct cpe_product *new_product);
 
OSCAP_API bool cpe_product_add_version(struct cpe_product *product, struct cpe_version *new_version);
 
OSCAP_API bool cpe_version_add_update(struct cpe_version *version, struct cpe_update *new_update);
 
OSCAP_API bool cpe_update_add_edition(struct cpe_update *update, struct cpe_edition *new_edition);
 
OSCAP_API bool cpe_edition_add_language(struct cpe_edition *edition, struct cpe_language *new_language);
 
 
/************************************************************/
/************************************************************/
struct cpe_item_iterator;
 
OSCAP_API struct cpe_item *cpe_item_iterator_next(struct cpe_item_iterator *it);
 
OSCAP_API bool cpe_item_iterator_has_more(struct cpe_item_iterator *it);
 
OSCAP_API void cpe_item_iterator_free(struct cpe_item_iterator *it);
 
OSCAP_API void cpe_item_iterator_remove(struct cpe_item_iterator *it);
OSCAP_API void cpe_item_iterator_reset(struct cpe_item_iterator *it);
 
struct cpe_reference_iterator;
 
OSCAP_API struct cpe_reference *cpe_reference_iterator_next(struct cpe_reference_iterator *it);
 
OSCAP_API bool cpe_reference_iterator_has_more(struct cpe_reference_iterator *it);
 
OSCAP_API void cpe_reference_iterator_free(struct cpe_reference_iterator *it);
 
OSCAP_API void cpe_reference_iterator_remove(struct cpe_reference_iterator *it);
OSCAP_API void cpe_reference_iterator_reset(struct cpe_reference_iterator *it);
 
struct cpe_check_iterator;
 
OSCAP_API struct cpe_check *cpe_check_iterator_next(struct cpe_check_iterator *it);
 
OSCAP_API bool cpe_check_iterator_has_more(struct cpe_check_iterator *it);
 
OSCAP_API void cpe_check_iterator_free(struct cpe_check_iterator *it);
 
OSCAP_API void cpe_check_iterator_remove(struct cpe_check_iterator *it);
OSCAP_API void cpe_check_iterator_reset(struct cpe_check_iterator *it);
 
struct cpe_vendor_iterator;
 
OSCAP_API struct cpe_vendor *cpe_vendor_iterator_next(struct cpe_vendor_iterator *it);
 
OSCAP_API bool cpe_vendor_iterator_has_more(struct cpe_vendor_iterator *it);
 
OSCAP_API void cpe_vendor_iterator_free(struct cpe_vendor_iterator *it);
 
OSCAP_API void cpe_vendor_iterator_remove(struct cpe_vendor_iterator *it);
OSCAP_API void cpe_vendor_iterator_reset(struct cpe_vendor_iterator *it);
 
struct cpe_product_iterator;
 
OSCAP_API struct cpe_product *cpe_product_iterator_next(struct cpe_product_iterator *it);
 
OSCAP_API bool cpe_product_iterator_has_more(struct cpe_product_iterator *it);
 
OSCAP_API void cpe_product_iterator_free(struct cpe_product_iterator *it);
 
OSCAP_API void cpe_product_iterator_remove(struct cpe_product_iterator *it);
OSCAP_API void cpe_product_iterator_reset(struct cpe_product_iterator *it);
 
struct cpe_version_iterator;
 
OSCAP_API struct cpe_version *cpe_version_iterator_next(struct cpe_version_iterator *it);
 
OSCAP_API bool cpe_version_iterator_has_more(struct cpe_version_iterator *it);
 
OSCAP_API void cpe_version_iterator_free(struct cpe_version_iterator *it);
 
OSCAP_API void cpe_version_iterator_remove(struct cpe_version_iterator *it);
OSCAP_API void cpe_version_iterator_reset(struct cpe_version_iterator *it);
 
struct cpe_update_iterator;
 
OSCAP_API struct cpe_update *cpe_update_iterator_next(struct cpe_update_iterator *it);
 
OSCAP_API bool cpe_update_iterator_has_more(struct cpe_update_iterator *it);
 
OSCAP_API void cpe_update_iterator_free(struct cpe_update_iterator *it);
 
OSCAP_API void cpe_update_iterator_remove(struct cpe_update_iterator *it);
OSCAP_API void cpe_update_iterator_reset(struct cpe_update_iterator *it);
 
struct cpe_edition_iterator;
 
OSCAP_API struct cpe_edition *cpe_edition_iterator_next(struct cpe_edition_iterator *it);
 
OSCAP_API bool cpe_edition_iterator_has_more(struct cpe_edition_iterator *it);
 
OSCAP_API void cpe_edition_iterator_free(struct cpe_edition_iterator *it);
 
OSCAP_API void cpe_edition_iterator_remove(struct cpe_edition_iterator *it);
OSCAP_API void cpe_edition_iterator_reset(struct cpe_edition_iterator *it);
 
struct cpe_language_iterator;
 
OSCAP_API struct cpe_language *cpe_language_iterator_next(struct cpe_language_iterator *it);
 
OSCAP_API bool cpe_language_iterator_has_more(struct cpe_language_iterator *it);
 
OSCAP_API void cpe_language_iterator_free(struct cpe_language_iterator *it);
 
OSCAP_API void cpe_language_iterator_remove(struct cpe_language_iterator *it);
OSCAP_API void cpe_language_iterator_reset(struct cpe_language_iterator *it);
 
/************************************************************/
/************************************************************/
OSCAP_API const char * cpe_dict_model_supported(void);
 
OSCAP_API bool cpe_name_match_dict(struct cpe_name *cpe, struct cpe_dict_model *dict);
 
OSCAP_API bool cpe_name_applicable_dict(struct cpe_name *cpe, struct cpe_dict_model *dict, cpe_check_fn cb, void* usr);
 
OSCAP_API bool cpe_item_is_applicable(struct cpe_item* item, cpe_check_fn cb, void* usr);
 
/************************************************************/
OSCAP_API void cpe_dict_model_export(const struct cpe_dict_model *dict, const char *file);
 
OSCAP_API struct cpe_dict_model *cpe_dict_model_import_source(struct oscap_source *source);
 
 
#endif                          /* _CPEDICT_H_ */