st_client.c File Reference

#include <crm_internal.h>
#include <unistd.h>
#include <stdlib.h>
#include <stdio.h>
#include <stdbool.h>
#include <string.h>
#include <ctype.h>
#include <libgen.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <sys/wait.h>
#include <glib.h>
#include <crm/crm.h>
#include <crm/stonith-ng.h>
#include <crm/fencing/internal.h>
#include <crm/msg_xml.h>
#include <crm/common/xml.h>
#include <crm/common/xml_internal.h>
#include <crm/common/mainloop.h>

Include dependency graph for st_client.c:

Go to the source code of this file.

Data Structures
struct	timer_rec_s

Macros
#define	FAILURE_MAX_RETRIES   2
#define	api_log_open()   openlog("stonith-api", LOG_CONS | LOG_NDELAY | LOG_PID, LOG_DAEMON)
#define	api_log(level, fmt, args...)   syslog(level, "%s: "fmt, __func__, args)

Typedefs
typedef struct stonith_private_s	stonith_private_t
typedef struct stonith_notify_client_s	stonith_notify_client_t
typedef struct stonith_callback_client_s	stonith_callback_client_t
typedef int(*	stonith_op_t) (const char *, int, const char *, xmlNode *, xmlNode *, xmlNode *, xmlNode **, xmlNode **)

Functions
	CRM_TRACE_INIT_DATA (stonith)
bool	stonith_dispatch (stonith_t *st)
xmlNode *	stonith_create_op (int call_id, const char *token, const char *op, xmlNode *data, int call_options)
enum stonith_namespace	stonith_text2namespace (const char *namespace_s)
	Get agent namespace by name. More...
const char *	stonith_namespace2text (enum stonith_namespace st_namespace)
	Get agent namespace name. More...
enum stonith_namespace	stonith_get_namespace (const char *agent, const char *namespace_s)
	Determine namespace of a fence agent. More...
xmlNode *	create_device_registration_xml (const char *id, enum stonith_namespace namespace, const char *agent, stonith_key_value_t *params, const char *rsc_provides)
xmlNode *	create_level_registration_xml (const char *node, const char *pattern, const char *attr, const char *value, int level, stonith_key_value_t *device_list)
void	stonith__destroy_action (stonith_action_t *action)
void	stonith__action_result (stonith_action_t *action, int *rc, char **output, char **error_output)
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)
int	stonith_action_execute_async (stonith_action_t *action, void *userdata, void(*done)(GPid pid, int rc, const char *output, gpointer user_data), void(*fork_cb)(GPid pid, gpointer user_data))
int	stonith__execute (stonith_action_t *action)
void	stonith_history_free (stonith_history_t *history)
void	stonith_dump_pending_callbacks (stonith_t *stonith)
void	stonith_api_delete (stonith_t *stonith)
stonith_t *	stonith_api_new (void)
int	stonith_api_connect_retry (stonith_t *st, const char *name, int max_attempts)
	Make a blocking connection attempt to the fencer. More...
stonith_key_value_t *	stonith_key_value_add (stonith_key_value_t *head, const char *key, const char *value)
void	stonith_key_value_freeall (stonith_key_value_t *head, int keys, int values)
int	stonith_api_kick (uint32_t nodeid, const char *uname, int timeout, bool off)
time_t	stonith_api_time (uint32_t nodeid, const char *uname, bool in_progress)
bool	stonith_agent_exists (const char *agent, int timeout)
const char *	stonith_action_str (const char *action)
	Turn stonith action into a more readable string. More...
GList *	stonith__parse_targets (const char *target_spec)
gboolean	stonith__later_succeeded (stonith_history_t *event, stonith_history_t *top_history)
stonith_history_t *	stonith__sort_history (stonith_history_t *history)
stonith_history_t *	stonith__first_matching_event (stonith_history_t *history, bool(*matching_fn)(stonith_history_t *, void *), void *user_data)
bool	stonith__event_state_pending (stonith_history_t *history, void *user_data)
bool	stonith__event_state_eq (stonith_history_t *history, void *user_data)
bool	stonith__event_state_neq (stonith_history_t *history, void *user_data)
const char *	get_stonith_provider (const char *agent, const char *provider)
	Deprecated (use stonith_get_namespace() instead) More...
