rules.h

Go to the documentation of this file.

/*
 * Copyright 2004-2024 the Pacemaker project contributors
 *
 * The version control history for this file may have further details.
 *
 * This source code is licensed under the GNU Lesser General Public License
 * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
 */
 
#ifndef PCMK__CRM_COMMON_RULES__H
#define PCMK__CRM_COMMON_RULES__H
 
#include <glib.h>                   // guint, GHashTable
#include <regex.h>                  // regmatch_t
#include <libxml/tree.h>            // xmlNode
#include <crm/common/iso8601.h>     // crm_time_t
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* Allowed subexpressions of a rule
 * @COMPAT This should be made internal at an API compatibility break
 */
enum expression_type {
    pcmk__condition_unknown   = 0,  // Unknown or invalid condition
    pcmk__condition_rule      = 1,  // Nested rule
    pcmk__condition_attribute = 2,  // Node attribute expression
    pcmk__condition_location  = 3,  // Node location expression
    pcmk__condition_datetime  = 5,  // Date/time expression
    pcmk__condition_resource  = 7,  // Resource agent expression
    pcmk__condition_operation = 8,  // Operation expression
 
#if !defined(PCMK_ALLOW_DEPRECATED) || (PCMK_ALLOW_DEPRECATED == 1)
    not_expr        = pcmk__condition_unknown,
    nested_rule     = pcmk__condition_rule,
    attr_expr       = pcmk__condition_attribute,
    loc_expr        = pcmk__condition_location,
    role_expr       = 4,
    time_expr       = pcmk__condition_datetime,
    version_expr    = 6,
    rsc_expr        = pcmk__condition_resource,
    op_expr         = pcmk__condition_operation,
#endif
};
 
typedef struct pcmk_rule_input {
    // Used to evaluate date expressions
    const crm_time_t *now; 
 
    // Used to evaluate resource type expressions
    const char *rsc_standard;   
    const char *rsc_provider;   
    const char *rsc_agent;      
 
    // Used to evaluate operation type expressions
    const char *op_name;        
    guint op_interval_ms;       
 
    // Remaining members are used to evaluate node attribute expressions
 
    GHashTable *node_attrs;
 
    // Remaining members are used only within location constraint rules
 
    GHashTable *rsc_params;
 
    GHashTable *rsc_meta;
 
    const char *rsc_id;
 
    const regmatch_t *rsc_id_submatches;
 
    int rsc_id_nmatches;
} pcmk_rule_input_t;
 
int pcmk_evaluate_rule(xmlNode *rule, const pcmk_rule_input_t *rule_input,
                       crm_time_t *next_change);
 
#ifdef __cplusplus
}
#endif
 
#endif // PCMK__CRM_COMMON_RULES__H