summaryrefslogtreecommitdiffstats
path: root/lib/common/probes.c
blob: 39a39058d564f08a7f4e18c084309f5247410554 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
/*
 * 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.
 */

#include <crm_internal.h>           // pcmk__str_eq(), etc.

#include <stdio.h>                  // NULL
#include <stdbool.h>                // bool, true, false
#include <glib.h>                   // guint
#include <libxml/tree.h>            // xmlNode

#include <crm/common/options.h>     // PCMK_META_INTERVAL
#include <crm/common/xml.h>         // PCMK_XA_OPERATION

/*!
 * \brief Check whether an action name and interval represent a probe
 *
 * \param[in] task         Action name
 * \param[in] interval_ms  Action interval in milliseconds
 *
 * \return true if \p task is \c PCMK_ACTION_MONITOR and \p interval_ms is 0,
 *         otherwise false
 */
bool
pcmk_is_probe(const char *task, guint interval_ms)
{
    // @COMPAT This should be made inline at an API compatibility break
    return (interval_ms == 0)
           && pcmk__str_eq(task, PCMK_ACTION_MONITOR, pcmk__str_none);
}

/*!
 * \brief Check whether an action history entry represents a probe
 *
 * \param[in] xml  XML of action history entry
 *
 * \return true if \p xml is for a probe action, otherwise false
 */
bool
pcmk_xe_is_probe(const xmlNode *xml)
{
    int interval_ms = 0;

    if (xml == NULL) {
        return false;
    }

    pcmk__scan_min_int(crm_element_value(xml, PCMK_META_INTERVAL),
                       &interval_ms, 0);

    return pcmk_is_probe(crm_element_value(xml, PCMK_XA_OPERATION),
                         interval_ms);
}

/*!
 * \brief Check whether an action history entry represents a maskable probe
 *
 * \param[in] xml  XML of action history entry
 *
 * \return true if \p xml is for a failed probe action that should be treated as
 *         successful, otherwise false
 */
bool
pcmk_xe_mask_probe_failure(const xmlNode *xml)
{
    int exec_status = PCMK_EXEC_UNKNOWN;
    int exit_status = PCMK_OCF_OK;

    if (!pcmk_xe_is_probe(xml)) {
        return false;
    }

    crm_element_value_int(xml, PCMK__XA_OP_STATUS, &exec_status);
    crm_element_value_int(xml, PCMK__XA_RC_CODE, &exit_status);

    return (exit_status == PCMK_OCF_NOT_INSTALLED)
           || (exit_status == PCMK_OCF_INVALID_PARAM)
           || (exec_status == PCMK_EXEC_NOT_INSTALLED);
}