void	stonith__device_parameter_flags (uint32_t *device_flags, const char *device_name, xmlNode *metadata)

Macro Definition Documentation

api_log

#define api_log	(		level,
			fmt,
			args...
	)		syslog(level, "%s: "fmt, __func__, args)

Definition at line 2252 of file st_client.c.

api_log_open

#define api_log_open

(

)

openlog("stonith-api", LOG_CONS | LOG_NDELAY | LOG_PID, LOG_DAEMON)

Definition at line 2251 of file st_client.c.

FAILURE_MAX_RETRIES

#define FAILURE_MAX_RETRIES   2

Definition at line 640 of file st_client.c.

Typedef Documentation

stonith_callback_client_t

typedef struct stonith_callback_client_s stonith_callback_client_t

stonith_notify_client_t

typedef struct stonith_notify_client_s stonith_notify_client_t

stonith_op_t

typedef int(* stonith_op_t) (const char *, int, const char *, xmlNode *, xmlNode *, xmlNode *, xmlNode **, xmlNode **)

Definition at line 107 of file st_client.c.

stonith_private_t

typedef struct stonith_private_s stonith_private_t

Function Documentation

create_device_registration_xml()

xmlNode* create_device_registration_xml	(	const char *	id,
		enum stonith_namespace	namespace,
		const char *	agent,
		stonith_key_value_t *	params,
		const char *	rsc_provides
	)

Definition at line 274 of file st_client.c.

create_level_registration_xml()

xmlNode* create_level_registration_xml	(	const char *	node,
		const char *	pattern,
		const char *	attr,
		const char *	value,
		int	level,
		stonith_key_value_t *	device_list
	)

Definition at line 394 of file st_client.c.

CRM_TRACE_INIT_DATA()

CRM_TRACE_INIT_DATA

(

stonith

)

get_stonith_provider()

const char* get_stonith_provider	(	const char *	agent,
		const char *	provider
	)

Deprecated (use stonith_get_namespace() instead)

Deprecated:

Use stonith_get_namespace() instead

Definition at line 2654 of file st_client.c.

stonith__action_result()

void stonith__action_result	(	stonith_action_t *	action,
		int *	rc,
		char **	output,
		char **	error_output
	)

Definition at line 613 of file st_client.c.

stonith__destroy_action()

void stonith__destroy_action

(

stonith_action_t *

action

)

Definition at line 582 of file st_client.c.

stonith__device_parameter_flags()

void stonith__device_parameter_flags	(	uint32_t *	device_flags,
		const char *	device_name,
		xmlNode *	metadata
	)

Definition at line 2660 of file st_client.c.

stonith__event_state_eq()

bool stonith__event_state_eq	(	stonith_history_t *	history,
		void *	user_data
	)

Definition at line 2636 of file st_client.c.

stonith__event_state_neq()

bool stonith__event_state_neq	(	stonith_history_t *	history,
		void *	user_data
	)

Definition at line 2642 of file st_client.c.

stonith__event_state_pending()

bool stonith__event_state_pending	(	stonith_history_t *	history,
		void *	user_data
	)

Definition at line 2630 of file st_client.c.

stonith__execute()

int stonith__execute

(

stonith_action_t *

action

)

Definition at line 897 of file st_client.c.

stonith__first_matching_event()

stonith_history_t* stonith__first_matching_event	(	stonith_history_t *	history,
		bool(*)(stonith_history_t *, void *)	matching_fn,
		void *	user_data
	)

Definition at line 2616 of file st_client.c.

stonith__later_succeeded()

gboolean stonith__later_succeeded	(	stonith_history_t *	event,
		stonith_history_t *	top_history
	)

Definition at line 2540 of file st_client.c.

stonith__parse_targets()

GList* stonith__parse_targets

(

const char *

target_spec

)

Definition at line 2500 of file st_client.c.

stonith__sort_history()

stonith_history_t* stonith__sort_history

