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