pacemaker  2.0.2-debe490
Scalable High-Availability cluster resource manager
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Macros | Enumerations | Functions
schemas.c File Reference
#include <crm_internal.h>
#include <stdio.h>
#include <string.h>
#include <dirent.h>
#include <errno.h>
#include <sys/stat.h>
#include <stdarg.h>
#include <libxml/relaxng.h>
#include <crm/msg_xml.h>
#include <crm/common/xml.h>
#include <crm/common/xml_internal.h>
Include dependency graph for schemas.c:

Go to the source code of this file.


#define SCHEMA_ZERO   { .v = { 0, 0 } }
#define schema_scanf(s, prefix, version, suffix)   sscanf((s), prefix "%hhu.%hhu" suffix, &((version).v[0]), &((version).v[1]))
#define schema_strdup_printf(prefix, version, suffix)   crm_strdup_printf(prefix "%u.%u" suffix, (version).v[0], (version).v[1])


enum  schema_validator_e { schema_validator_none, schema_validator_rng }


const char * xml_latest_schema (void)
void crm_schema_init (void)
void crm_schema_cleanup (void)
gboolean validate_xml_verbose (xmlNode *xml_blob)
gboolean validate_xml (xmlNode *xml_blob, const char *validation, gboolean to_logs)
const char * get_schema_name (int version)
int get_schema_version (const char *name)
int update_validation (xmlNode **xml_blob, int *best, int max, gboolean transform, gboolean to_logs)
 Update CIB XML to most recent schema version. More...
gboolean cli_config_update (xmlNode **xml, int *best_version, gboolean to_logs)

Macro Definition Documentation

#define schema_scanf (   s,
)    sscanf((s), prefix "%hhu.%hhu" suffix, &((version).v[0]), &((version).v[1]))

Definition at line 37 of file schemas.c.

#define schema_strdup_printf (   prefix,
)    crm_strdup_printf(prefix "%u.%u" suffix, (version).v[0], (version).v[1])

Definition at line 40 of file schemas.c.

#define SCHEMA_ZERO   { .v = { 0, 0 } }

Definition at line 35 of file schemas.c.

Enumeration Type Documentation


Definition at line 49 of file schemas.c.

Function Documentation

gboolean cli_config_update ( xmlNode **  xml,
int *  best_version,
gboolean  to_logs 

Definition at line 1191 of file schemas.c.

void crm_schema_cleanup ( void  )

Definition at line 546 of file schemas.c.

void crm_schema_init ( void  )

Definition at line 374 of file schemas.c.

const char* get_schema_name ( int  version)

Definition at line 1016 of file schemas.c.

int get_schema_version ( const char *  name)

Definition at line 1025 of file schemas.c.

int update_validation ( xmlNode **  xml_blob,
int *  best,
int  max,
gboolean  transform,
gboolean  to_logs 

Update CIB XML to most recent schema version.

"Update" means either actively employ XSLT-based transformation(s) (if intermediate product to transform valid per its declared schema version, transformation available, proceeded successfully with a result valid per expectated newer schema version), or just try to bump the marked validating schema until all gradually rising schema versions attested or the first such attempt subsequently fails to validate. Which of the two styles will be used depends on transform parameter (positive/negative, respectively).

[in,out]xml_blobXML tree representing CIB, may be swapped with an "updated" one
[out]bestThe highest configuration version (per its index in the global schemas table) it was possible to reach during the update steps while ensuring the validity of the result; if no validation success was observed against possibly multiple schemas, the value is less or equal the result of get_schema_version applied on the input xml_blob value (unless that function maps it to -1, then 0 would be used instead)
[in]maxWhen transform is positive, this allows to set upper boundary schema (per its index in the global schemas table) beyond which it's forbidden to update by the means of XSLT transformation
[in]transformWhether to employ XSLT-based transformation so as to allow overcoming possible incompatibilities between major schema versions (see above)
[in]to_logsIf true, output notable progress info to internal log streams; if false, to stderr
pcmk_ok if no non-recoverable error encountered (up to caller to evaluate if the update satisfies the requirements per returned best value), negative value carrying the reason otherwise

Definition at line 1042 of file schemas.c.

gboolean validate_xml ( xmlNode *  xml_blob,
const char *  validation,
gboolean  to_logs 

Definition at line 696 of file schemas.c.

gboolean validate_xml_verbose ( xmlNode *  xml_blob)

Definition at line 668 of file schemas.c.

const char* xml_latest_schema ( void  )

Definition at line 115 of file schemas.c.