#include <crm_internal.h>
#include <crm/common/mainloop.h>
#include <crm/common/results.h>
#include <crm/common/output.h>
#include <crm/common/output_internal.h>
#include <crm/stonith-ng.h>
#include <crm/fencing/internal.h>
#include <glib.h>
#include <libxml/tree.h>
#include <pacemaker.h>
#include <pacemaker-internal.h>

Include dependency graph for pcmk_fence.c:

Functions
int	pcmk__request_fencing (stonith_t st, const char target, const char action, const char name, unsigned int timeout, unsigned int tolerance, int delay, char **reason)
	Ask the cluster to perform fencing. More...

int	pcmk__fence_history (pcmk__output_t out, stonith_t st, const char *target, unsigned int timeout, int verbose, bool broadcast, bool cleanup)
	List the fencing operations that have occurred for a specific node. More...

int	pcmk__fence_installed (pcmk__output_t out, stonith_t st, unsigned int timeout)
	List all installed fence agents. More...

int	pcmk__fence_last (pcmk__output_t out, const char target, bool as_nodeid)
	When was a device last fenced? More...

int	pcmk__fence_list_targets (pcmk__output_t out, stonith_t st, const char *device_id, unsigned int timeout)
	List nodes that can be fenced. More...

int	pcmk__fence_metadata (pcmk__output_t out, stonith_t st, const char *agent, unsigned int timeout)
	Get metadata for a fence agent. More...

int	pcmk__fence_registered (pcmk__output_t out, stonith_t st, const char *target, unsigned int timeout)
	List registered fence devices. More...

int	pcmk__fence_register_level (stonith_t st, const char target, int fence_level, const stonith_key_value_t *devices)
	Register a fencing level for a specific node, node regex, or attribute. More...

int	pcmk__fence_unregister_level (stonith_t st, const char target, int fence_level)
	Unregister a fencing level for specific node, node regex, or attribute. More...

int	pcmk__fence_validate (pcmk__output_t out, stonith_t st, const char agent, const char id, const stonith_key_value_t *params, unsigned int timeout)
	Validate a fence device configuration. More...

int	pcmk__get_fencing_history (stonith_t st, stonith_history_t *stonith_history, enum pcmk__fence_history fence_history)
	Fetch fencing history, optionally reducing it. More...

Function Documentation

◆ pcmk__fence_history()

int pcmk__fence_history	(	pcmk__output_t *	out,
		stonith_t *	st,
		const char *	target,
		unsigned int	timeout,
		int	verbose,
		bool	broadcast,
		bool	cleanup
	)

List the fencing operations that have occurred for a specific node.

