Macro API.

Macro API. More...

Functions
RPM_PUBLIC_API void	rpmDumpMacroTable (rpmMacroContext mc, FILE *fp)
RPM_PUBLIC_API int	rpmExpandMacros (rpmMacroContext mc, const char *sbuf, char **obuf, int flags)
RPM_PUBLIC_API int	rpmExpandThisMacro (rpmMacroContext mc, const char *n, ARGV_const_t args, char **obuf, int flags)
RPM_PUBLIC_API int	rpmPushMacro (rpmMacroContext mc, const char *n, const char *o, const char *b, int level)
RPM_PUBLIC_API int	rpmPushMacroFlags (rpmMacroContext mc, const char *n, const char *o, const char *b, int level, rpmMacroFlags flags)
RPM_PUBLIC_API int	rpmPushMacroAux (rpmMacroContext mc, const char *n, const char *o, macroFunc f, void *priv, int nargs, int level, rpmMacroFlags flags)
RPM_PUBLIC_API void *	rpmMacroEntryPriv (rpmMacroEntry me)
RPM_PUBLIC_API void	rpmMacroBufAppend (rpmMacroBuf mb, char c)
RPM_PUBLIC_API void	rpmMacroBufAppendStr (rpmMacroBuf mb, const char *str)
RPM_PUBLIC_API void	rpmMacroBufErr (rpmMacroBuf mb, int error, const char *fmt,...)
RPM_PUBLIC_API int	rpmPopMacro (rpmMacroContext mc, const char *n)
RPM_PUBLIC_API int	rpmDefineMacro (rpmMacroContext mc, const char *macro, int level)
RPM_PUBLIC_API int	rpmUndefineMacro (rpmMacroContext mc, const char *n)
RPM_PUBLIC_API void	rpmLoadMacros (rpmMacroContext mc, int level)
RPM_PUBLIC_API int	rpmLoadMacroFile (rpmMacroContext mc, const char *fn)
RPM_PUBLIC_API void	rpmInitMacros (rpmMacroContext mc, const char *macrofiles)
RPM_PUBLIC_API void	rpmFreeMacros (rpmMacroContext mc)
RPM_PUBLIC_API char *	rpmExpand (const char *arg,...) RPM_GNUC_NULL_TERMINATED
RPM_PUBLIC_API int	rpmExpandNumeric (const char *arg)
RPM_PUBLIC_API const char *	rpmConfigDir (void)
RPM_PUBLIC_API int	rpmExprBoolFlags (const char *expr, int flags)
RPM_PUBLIC_API char *	rpmExprStrFlags (const char *expr, int flags)
RPM_PUBLIC_API int	rpmExprBool (const char *expr)
RPM_PUBLIC_API char *	rpmExprStr (const char *expr)

Detailed Description

Macro API.

Function Documentation

rpmConfigDir()

RPM_PUBLIC_API 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()

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

Define macro in context. Subject to the same sanity checks as using the define macro.

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

rpmDumpMacroTable()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API int rpmExprBool

(

const char *

expr

)

Evaluate boolean expression.

Parameters

expr	expression to parse

Returns

rpmExprBoolFlags()

RPM_PUBLIC_API int rpmExprBoolFlags	(	const char *	expr,
		int	flags )

Evaluate boolean expression.

Parameters

expr	expression to parse
flags	parser flags

Returns

rpmExprStr()

RPM_PUBLIC_API char * rpmExprStr

(

const char *

expr

)

Evaluate string expression.

Parameters

expr	expression to parse

Returns

rpmExprStrFlags()

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

Evaluate string expression.

Parameters

expr	expression to parse
flags	parser flags

Returns

rpmFreeMacros()

RPM_PUBLIC_API void rpmFreeMacros

(

rpmMacroContext

mc

)

Destroy macro context.

Parameters

mc	macro context (NULL uses global context).

rpmInitMacros()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API int rpmLoadMacroFile	(	rpmMacroContext	mc,
		const char *	fn )

Load macro context from a macro file.

Parameters

mc	(unused)
fn	macro file name

rpmLoadMacros()

RPM_PUBLIC_API 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)

rpmMacroBufAppend()

RPM_PUBLIC_API void rpmMacroBufAppend	(	rpmMacroBuf	mb,
		char	c )

Append a character to macro buffer (in aux macro)

Parameters

mb	macro buffer
c	character to append

rpmMacroBufAppendStr()

RPM_PUBLIC_API void rpmMacroBufAppendStr	(	rpmMacroBuf	mb,
		const char *	str )

Append a string to macro buffer (in aux macro)

Parameters

mb	macro buffer
str	string to append

rpmMacroBufErr()

RPM_PUBLIC_API void rpmMacroBufErr	(	rpmMacroBuf	mb,
		int	error,
		const char *	fmt,
			... )

Raise an error or warning in macro buffer (in aux macro)

Parameters

mb	macro buffer
error	1 if error, 0 if warning
fmt	j

rpmMacroEntryPriv()

RPM_PUBLIC_API void * rpmMacroEntryPriv

(

rpmMacroEntry

me

)

Return macro entry user data (in aux macro)

Parameters

me	macro entry

Returns

pointer to private data passed on define or NULL

rpmPopMacro()

RPM_PUBLIC_API 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()

RPM_PUBLIC_API 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

rpmPushMacroAux()

RPM_PUBLIC_API int rpmPushMacroAux	(	rpmMacroContext	mc,
		const char *	n,
		const char *	o,
		macroFunc	f,
		void *	priv,
		int	nargs,
		int	level,
		rpmMacroFlags	flags )

Push an auxiliary macro to context.

Parameters

mc	macro context (NULL uses global context).
n	macro name
o	macro parameters (or NULL)
f	macro function
priv	private user data (or NULL)
nargs	number of arguments (0-N for enforced check, -1 for optional)
level	macro recursion level (0 is entry API)
flags	macro flags

Returns

0 on success

rpmPushMacroFlags()

RPM_PUBLIC_API 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

rpmUndefineMacro()

RPM_PUBLIC_API int rpmUndefineMacro	(	rpmMacroContext	mc,
		const char *	n )

Undefine macro in context. Subject to the same sanity checks as using the undefine macro.

Parameters

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

Returns

0 on success