Utility functions. More...

#include <sys/types.h>
#include <stdlib.h>
#include <stdbool.h>
#include <stdint.h>
#include <limits.h>
#include <signal.h>
#include <glib.h>
#include <libxml/tree.h>
#include <crm/lrmd.h>
#include <crm/common/acl.h>
#include <crm/common/agents.h>
#include <crm/common/results.h>
#include <crm/common/util_compat.h>

Include dependency graph for util.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	ONLINESTATUS "online"

#define	OFFLINESTATUS "offline"

#define	CRM_DEFAULT_OP_TIMEOUT_S "20s"

#define	pcmk_is_set(g, f) pcmk_all_flags_set((g), (f))
	Convenience alias for pcmk_all_flags_set(), to check single flag. More...

Functions
char *	pcmk_promotion_score_name (const char *rsc_id)
	Return the name of the node attribute used as a promotion score. More...

int	crm_default_remote_port (void)
	Get the default remote connection TCP port on this host. More...

int	char2score (const char *score)
	Get the integer value of a score string. More...

char *	score2char (int score)
	Return the string equivalent of an integer score. More...

char *	score2char_stack (int score, char *buf, size_t len)
	Convert an integer score to a string, using a provided buffer. More...

int	pcmk__add_scores (int score1, int score2)

gboolean	crm_is_true (const char *s)

int	crm_str_to_boolean (const char s, int ret)

long long	crm_get_msec (const char *input)
	Parse a time+units string and return milliseconds equivalent. More...

char *	crm_strip_trailing_newline (char *str)

char *	crm_strdup_printf (char const *format,...) G_GNUC_PRINTF(1

char guint	crm_parse_interval_spec (const char *input)
	Parse milliseconds from a Pacemaker interval specification. More...

gboolean	parse_op_key (const char key, char rsc_id, char op_type, guint interval_ms)

gboolean	decode_transition_key (const char key, char uuid, int transition_id, int action_id, int target_rc)
	Parse a transition key into its constituent parts. More...

gboolean	decode_transition_magic (const char magic, char uuid, int transition_id, int action_id, int op_status, int op_rc, int target_rc)
	Parse a transition magic string into its constituent parts. More...

int	rsc_op_expected_rc (lrmd_event_data_t *event)

gboolean	did_rsc_op_fail (lrmd_event_data_t *event, int target_rc)

bool	crm_op_needs_metadata (const char rsc_class, const char op)
	Check whether an operation requires resource agent meta-data. More...

xmlNode *	crm_create_op_xml (xmlNode parent, const char prefix, const char task, const char interval_spec, const char *timeout)
	Create a CIB XML element for an operation. More...

bool	pcmk_is_probe (const char *task, guint interval)

bool	pcmk_xe_is_probe (xmlNode *xml_op)

bool	pcmk_xe_mask_probe_failure (xmlNode *xml_op)

int	compare_version (const char version1, const char version2)

void	crm_abort (const char file, const char function, int line, const char *condition, gboolean do_core, gboolean do_fork)

char *	crm_meta_name (const char *field)

const char *	crm_meta_value (GHashTable hash, const char field)

char *	crm_md5sum (const char *buffer)

char *	crm_generate_uuid (void)

bool	crm_is_daemon_name (const char *name)
	Check whether string represents a client name used by cluster daemons. More...

int	crm_user_lookup (const char name, uid_t uid, gid_t *gid)

int	pcmk_daemon_user (uid_t uid, gid_t gid)
	Get user and group IDs of pacemaker daemon user. More...

char *	pcmk_hostname (void)
	Get the local hostname. More...

bool	pcmk_str_is_infinity (const char *s)

bool	pcmk_str_is_minus_infinity (const char *s)

Detailed Description

Utility functions.

Definition in file util.h.

Macro Definition Documentation

◆ CRM_DEFAULT_OP_TIMEOUT_S

#define CRM_DEFAULT_OP_TIMEOUT_S "20s"

Definition at line 77 of file util.h.

◆ OFFLINESTATUS

#define OFFLINESTATUS "offline"

Definition at line 40 of file util.h.

◆ ONLINESTATUS

#define ONLINESTATUS "online"

Definition at line 39 of file util.h.

◆ pcmk_is_set

#define pcmk_is_set	(	g,
		f
	)	pcmk_all_flags_set((g), (f))

