#include <crm_internal.h>
#include <stdlib.h>
#include <stdio.h>
#include <stdbool.h>
#include <string.h>
#include <ctype.h>
#include <inttypes.h>
#include <sys/types.h>
#include <glib.h>
#include <crm/crm.h>
#include <crm/stonith-ng.h>
#include <crm/fencing/internal.h>
#include <crm/common/xml.h>
#include <crm/common/mainloop.h>
#include "fencing_private.h"

Include dependency graph for st_client.c:

Data Structures
struct	timer_rec_s

Macros
#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...

gboolean	stonith__watchdog_fencing_enabled_for_node_api (stonith_t st, const char node)

gboolean	stonith__watchdog_fencing_enabled_for_node (const char *node)

xmlNode *	create_device_registration_xml (const char id, enum stonith_namespace namespace, const char agent, const 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, const stonith_key_value_t *device_list)

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 fence action into a more readable string. More...

GList *	stonith__parse_targets (const char *target_spec)

const char *	stonith__later_succeeded (const stonith_history_t event, const stonith_history_t top_history)

stonith_history_t *	stonith__sort_history (stonith_history_t *history)

const char *	stonith_op_state_str (enum op_state state)
	Return string equivalent of an operation state value. More...

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)

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

int	stonith__metadata_async (const char agent, int timeout_sec, void(callback)(int pid, const pcmk__action_result_t result, void user_data), void *user_data)

int	stonith__exit_status (const stonith_callback_data_t *data)

int	stonith__execution_status (const stonith_callback_data_t *data)

const char *	stonith__exit_reason (const stonith_callback_data_t *data)

int	stonith__event_exit_status (const stonith_event_t *event)

int	stonith__event_execution_status (const stonith_event_t *event)

const char *	stonith__event_exit_reason (const stonith_event_t *event)

char *	stonith__event_description (const stonith_event_t *event)

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

Macro Definition Documentation

◆ api_log

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

Definition at line 1974 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 1973 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 82 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,
		const stonith_key_value_t *	params,
		const char *	rsc_provides
	)

Definition at line 293 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,
		const stonith_key_value_t *	device_list
	)

Definition at line 417 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

Definition at line 2714 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 2405 of file st_client.c.

◆ stonith__event_description()

char* stonith__event_description ( const stonith_event_t * event )

Definition at line 2650 of file st_client.c.

◆ stonith__event_execution_status()

int stonith__event_execution_status ( const stonith_event_t * event )

Definition at line 2608 of file st_client.c.

◆ stonith__event_exit_reason()

const char* stonith__event_exit_reason ( const stonith_event_t * event )

Definition at line 2628 of file st_client.c.

◆ stonith__event_exit_status()

int stonith__event_exit_status ( const stonith_event_t * event )

Definition at line 2588 of file st_client.c.

◆ stonith__event_state_eq()

bool stonith__event_state_eq	(	stonith_history_t *	history,
		void *	user_data
	)

Definition at line 2393 of file st_client.c.

◆ stonith__event_state_neq()

bool stonith__event_state_neq	(	stonith_history_t *	history,
		void *	user_data
	)

Definition at line 2399 of file st_client.c.

◆ stonith__event_state_pending()

bool stonith__event_state_pending	(	stonith_history_t *	history,
		void *	user_data
	)

Definition at line 2387 of file st_client.c.

◆ stonith__execution_status()

int stonith__execution_status ( const stonith_callback_data_t * data )

Definition at line 2554 of file st_client.c.

◆ stonith__exit_reason()

const char* stonith__exit_reason ( const stonith_callback_data_t * data )

Definition at line 2571 of file st_client.c.

◆ stonith__exit_status()

int stonith__exit_status ( const stonith_callback_data_t * data )

Definition at line 2537 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 2373 of file st_client.c.

◆ stonith__later_succeeded()

const char* stonith__later_succeeded	(	const stonith_history_t *	event,
		const stonith_history_t *	top_history
	)

Definition at line 2266 of file st_client.c.

