pacemaker  2.1.2-ada5c3b36
Scalable High-Availability cluster resource manager
st_rhcs.c
Go to the documentation of this file.
1 /*
2  * Copyright 2004-2020 the Pacemaker project contributors
3  *
4  * The version control history for this file may have further details.
5  *
6  * This source code is licensed under the GNU Lesser General Public License
7  * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
8  */
9 
10 #include <crm_internal.h>
11 
12 #include <stdio.h>
13 #include <string.h>
14 #include <sys/stat.h>
15 #include <glib.h>
16 #include <dirent.h>
17 
18 #include <crm/crm.h>
19 #include <crm/stonith-ng.h>
20 #include <crm/fencing/internal.h>
21 
22 #include "fencing_private.h"
23 
24 #define RH_STONITH_PREFIX "fence_"
25 
34 int
36 {
37  // Essentially: ls -1 @sbin_dir@/fence_*
38 
39  int count = 0, i;
40  struct dirent **namelist;
41  const int file_num = scandir(PCMK__FENCE_BINDIR, &namelist, 0, alphasort);
42 
43 #if _POSIX_C_SOURCE < 200809L && !(defined(O_SEARCH) || defined(O_PATH))
44  char buffer[FILENAME_MAX + 1];
45 #elif defined(O_SEARCH)
46  const int dirfd = open(PCMK__FENCE_BINDIR, O_SEARCH);
47 #else
48  const int dirfd = open(PCMK__FENCE_BINDIR, O_PATH);
49 #endif
50 
51  for (i = 0; i < file_num; i++) {
52  struct stat prop;
53 
54  if (pcmk__starts_with(namelist[i]->d_name, RH_STONITH_PREFIX)) {
55 #if _POSIX_C_SOURCE < 200809L && !(defined(O_SEARCH) || defined(O_PATH))
56  snprintf(buffer, sizeof(buffer), "%s/%s", PCMK__FENCE_BINDIR,
57  namelist[i]->d_name);
58  if (stat(buffer, &prop) == 0 && S_ISREG(prop.st_mode)) {
59 #else
60  if (dirfd == -1) {
61  if (i == 0) {
62  crm_notice("Problem with listing %s directory"
63  CRM_XS "errno=%d", RH_STONITH_PREFIX, errno);
64  }
65  free(namelist[i]);
66  continue;
67  }
68  /* note: we can possibly prevent following symlinks here,
69  which may be a good idea, but fall on the nose when
70  these agents are moved elsewhere & linked back */
71  if (fstatat(dirfd, namelist[i]->d_name, &prop, 0) == 0
72  && S_ISREG(prop.st_mode)) {
73 #endif
74  *devices = stonith_key_value_add(*devices, NULL,
75  namelist[i]->d_name);
76  count++;
77  }
78  }
79  free(namelist[i]);
80  }
81  if (file_num > 0) {
82  free(namelist);
83  }
84 #if _POSIX_C_SOURCE >= 200809L || defined(O_SEARCH) || defined(O_PATH)
85  if (dirfd >= 0) {
86  close(dirfd);
87  }
88 #endif
89  return count;
90 }
91 
92 static void
93 stonith_rhcs_parameter_not_required(xmlNode *metadata, const char *parameter)
94 {
95  char *xpath = NULL;
96  xmlXPathObject *xpathObj = NULL;
97 
98  CRM_CHECK(metadata != NULL, return);
99  CRM_CHECK(parameter != NULL, return);
100 
101  xpath = crm_strdup_printf("//parameter[@name='%s']", parameter);
102  /* Fudge metadata so that the parameter isn't required in config
103  * Pacemaker handles and adds it */
104  xpathObj = xpath_search(metadata, xpath);
105  if (numXpathResults(xpathObj) > 0) {
106  xmlNode *tmp = getXpathResult(xpathObj, 0);
107 
108  crm_xml_add(tmp, "required", "0");
109  }
110  freeXpathObject(xpathObj);
111  free(xpath);
112 }
113 
123 static int
124 stonith__rhcs_get_metadata(const char *agent, int timeout, xmlNode **metadata)
125 {
126  char *buffer = NULL;
127  xmlNode *xml = NULL;
128  xmlNode *actions = NULL;
129  xmlXPathObject *xpathObj = NULL;
130  stonith_action_t *action = stonith_action_create(agent, "metadata", NULL, 0,
131  5, NULL, NULL, NULL);
132  int rc = stonith__execute(action);
133 
134  if (rc < 0) {
135  crm_warn("Could not execute metadata action for %s: %s "
136  CRM_XS " rc=%d", agent, pcmk_strerror(rc), rc);
138  return rc;
139  }
140 
141  stonith__action_result(action, &rc, &buffer, NULL);
143  if (rc < 0) {
144  crm_warn("Metadata action for %s failed: %s " CRM_XS "rc=%d",
145  agent, pcmk_strerror(rc), rc);
146  free(buffer);
147  return rc;
148  }
149 
150  if (buffer == NULL) {
151  crm_warn("Metadata action for %s returned no data", agent);
152  return -ENODATA;
153  }
154 
155  xml = string2xml(buffer);
156  free(buffer);
157  buffer = NULL;
158  if (xml == NULL) {
159  crm_warn("Metadata for %s is invalid", agent);
161  }
162 
163  xpathObj = xpath_search(xml, "//actions");
164  if (numXpathResults(xpathObj) > 0) {
165  actions = getXpathResult(xpathObj, 0);
166  }
167  freeXpathObject(xpathObj);
168 
169  // Add start and stop (implemented by pacemaker, not agent) to meta-data
170  xpathObj = xpath_search(xml, "//action[@name='stop']");
171  if (numXpathResults(xpathObj) <= 0) {
172  xmlNode *tmp = NULL;
173 
174  tmp = create_xml_node(actions, "action");
175  crm_xml_add(tmp, "name", "stop");
176  crm_xml_add(tmp, "timeout", CRM_DEFAULT_OP_TIMEOUT_S);
177 
178  tmp = create_xml_node(actions, "action");
179  crm_xml_add(tmp, "name", "start");
180  crm_xml_add(tmp, "timeout", CRM_DEFAULT_OP_TIMEOUT_S);
181  }
182  freeXpathObject(xpathObj);
183 
184  // Fudge metadata so parameters are not required in config (pacemaker adds them)
185  stonith_rhcs_parameter_not_required(xml, "action");
186  stonith_rhcs_parameter_not_required(xml, "plug");
187  stonith_rhcs_parameter_not_required(xml, "port");
188 
189  if (metadata) {
190  *metadata = xml;
191 
192  } else {
193  free_xml(xml);
194  }
195 
196  return pcmk_ok;
197 }
198 
208 int
209 stonith__rhcs_metadata(const char *agent, int timeout, char **output)
210 {
211  char *buffer = NULL;
212  xmlNode *xml = NULL;
213 
214  int rc = stonith__rhcs_get_metadata(agent, timeout, &xml);
215 
216  if (rc != pcmk_ok) {
217  free_xml(xml);
218  return rc;
219  }
220 
221  buffer = dump_xml_formatted_with_text(xml);
222  free_xml(xml);
223  if (buffer == NULL) {
225  }
226  if (output) {
227  *output = buffer;
228  } else {
229  free(buffer);
230  }
231  return pcmk_ok;
232 }
233 
234 bool
235 stonith__agent_is_rhcs(const char *agent)
236 {
237  struct stat prop;
238  char *buffer = crm_strdup_printf(PCMK__FENCE_BINDIR "/%s", agent);
239  int rc = stat(buffer, &prop);
240 
241  free(buffer);
242  return (rc >= 0) && S_ISREG(prop.st_mode);
243 }
244 
245 int
246 stonith__rhcs_validate(stonith_t *st, int call_options, const char *target,
247  const char *agent, GHashTable *params,
248  const char * host_arg, int timeout,
249  char **output, char **error_output)
250 {
251  int rc = pcmk_ok;
252  int remaining_timeout = timeout;
253  xmlNode *metadata = NULL;
254  stonith_action_t *action = NULL;
255 
256  if (host_arg == NULL) {
257  time_t start_time = time(NULL);
258 
259  rc = stonith__rhcs_get_metadata(agent, remaining_timeout, &metadata);
260 
261  if (rc == pcmk_ok) {
262  uint32_t device_flags = 0;
263 
264  stonith__device_parameter_flags(&device_flags, agent, metadata);
265  if (pcmk_is_set(device_flags, st_device_supports_parameter_port)) {
266  host_arg = "port";
267 
268  } else if (pcmk_is_set(device_flags,
270  host_arg = "plug";
271  }
272  }
273 
274  free_xml(metadata);
275 
276  remaining_timeout -= time(NULL) - start_time;
277 
278  if (rc == -ETIME || remaining_timeout <= 0 ) {
279  return -ETIME;
280  }
281 
282  } else if (pcmk__str_eq(host_arg, "none", pcmk__str_casei)) {
283  host_arg = NULL;
284  }
285 
286  action = stonith_action_create(agent, "validate-all",
287  target, 0, remaining_timeout, params,
288  NULL, host_arg);
289 
291  if (rc == pcmk_ok) {
292  stonith__action_result(action, &rc, output, error_output);
293  }
295  return rc;
296 }
void stonith__destroy_action(stonith_action_t *action)
Definition: st_client.c:636
#define CRM_CHECK(expr, failure_action)
Definition: logging.h:225
struct stonith_action_s stonith_action_t
Definition: internal.h:50
#define pcmk_err_schema_validation
Definition: results.h:73
A dumping ground.
#define crm_notice(fmt, args...)
Definition: logging.h:359
bool stonith__agent_is_rhcs(const char *agent)
Definition: st_rhcs.c:235
const char * pcmk_strerror(int rc)
Definition: results.c:58
#define ETIME
Definition: portability.h:147
void stonith__action_result(stonith_action_t *action, int *rc, char **output, char **error_output)
Definition: st_client.c:667
#define PCMK__FENCE_BINDIR
Definition: config.h:520
int alphasort(const void *dirent1, const void *dirent2)
const char * crm_xml_add(xmlNode *node, const char *name, const char *value)
Create an XML attribute with specified name and value.
Definition: nvpair.c:323
stonith_action_t * stonith_action_create(const char *agent, const char *_action, const char *victim, uint32_t victim_nodeid, int timeout, GHashTable *device_args, GHashTable *port_map, const char *host_arg)
Definition: st_client.c:696
int stonith__rhcs_metadata(const char *agent, int timeout, char **output)
Execute RHCS-compatible agent&#39;s meta-data action.
Definition: st_rhcs.c:209
int stonith__rhcs_validate(stonith_t *st, int call_options, const char *target, const char *agent, GHashTable *params, const char *host_arg, int timeout, char **output, char **error_output)
Definition: st_rhcs.c:246
const char * action
Definition: pcmk_fence.c:30
xmlNode * string2xml(const char *input)
Definition: xml.c:869
stonith_key_value_t * stonith_key_value_add(stonith_key_value_t *kvp, const char *key, const char *value)
Definition: st_client.c:2261
#define crm_warn(fmt, args...)
Definition: logging.h:358
stonith_t * st
Definition: pcmk_fence.c:28
int rc
Definition: pcmk_fence.c:35
void stonith__device_parameter_flags(uint32_t *device_flags, const char *device_name, xmlNode *metadata)
Definition: st_client.c:2725
char * crm_strdup_printf(char const *format,...) G_GNUC_PRINTF(1
#define pcmk_is_set(g, f)
Convenience alias for pcmk_all_flags_set(), to check single flag.
Definition: util.h:114
xmlNode * create_xml_node(xmlNode *parent, const char *name)
Definition: xml.c:696
#define CRM_DEFAULT_OP_TIMEOUT_S
Definition: util.h:73
void free_xml(xmlNode *child)
Definition: xml.c:824
const char * target
Definition: pcmk_fence.c:29
#define CRM_XS
Definition: logging.h:54
#define ENODATA
Definition: portability.h:143
#define RH_STONITH_PREFIX
Definition: st_rhcs.c:24
int stonith__list_rhcs_agents(stonith_key_value_t **devices)
Definition: st_rhcs.c:35
xmlXPathObjectPtr xpath_search(xmlNode *xml_top, const char *path)
Definition: xpath.c:139
Fencing aka. STONITH.
xmlNode * getXpathResult(xmlXPathObjectPtr xpathObj, int index)
Definition: xpath.c:58
#define pcmk_ok
Definition: results.h:68
bool pcmk__starts_with(const char *str, const char *prefix)
Check whether a string starts with a certain sequence.
Definition: strings.c:484
void freeXpathObject(xmlXPathObjectPtr xpathObj)
Definition: xpath.c:39
unsigned int timeout
Definition: pcmk_fence.c:32
char * dump_xml_formatted_with_text(xmlNode *msg)
Definition: xml.c:1990
G_GNUC_INTERNAL int stonith__execute(stonith_action_t *action)
Definition: st_client.c:952