Convenience alias for pcmk_all_flags_set(), to check single flag.

Definition at line 122 of file util.h.

Function Documentation

◆ char2score()

int char2score ( const char * score )

Get the integer value of a score string.

Given a string representation of a score, return the integer equivalent. This accepts infinity strings as well as red, yellow, and green, and bounds the result to +/-INFINITY.

Parameters

[in] score Score as string

Returns: Integer value corresponding to score

Definition at line 36 of file scores.c.

◆ compare_version()

int compare_version	(	const char *	version1,
		const char *	version2
	)

Definition at line 160 of file utils.c.

◆ crm_abort()

void crm_abort	(	const char *	file,
		const char *	function,
		int	line,
		const char *	condition,
		gboolean	do_core,
		gboolean	do_fork
	)

Definition at line 368 of file utils.c.

◆ crm_create_op_xml()

xmlNode* crm_create_op_xml	(	xmlNode *	parent,
		const char *	prefix,
		const char *	task,
		const char *	interval_spec,
		const char *	timeout
	)

Create a CIB XML element for an operation.

Parameters

[in]	parent	If not NULL, make new XML node a child of this one
[in]	prefix	Generate an ID using this prefix
[in]	task	Operation task to set
[in]	interval_spec	Operation interval to set
[in]	timeout	If not NULL, operation timeout to set

Returns: New XML object on success, NULL otherwise

Definition at line 474 of file operations.c.

◆ crm_default_remote_port()

int crm_default_remote_port ( void )

Get the default remote connection TCP port on this host.

Returns: Remote connection TCP port number

Definition at line 1249 of file remote.c.

◆ crm_generate_uuid()

char* crm_generate_uuid ( void )

Definition at line 480 of file utils.c.

◆ crm_get_msec()

long long crm_get_msec ( const char * input )

Parse a time+units string and return milliseconds equivalent.

Parameters

[in] input String with a number and optional unit (optionally with whitespace before and/or after the number). If missing, the unit defaults to seconds.

Returns: Milliseconds corresponding to string expression, or PCMK__PARSE_INT_DEFAULT on error

Definition at line 364 of file strings.c.

◆ crm_is_daemon_name()

bool crm_is_daemon_name ( const char * name )

Check whether string represents a client name used by cluster daemons.

Parameters

[in] name String to check

Returns: true if name is standard client name used by daemons, false otherwise

Note: This is provided by the client, and so cannot be used by itself as a secure means of authentication.

Definition at line 995 of file ipc_server.c.

◆ crm_is_true()

gboolean crm_is_true ( const char * s )

Definition at line 416 of file strings.c.

◆ crm_md5sum()

char* crm_md5sum ( const char * buffer )

Definition at line 271 of file digest.c.

◆ crm_meta_name()

char* crm_meta_name ( const char * field )

Definition at line 439 of file utils.c.

◆ crm_meta_value()

const char* crm_meta_value	(	GHashTable *	hash,
		const char *	field
	)

Definition at line 461 of file utils.c.

◆ crm_op_needs_metadata()

bool crm_op_needs_metadata	(	const char *	rsc_class,
		const char *	op
	)

Check whether an operation requires resource agent meta-data.

Parameters

[in]	rsc_class	Resource agent class (or NULL to skip class check)
[in]	op	Operation action (or NULL to skip op check)

Returns: TRUE if operation needs meta-data, FALSE otherwise

Note: At least one of rsc_class and op must be specified.