(

stonith_history_t *

history

)

Definition at line 2571 of file st_client.c.

stonith_action_create()

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 at line 642 of file st_client.c.

stonith_action_execute_async()

int stonith_action_execute_async	(	stonith_action_t *	action,
		void *	userdata,
		void(*)(GPid pid, int rc, const char *output, gpointer user_data)	done,
		void(*)(GPid pid, gpointer user_data)	fork_cb
	)

Definition at line 870 of file st_client.c.

stonith_action_str()

const char* stonith_action_str

(

const char *

action

)

Turn stonith action into a more readable string.

Parameters

action

Stonith action

Definition at line 2392 of file st_client.c.

stonith_agent_exists()

bool stonith_agent_exists	(	const char *	agent,
		int	timeout
	)

Does the given agent describe a stonith resource that can exist?

Parameters

[in]	agent	What is the name of the agent?
[in]	timeout	Timeout to use when querying. If 0 is given, use a default of 120.

Returns

A boolean

Definition at line 2361 of file st_client.c.

stonith_api_connect_retry()

int stonith_api_connect_retry	(	stonith_t *	st,
		const char *	name,
		int	max_attempts
	)

Make a blocking connection attempt to the fencer.

Parameters

[in,out]	st	Fencer API object
[in]	name	Client name to use with fencer
[in]	max_attempts	Return error if this many attempts fail

Returns

pcmk_ok on success, result of last attempt otherwise

Definition at line 2186 of file st_client.c.

stonith_api_delete()

void stonith_api_delete

(

stonith_t *

stonith

)

Definition at line 2018 of file st_client.c.

stonith_api_kick()

int stonith_api_kick	(	uint32_t	nodeid,
		const char *	uname,
		int	timeout,
		bool	off
	)

Definition at line 2255 of file st_client.c.

stonith_api_new()

stonith_t* stonith_api_new

(

void

)

Definition at line 2107 of file st_client.c.

stonith_api_time()

time_t stonith_api_time	(	uint32_t	nodeid,
		const char *	uname,
		bool	in_progress
	)

Definition at line 2297 of file st_client.c.

stonith_create_op()

xmlNode * stonith_create_op	(	int	call_id,
		const char *	token,
		const char *	op,
		xmlNode *	data,
		int	call_options
	)

Definition at line 1211 of file st_client.c.

stonith_dispatch()

bool stonith_dispatch

(

stonith_t *

st

)

Definition at line 1960 of file st_client.c.

stonith_dump_pending_callbacks()

void stonith_dump_pending_callbacks

(

stonith_t *

stonith

)

Definition at line 1709 of file st_client.c.

stonith_get_namespace()

enum stonith_namespace stonith_get_namespace	(	const char *	agent,
		const char *	namespace_s
	)

Determine namespace of a fence agent.

Parameters

[in]	agent	Fence agent type
[in]	namespace_s	Name of agent namespace as string, if known

Returns

Namespace of specified agent, as enum value

Definition at line 177 of file st_client.c.

stonith_history_free()

void stonith_history_free

(

stonith_history_t *

history

)

Definition at line 1165 of file st_client.c.

stonith_key_value_add()

stonith_key_value_t* stonith_key_value_add	(	stonith_key_value_t *	head,
		const char *	key,
		const char *	value
	)

Definition at line 2207 of file st_client.c.

stonith_key_value_freeall()

void stonith_key_value_freeall	(	stonith_key_value_t *	head,
		int	keys,
		int	values
	)

Definition at line 2234 of file st_client.c.

stonith_namespace2text()

const char* stonith_namespace2text

(

enum stonith_namespace

st_namespace

)

Get agent namespace name.

Parameters

[in]

namespace

Namespace as enum value

Returns

Namespace name as string

Definition at line 156 of file st_client.c.

stonith_text2namespace()

enum stonith_namespace stonith_text2namespace

(

const char *

namespace_s

)

Get agent namespace by name.

Parameters

[in]

namespace_s

Name of namespace as string

Returns

Namespace as enum value

Definition at line 130 of file st_client.c.