Macro API.

Macro API. More...

Functions
void	rpmDumpMacroTable (rpmMacroContext mc, FILE *fp)
	Print macros to file stream. More...
int	rpmExpandMacros (rpmMacroContext mc, const char *sbuf, char **obuf, int flags)
	Expand macro into buffer. More...
int	rpmExpandThisMacro (rpmMacroContext mc, const char *n, ARGV_const_t args, char **obuf, int flags)
	Expand a specific macro into buffer. More...
int	rpmPushMacro (rpmMacroContext mc, const char *n, const char *o, const char *b, int level)
	Push macro to context. More...
int	rpmPushMacroFlags (rpmMacroContext mc, const char *n, const char *o, const char *b, int level, rpmMacroFlags flags)
	Push macro to context. More...
int	rpmPopMacro (rpmMacroContext mc, const char *n)
	Pop macro from context. More...
int	rpmDefineMacro (rpmMacroContext mc, const char *macro, int level)
	Define macro in context. More...
void	rpmLoadMacros (rpmMacroContext mc, int level)
	Load macros from specific context into global context. More...
int	rpmLoadMacroFile (rpmMacroContext mc, const char *fn)
	Load macro context from a macro file. More...
void	rpmInitMacros (rpmMacroContext mc, const char *macrofiles)
	Initialize macro context from set of macrofile(s). More...
void	rpmFreeMacros (rpmMacroContext mc)
	Destroy macro context. More...
char *	rpmExpand (const char *arg,...) RPM_GNUC_NULL_TERMINATED
	Return (malloc'ed) concatenated macro expansion(s). More...
int	rpmExpandNumeric (const char *arg)
	Return macro expansion as a numeric value. More...
const char *	rpmConfigDir (void)
	Return rpm configuration base directory. More...
int	rpmExprBoolFlags (const char *expr, int flags)
	Evaluate boolean expression. More...
char *	rpmExprStrFlags (const char *expr, int flags)
	Evaluate string expression. More...
int	rpmExprBool (const char *expr)
	Evaluate boolean expression. More...
char *	rpmExprStr (const char *expr)
	Evaluate string expression. More...

Detailed Description

Macro API.

Function Documentation

rpmConfigDir()

const char* rpmConfigDir

(

void

)

Return rpm configuration base directory.

If RPM_CONFIGDIR environment variable is set, it's value will be used. Otherwise the configuration directory is the one set at build time, typically /usr/lib/rpm. The value of rpmConfigDir() is determined on first call to this function and is guaranteed to remain the same on subsequent calls.

Returns

rpm configuration directory name

rpmDefineMacro()

int rpmDefineMacro	(	rpmMacroContext	mc,
		const char *	macro,
		int	level
	)

Define macro in context.

Parameters

mc	macro context (NULL uses global context).
macro	macro name, options, body
level	macro recursion level (0 is entry API)

Returns

0 on success (always)

rpmDumpMacroTable()

void rpmDumpMacroTable	(	rpmMacroContext	mc,
		FILE *	fp
	)

Print macros to file stream.

Parameters

mc	macro context (NULL uses global context).
fp	file stream (NULL uses stderr).

rpmExpand()

char* rpmExpand	(	const char *	arg,
			...
	)

Return (malloc'ed) concatenated macro expansion(s).

Parameters

arg	macro(s) to expand (NULL terminates list)

Returns

macro expansion (malloc'ed)

rpmExpandMacros()

int rpmExpandMacros	(	rpmMacroContext	mc,
		const char *	sbuf,
		char **	obuf,
		int	flags
	)

Expand macro into buffer.

Parameters

mc	macro context (NULL uses global context).
sbuf	input macro to expand
obuf	macro expansion (malloc'ed)
flags	flags (currently unused)

Returns

negative on failure

rpmExpandNumeric()

int rpmExpandNumeric

(

const char *

arg

)

Return macro expansion as a numeric value.

Boolean values ('Y' or 'y' returns 1, 'N' or 'n' returns 0) are permitted as well. An undefined macro returns 0.

Parameters

arg	macro to expand

Returns

numeric value

rpmExpandThisMacro()

int rpmExpandThisMacro	(	rpmMacroContext	mc,
		const char *	n,
		ARGV_const_t	args,
		char **	obuf,
		int	flags
	)

Expand a specific macro into buffer.

Parameters

mc	macro context (NULL uses global context).
n	macro name
args	arguments for parametric macros
obuf	macro expansion (malloc'ed)
flags	flags (currently unused)

Returns

negative on failure

rpmExprBool()

int rpmExprBool

(

const char *

expr

)

Evaluate boolean expression.

Parameters

expr	expression to parse

Returns

rpmExprBoolFlags()

int rpmExprBoolFlags	(	const char *	expr,
		int	flags
	)

Evaluate boolean expression.

Parameters

expr	expression to parse
flags	parser flags

Returns

rpmExprStr()

char* rpmExprStr

(

const char *

expr

)

Evaluate string expression.

Parameters

expr	expression to parse

Returns

rpmExprStrFlags()

char* rpmExprStrFlags	(	const char *	expr,
		int	flags
	)

Evaluate string expression.

Parameters

expr	expression to parse
flags	parser flags

Returns

rpmFreeMacros()

void rpmFreeMacros

(

rpmMacroContext

mc

)

Destroy macro context.

Parameters

mc	macro context (NULL uses global context).

rpmInitMacros()

void rpmInitMacros	(	rpmMacroContext	mc,
		const char *	macrofiles
	)

Initialize macro context from set of macrofile(s).

Parameters

mc	macro context
macrofiles	colon separated list of macro files (NULL does nothing)

rpmLoadMacroFile()

int rpmLoadMacroFile	(	rpmMacroContext	mc,
		const char *	fn
	)

Load macro context from a macro file.

Parameters

mc	(unused)
fn	macro file name

rpmLoadMacros()

void rpmLoadMacros	(	rpmMacroContext	mc,
		int	level
	)

Load macros from specific context into global context.

Parameters

mc	macro context (NULL does nothing).
level	macro recursion level (0 is entry API)

rpmPopMacro()

int rpmPopMacro	(	rpmMacroContext	mc,
		const char *	n
	)

Pop macro from context.

Parameters

mc	macro context (NULL uses global context).
n	macro name

Returns

0 on success

rpmPushMacro()

int rpmPushMacro	(	rpmMacroContext	mc,
		const char *	n,
		const char *	o,
		const char *	b,
		int	level
	)

Push macro to context.

Parameters

mc	macro context (NULL uses global context).
n	macro name
o	macro parameters
b	macro body
level	macro recursion level (0 is entry API)

Returns

0 on success

rpmPushMacroFlags()

int rpmPushMacroFlags	(	rpmMacroContext	mc,
		const char *	n,
		const char *	o,
		const char *	b,
		int	level,
		rpmMacroFlags	flags
	)

Push macro to context.

Parameters

mc	macro context (NULL uses global context).
n	macro name
o	macro parameters
b	macro body
level	macro recursion level (0 is entry API)
flags	macro flags

Returns

0 on success