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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
/*
* Copyright 2020-2021 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_IPC_CONTROLD__H
# define PCMK__CRM_COMMON_IPC_CONTROLD__H
#include <stdbool.h> // bool
#include <glib.h> // GList
#include <libxml/tree.h> // xmlNode
#include <crm/common/ipc.h> // pcmk_ipc_api_t
#ifdef __cplusplus
extern "C" {
#endif
/**
* \file
* \brief IPC commands for Pacemaker controller
*
* \ingroup core
*/
//! Possible types of controller replies
enum pcmk_controld_api_reply {
pcmk_controld_reply_unknown,
pcmk_controld_reply_reprobe,
pcmk_controld_reply_info,
pcmk_controld_reply_resource,
pcmk_controld_reply_ping,
pcmk_controld_reply_nodes,
};
// Node information passed with pcmk_controld_reply_nodes
typedef struct {
uint32_t id;
const char *uname;
const char *state;
} pcmk_controld_api_node_t;
/*!
* Controller reply passed to event callback
*
* \note Shutdown and election calls have no reply. Reprobe calls are
* acknowledged but contain no data (reply_type will be the only item
* set). Node info and ping calls have their own reply data. Fail and
* refresh calls use the resource reply type and reply data.
* \note The pointers in the reply are only guaranteed to be meaningful for the
* execution of the callback; if the values are needed for later, the
* callback should copy them.
*/
typedef struct {
enum pcmk_controld_api_reply reply_type;
const char *feature_set; //!< CRM feature set advertised by controller
const char *host_from; //!< Name of node that sent reply
union {
// pcmk_controld_reply_info
struct {
bool have_quorum;
bool is_remote;
int id;
const char *uuid;
const char *uname;
const char *state;
} node_info;
// pcmk_controld_reply_resource
struct {
xmlNode *node_state; //<! Resource operation history XML
} resource;
// pcmk_controld_reply_ping
struct {
const char *sys_from;
const char *fsa_state;
const char *result;
} ping;
// pcmk_controld_reply_nodes
GList *nodes; // list of pcmk_controld_api_node_t *
} data;
} pcmk_controld_api_reply_t;
int pcmk_controld_api_reprobe(pcmk_ipc_api_t *api, const char *target_node,
const char *router_node);
int pcmk_controld_api_node_info(pcmk_ipc_api_t *api, uint32_t nodeid);
int pcmk_controld_api_fail(pcmk_ipc_api_t *api, const char *target_node,
const char *router_node, const char *rsc_id,
const char *rsc_long_id, const char *standard,
const char *provider, const char *type);
int pcmk_controld_api_refresh(pcmk_ipc_api_t *api, const char *target_node,
const char *router_node, const char *rsc_id,
const char *rsc_long_id, const char *standard,
const char *provider, const char *type,
bool cib_only);
int pcmk_controld_api_ping(pcmk_ipc_api_t *api, const char *node_name);
int pcmk_controld_api_list_nodes(pcmk_ipc_api_t *api);
unsigned int pcmk_controld_api_replies_expected(const pcmk_ipc_api_t *api);
#ifdef __cplusplus
}
#endif
#endif // PCMK__CRM_COMMON_IPC_CONTROLD__H
|