Note: This is the internal version of pcmk_fence_history(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure
[in,out]	st	A connection to the fencer API
[in]	target	The node to get history for
[in]	timeout	How long to wait for operation to complete (in ms)
[in]	verbose	Include additional output
[in]	broadcast	Gather fencing history from all nodes
[in]	cleanup	Clean up fencing history after listing

Returns: Standard Pacemaker return code

Definition at line 234 of file pcmk_fence.c.

◆ pcmk__fence_installed()

int pcmk__fence_installed	(	pcmk__output_t *	out,
		stonith_t *	st,
		unsigned int	timeout
	)

List all installed fence agents.

Note: This is the internal version of pcmk_fence_installed(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure
[in,out]	st	A connection to the fencer API
[in]	timeout	How long to wait for the operation to complete (in ms)

Returns: Standard Pacemaker return code

Definition at line 329 of file pcmk_fence.c.

◆ pcmk__fence_last()

int pcmk__fence_last	(	pcmk__output_t *	out,
		const char *	target,
		bool	as_nodeid
	)

When was a device last fenced?

Note: This is the internal version of pcmk_fence_last(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure.
[in]	target	The node that was fenced.
[in]	as_nodeid

Returns: Standard Pacemaker return code

Definition at line 373 of file pcmk_fence.c.

◆ pcmk__fence_list_targets()

int pcmk__fence_list_targets	(	pcmk__output_t *	out,
		stonith_t *	st,
		const char *	device_id,
		unsigned int	timeout
	)

List nodes that can be fenced.

Note: This is the internal version of pcmk_fence_list_targets(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure
[in,out]	st	A connection to the fencer API
[in]	device_id	Resource ID of fence device to check
[in]	timeout	How long to wait for operation to complete (in ms)

Returns: Standard Pacemaker return code

Definition at line 411 of file pcmk_fence.c.

◆ pcmk__fence_metadata()

int pcmk__fence_metadata	(	pcmk__output_t *	out,
		stonith_t *	st,
		const char *	agent,
		unsigned int	timeout
	)

Get metadata for a fence agent.

Note: This is the internal version of pcmk_fence_metadata(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure
[in,out]	st	A connection to the fencer API
[in]	agent	The fence agent to get metadata for
[in]	timeout	How long to wait for the operation to complete (in ms)

Returns: Standard Pacemaker return code

Definition at line 458 of file pcmk_fence.c.

◆ pcmk__fence_register_level()

int pcmk__fence_register_level	(	stonith_t *	st,
		const char *	target,
		int	fence_level,
		const stonith_key_value_t *	devices
	)

Register a fencing level for a specific node, node regex, or attribute.

Note: This is the internal version of pcmk_fence_register_level(). External users of the pacemaker API should use that function instead.

target can take three different forms:

name=value, in which case target is an attribute.
, in which case target is a node regex.
Otherwise, target is a node name.

Parameters

[in,out]	st	A connection to the fencer API
[in]	target	The object to register a fencing level for
[in]	fence_level	Index number of level to add
[in]	devices	Devices to use in level

Returns: Standard Pacemaker return code

Definition at line 545 of file pcmk_fence.c.

◆ pcmk__fence_registered()

int pcmk__fence_registered	(	pcmk__output_t *	out,
		stonith_t *	st,
		const char *	target,
		unsigned int	timeout
	)

List registered fence devices.

Note: This is the internal version of pcmk_fence_metadata(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure
[in,out]	st	A connection to the fencer API
[in]	target	If not NULL, return only devices that can fence this
[in]	timeout	How long to wait for the operation to complete (in ms)

Returns: Standard Pacemaker return code

Definition at line 496 of file pcmk_fence.c.

◆ pcmk__fence_unregister_level()

int pcmk__fence_unregister_level	(	stonith_t *	st,
		const char *	target,
		int	fence_level
	)

Unregister a fencing level for specific node, node regex, or attribute.

Note: This is the internal version of pcmk_fence_unregister_level(). External users of the pacemaker API should use that function instead.

target can take three different forms:

name=value, in which case target is an attribute.
, in which case target is a node regex.
Otherwise, target is a node name.

Parameters

[in,out]	st	A connection to the fencer API
[in]	target	The object to unregister a fencing level for
[in]	fence_level	Index number of level to remove

Returns: Standard Pacemaker return code

Definition at line 561 of file pcmk_fence.c.

◆ pcmk__fence_validate()

int pcmk__fence_validate	(	pcmk__output_t *	out,
		stonith_t *	st,
		const char *	agent,
		const char *	id,
		const stonith_key_value_t *	params,
		unsigned int	timeout
	)

Validate a fence device configuration.

Note: This is the internal version of pcmk_stonith_validate(). External users of the pacemaker API should use that function instead.; out should be initialized with pcmk__output_new() before calling this function and destroyed with out->finish and pcmk__output_free() before reusing it with any other functions in this library.

Parameters

[in,out]	out	The output functions structure
[in,out]	st	A connection to the fencer API
[in]	agent	The agent to validate (for example, "fence_xvm")
[in]	id	Fence device ID (may be NULL)
[in]	params	Fence device configuration parameters
[in]	timeout	How long to wait for the operation to complete (in ms)

Returns: Standard Pacemaker return code

Definition at line 575 of file pcmk_fence.c.

◆ pcmk__get_fencing_history()

int pcmk__get_fencing_history	(	stonith_t *	st,
		stonith_history_t **	stonith_history,
		enum pcmk__fence_history	fence_history
	)

Fetch fencing history, optionally reducing it.

Parameters

[in,out]	st	A connection to the fencer API
[out]	stonith_history	Destination for storing the history
[in]	fence_history	How much of the fencing history to display

Returns: Standard Pacemaker return code

Definition at line 612 of file pcmk_fence.c.

◆ pcmk__request_fencing()

int pcmk__request_fencing	(	stonith_t *	st,
		const char *	target,
		const char *	action,
		const char *	name,
		unsigned int	timeout,
		unsigned int	tolerance,
		int	delay,
		char **	reason
	)

Ask the cluster to perform fencing.

Note: This is the internal version of pcmk_request_fencing(). External users of the pacemaker API should use that function instead.

Parameters

[in,out]	st	A connection to the fencer API
[in]	target	The node that should be fenced
[in]	action	The fencing action (on, off, reboot) to perform
[in]	name	Who requested the fence action?
[in]	timeout	How long to wait for operation to complete (in ms)
[in]	tolerance	If a successful action for `target` happened within this many milliseconds, return success without performing the action again
[in]	delay	Apply this delay (in milliseconds) before initiating fencing action (a value of -1 applies no delay and disables any fencing delay from pcmk_delay_base and pcmk_delay_max)
[out]	reason	If not NULL, where to put descriptive failure reason

Returns: Standard Pacemaker return code

Note: If reason is not NULL, the caller is responsible for freeing its returned value.

Todo:: delay is eventually used with g_timeout_add() and should be guint

Definition at line 187 of file pcmk_fence.c.

Variable Documentation

◆ action

const char* action

Definition at line 30 of file pcmk_fence.c.

◆ delay

int delay

Definition at line 34 of file pcmk_fence.c.

◆ name

char* name

Definition at line 31 of file pcmk_fence.c.

◆ result

pcmk__action_result_t result

Definition at line 35 of file pcmk_fence.c.

◆ st

stonith_t* st

Definition at line 28 of file pcmk_fence.c.

◆ target

const char* target

Definition at line 29 of file pcmk_fence.c.

◆ timeout

unsigned int timeout

Definition at line 32 of file pcmk_fence.c.

◆ tolerance

unsigned int tolerance

Definition at line 33 of file pcmk_fence.c.

Functions

Function Documentation

◆ pcmk__fence_history()

◆ pcmk__fence_installed()

◆ pcmk__fence_last()

◆ pcmk__fence_list_targets()

◆ pcmk__fence_metadata()

◆ pcmk__fence_register_level()

◆ pcmk__fence_registered()

◆ pcmk__fence_unregister_level()

◆ pcmk__fence_validate()

◆ pcmk__get_fencing_history()

◆ pcmk__request_fencing()

Variable Documentation

◆ action

◆ delay

◆ name

◆ result

◆ st

◆ target

◆ timeout

◆ tolerance