◆ stonith__metadata_async()

int stonith__metadata_async	(	const char *	agent,
		int	timeout_sec,
		void()(int pid, const pcmk__action_result_t result, void *user_data)	callback,
		void *	user_data
	)

Definition at line 2466 of file st_client.c.

◆ stonith__parse_targets()

GList* stonith__parse_targets ( const char * target_spec )

Definition at line 2222 of file st_client.c.

◆ stonith__sort_history()

stonith_history_t* stonith__sort_history ( stonith_history_t * history )

Definition at line 2306 of file st_client.c.

◆ stonith__watchdog_fencing_enabled_for_node()

gboolean stonith__watchdog_fencing_enabled_for_node ( const char * node )

Definition at line 231 of file st_client.c.

◆ stonith__watchdog_fencing_enabled_for_node_api()

gboolean stonith__watchdog_fencing_enabled_for_node_api	(	stonith_t *	st,
		const char *	node
	)

Definition at line 172 of file st_client.c.

◆ stonith_action_str()

const char* stonith_action_str ( const char * action )

Turn fence action into a more readable string.

Parameters

[in] action Fence action

Definition at line 2114 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 2083 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 1912 of file st_client.c.

◆ stonith_api_delete()

void stonith_api_delete ( stonith_t * stonith )

Definition at line 1727 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 1977 of file st_client.c.

◆ stonith_api_new()

stonith_t* stonith_api_new ( void )

Definition at line 1834 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 2019 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 809 of file st_client.c.

◆ stonith_dispatch()

bool stonith_dispatch ( stonith_t * st )

Definition at line 1667 of file st_client.c.

◆ stonith_dump_pending_callbacks()

void stonith_dump_pending_callbacks ( stonith_t * stonith )

Definition at line 1368 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 151 of file st_client.c.

◆ stonith_history_free()

void stonith_history_free ( stonith_history_t * history )

Definition at line 762 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 1933 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 1956 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 130 of file st_client.c.

◆ stonith_op_state_str()

const char* stonith_op_state_str ( enum op_state state )

Return string equivalent of an operation state value.

Parameters

[in] state Fencing operation state value

Returns: Human-friendly string equivalent of state

Definition at line 2360 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 104 of file st_client.c.

Data Structures

Macros

Typedefs

Functions

Macro Definition Documentation

◆ api_log

◆ api_log_open

Typedef Documentation

◆ stonith_callback_client_t

◆ stonith_notify_client_t

◆ stonith_op_t

◆ stonith_private_t

Function Documentation

◆ create_device_registration_xml()

◆ create_level_registration_xml()

◆ CRM_TRACE_INIT_DATA()

◆ get_stonith_provider()

◆ stonith__device_parameter_flags()

◆ stonith__event_description()

◆ stonith__event_execution_status()

◆ stonith__event_exit_reason()

◆ stonith__event_exit_status()

◆ stonith__event_state_eq()

◆ stonith__event_state_neq()

◆ stonith__event_state_pending()

◆ stonith__execution_status()

◆ stonith__exit_reason()

◆ stonith__exit_status()

◆ stonith__first_matching_event()

◆ stonith__later_succeeded()

◆ stonith__metadata_async()

◆ stonith__parse_targets()

◆ stonith__sort_history()

◆ stonith__watchdog_fencing_enabled_for_node()

◆ stonith__watchdog_fencing_enabled_for_node_api()

◆ stonith_action_str()

◆ stonith_agent_exists()

◆ stonith_api_connect_retry()

◆ stonith_api_delete()

◆ stonith_api_kick()

◆ stonith_api_new()

◆ stonith_api_time()

◆ stonith_create_op()

◆ stonith_dispatch()

◆ stonith_dump_pending_callbacks()

◆ stonith_get_namespace()

◆ stonith_history_free()

◆ stonith_key_value_add()

◆ stonith_key_value_freeall()

◆ stonith_namespace2text()

◆ stonith_op_state_str()

◆ stonith_text2namespace()