Definition at line 501 of file operations.c.

◆ crm_parse_interval_spec()

char guint crm_parse_interval_spec ( const char * input )

Parse milliseconds from a Pacemaker interval specification.

Parameters

[in] input Pacemaker time interval specification (a bare number of seconds, a number with a unit optionally with whitespace before and/or after the number, or an ISO 8601 duration)

Returns: Milliseconds equivalent of given specification on success (limited to the range of an unsigned integer), 0 if input is NULL, or 0 (and set errno to EINVAL) on error

Definition at line 242 of file utils.c.

◆ crm_str_to_boolean()

int crm_str_to_boolean	(	const char *	s,
		int *	ret
	)

Definition at line 427 of file strings.c.

◆ crm_strdup_printf()

char* crm_strdup_printf	(	char const *	format,
			...
	)

◆ crm_strip_trailing_newline()

char* crm_strip_trailing_newline ( char * str )

Definition at line 1317 of file strings.c.

◆ crm_user_lookup()

int crm_user_lookup	(	const char *	name,
		uid_t *	uid,
		gid_t *	gid
	)

Definition at line 57 of file utils.c.

◆ decode_transition_key()

gboolean decode_transition_key	(	const char *	key,
		char **	uuid,
		int *	transition_id,
		int *	action_id,
		int *	target_rc
	)

Parse a transition key into its constituent parts.

Parameters

[in]	key	Transition key to parse (must be non-NULL)
[out]	uuid	If non-NULL, where to store copy of parsed UUID
[out]	transition_id	If non-NULL, where to store parsed transition ID
[out]	action_id	If non-NULL, where to store parsed action ID
[out]	target_rc	If non-NULL, where to stored parsed target rc

Returns: TRUE if key was valid, FALSE otherwise

Note: If uuid is supplied and this returns TRUE, the caller is responsible for freeing the memory for *uuid using free().

Definition at line 318 of file operations.c.

◆ decode_transition_magic()

gboolean decode_transition_magic	(	const char *	magic,
		char **	uuid,
		int *	transition_id,
		int *	action_id,
		int *	op_status,
		int *	op_rc,
		int *	target_rc
	)

Parse a transition magic string into its constituent parts.

Parameters

[in]	magic	Magic string to parse (must be non-NULL)
[out]	uuid	If non-NULL, where to store copy of parsed UUID
[out]	transition_id	If non-NULL, where to store parsed transition ID
[out]	action_id	If non-NULL, where to store parsed action ID
[out]	op_status	If non-NULL, where to store parsed result status
[out]	op_rc	If non-NULL, where to store parsed actual rc
[out]	target_rc	If non-NULL, where to stored parsed target rc

Returns: TRUE if key was valid, FALSE otherwise

Note: If uuid is supplied and this returns TRUE, the caller is responsible for freeing the memory for *uuid using free().

Definition at line 255 of file operations.c.

◆ did_rsc_op_fail()

gboolean did_rsc_op_fail	(	lrmd_event_data_t *	event,
		int	target_rc
	)

Definition at line 437 of file operations.c.

◆ parse_op_key()

gboolean parse_op_key	(	const char *	key,
		char **	rsc_id,
		char **	op_type,
		guint *	interval_ms
	)

Definition at line 185 of file operations.c.

◆ pcmk__add_scores()

int pcmk__add_scores	(	int	score1,
		int	score2
	)

Definition at line 140 of file scores.c.

◆ pcmk_daemon_user()

int pcmk_daemon_user	(	uid_t *	uid,
		gid_t *	gid
	)

Get user and group IDs of pacemaker daemon user.

Parameters

[out]	uid	If non-NULL, where to store daemon user ID
[out]	gid	If non-NULL, where to store daemon group ID

Returns: pcmk_ok on success, -errno otherwise

Definition at line 97 of file utils.c.

◆ pcmk_hostname()

char* pcmk_hostname ( void )

Get the local hostname.

Returns: Newly allocated string with name, or NULL (and set errno) on error

Definition at line 505 of file utils.c.

◆ pcmk_is_probe()

bool pcmk_is_probe	(	const char *	task,
		guint	interval
	)

Definition at line 542 of file operations.c.

◆ pcmk_promotion_score_name()

char* pcmk_promotion_score_name ( const char * rsc_id )

Return the name of the node attribute used as a promotion score.

Parameters

[in] rsc_id Resource ID that promotion score is for (or NULL to check the OCF_RESOURCE_INSTANCE environment variable)

Returns: Newly allocated string with the node attribute name (or NULL on error, including no ID or environment variable specified)

Note: It is the caller's responsibility to free() the result.

Definition at line 320 of file attrd_client.c.

◆ pcmk_str_is_infinity()

bool pcmk_str_is_infinity ( const char * s )

Definition at line 513 of file utils.c.

◆ pcmk_str_is_minus_infinity()

bool pcmk_str_is_minus_infinity ( const char * s )

Definition at line 518 of file utils.c.

◆ pcmk_xe_is_probe()

bool pcmk_xe_is_probe ( xmlNode * xml_op )

Definition at line 552 of file operations.c.

◆ pcmk_xe_mask_probe_failure()

bool pcmk_xe_mask_probe_failure ( xmlNode * xml_op )

Definition at line 563 of file operations.c.

◆ rsc_op_expected_rc()

int rsc_op_expected_rc ( lrmd_event_data_t * event )

Definition at line 426 of file operations.c.

◆ score2char()

char* score2char ( int score )

Return the string equivalent of an integer score.

Return the string equivalent of a given integer score, using "INFINITY" and "-INFINITY" when appropriate.

Parameters

[in] score Integer score to convert

Returns: Newly allocated string equivalent of score

Note: The caller is responsible for freeing the return value. This function asserts on memory errors, so the return value can be assumed to be non-NULL.

Definition at line 114 of file scores.c.

◆ score2char_stack()

char* score2char_stack	(	int	score,
		char *	buf,
		size_t	len
	)

Convert an integer score to a string, using a provided buffer.

Store the string equivalent of a given integer score in a given string buffer, using "INFINITY" and "-INFINITY" when appropriate.

Parameters

[in]	score	Integer score to convert
[out]	buf	Where to store string representation of `score`
[in]	len	Size of `buf` (in bytes)

Returns: buf (or NULL if len is too small)

Definition at line 85 of file scores.c.

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ CRM_DEFAULT_OP_TIMEOUT_S

◆ OFFLINESTATUS

◆ ONLINESTATUS

◆ pcmk_is_set

Function Documentation

◆ char2score()

◆ compare_version()

◆ crm_abort()

◆ crm_create_op_xml()

◆ crm_default_remote_port()

◆ crm_generate_uuid()

◆ crm_get_msec()

◆ crm_is_daemon_name()

◆ crm_is_true()

◆ crm_md5sum()

◆ crm_meta_name()

◆ crm_meta_value()

◆ crm_op_needs_metadata()

◆ crm_parse_interval_spec()

◆ crm_str_to_boolean()

◆ crm_strdup_printf()

◆ crm_strip_trailing_newline()

◆ crm_user_lookup()

◆ decode_transition_key()

◆ decode_transition_magic()

◆ did_rsc_op_fail()

◆ parse_op_key()

◆ pcmk__add_scores()

◆ pcmk_daemon_user()

◆ pcmk_hostname()

◆ pcmk_is_probe()

◆ pcmk_promotion_score_name()

◆ pcmk_str_is_infinity()

◆ pcmk_str_is_minus_infinity()

◆ pcmk_xe_is_probe()

◆ pcmk_xe_mask_probe_failure()

◆ rsc_op_expected_rc()

◆ score2char()

◆ score2char_stack()