RPM pattern matching. More...

#include <rpmiotypes.h>
#include <fnmatch.h>

Include dependency graph for mire.h:

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

Defines
#define	mireUnlink(_mire) (miRE)rpmioUnlinkPoolItem((rpmioItem)_mire, __FUNCTION__, __FILE__, __LINE__)
#define	mireLink(_mire) (miRE)rpmioLinkPoolItem((rpmioItem)_mire, __FUNCTION__, __FILE__, __LINE__)
#define	mireFree(_mire) (miRE)rpmioFreePoolItem((rpmioItem)_mire, __FUNCTION__, __FILE__, __LINE__)
Typedefs
typedef enum mireEL_e	mireEL_t
	Line ending types.
typedef struct miRE_s *	miRE
typedef enum rpmMireMode_e	rpmMireMode
	Tag value pattern match mode.
Enumerations
enum	mireEL_e { EL_LF, EL_CR, EL_CRLF, EL_ANY, EL_ANYCRLF }
	Line ending types. More...
enum	rpmMireMode_e { RPMMIRE_DEFAULT = 0, RPMMIRE_STRCMP = 1, RPMMIRE_REGEX = 2, RPMMIRE_GLOB = 3, RPMMIRE_PCRE = 4 }
	Tag value pattern match mode. More...
Functions
int	mireClean (miRE mire)
	Deallocate pattern match memory.
miRE	mireGetPool (rpmioPool pool)
	Allocate a miRE container from the pool.
miRE	mireUnlink (miRE mire)
	Unreference a pattern container instance.
miRE	mireLink (miRE mire)
	Reference a pattern container instance.
miRE	mireFree (miRE mire)
	Free pattern container.
void *	mireFreeAll (miRE mire, int nmire)
	Destroy compiled patterns.
miRE	mireNew (rpmMireMode mode, int tag)
	Create pattern container.
int	mireSetCOptions (miRE mire, rpmMireMode mode, int tag, int options, const unsigned char *table)
	Initialize pattern compile options.
int	mireSetEOptions (miRE mire, int *offsets, int noffsets)
	Initialize pattern execute options (PCRE only).
int	mireSetGOptions (const char *newline, int caseless, int multiline, int utf8)
	Initialize pattern global options (PCRE only).
int	mireSetLocale (miRE mire, const char *locale)
	Compile locale-specific PCRE tables.
int	mireRegcomp (miRE mire, const char *pattern)
	Compile pattern match.
int	mireRegexec (miRE mire, const char *val, size_t vallen)
	Execute pattern match.
int	mireAppend (rpmMireMode mode, int tag, const char pattern, const unsigned char table, miRE mirep, int nmirep)
	Append pattern to array.
int	mireLoadPatterns (rpmMireMode mode, int tag, const char *patterns, const unsigned char table, miRE mirep, int nmirep)
	Load patterns from string array.
int	mireApply (miRE mire, int nmire, const char *s, size_t slen, int rc)
	Apply array of patterns to a string.
int	mireStudy (miRE mire, int nmires)
	Study PCRE patterns (if any).
Variables
int	_mire_debug
rpmioPool	_mirePool
const unsigned char *	_mirePCREtables
mireEL_t	_mireEL
int	_mireSTRINGoptions
	STRING default: 0.
int	_mireGLOBoptions
	GLOB default: FNM_PATHNAME \| FNM_PERIOD.
int	_mireREGEXoptions
	REGEX default: REG_EXTENDED.
int	_mirePCREoptions
	PCRE default: 0.

Detailed Description

RPM pattern matching.

Definition in file mire.h.

Define Documentation

#define mireFree ( _mire ) (miRE)rpmioFreePoolItem((rpmioItem)_mire, __FUNCTION__, __FILE__, __LINE__)

Definition at line 181 of file mire.h.

#define mireLink ( _mire ) (miRE)rpmioLinkPoolItem((rpmioItem)_mire, __FUNCTION__, __FILE__, __LINE__)

Definition at line 169 of file mire.h.

#define mireUnlink ( _mire ) (miRE)rpmioUnlinkPoolItem((rpmioItem)_mire, __FUNCTION__, __FILE__, __LINE__)

Definition at line 158 of file mire.h.

Typedef Documentation

typedef struct miRE_s* miRE

Definition at line 60 of file mire.h.

typedef enum mireEL_e mireEL_t

Line ending types.

typedef enum rpmMireMode_e rpmMireMode

Tag value pattern match mode.

Enumeration Type Documentation

enum mireEL_e

Line ending types.

Enumerator:

EL_LF
EL_CR
EL_CRLF
EL_ANY
EL_ANYCRLF

Definition at line 37 of file mire.h.

enum rpmMireMode_e

Tag value pattern match mode.

Enumerator:

RPMMIRE_DEFAULT	posix regex with \., .* and ^...$ added
RPMMIRE_STRCMP	strings using strcmp(3)
RPMMIRE_REGEX	posix regex(7) patterns using regcomp(3)
RPMMIRE_GLOB	glob(7) patterns using fnmatch(3)
RPMMIRE_PCRE	pcre patterns using pcre_compile2(3)

Definition at line 65 of file mire.h.

Function Documentation

int mireAppend	(	rpmMireMode	mode,
		int	tag,
		const char *	pattern,
		const unsigned char *	table,
		miRE *	mirep,
		int *	nmirep
	)

Append pattern to array.

Parameters:

mode	type of pattern match
tag	identifier (like an rpmTag)
pattern	pattern to compile
table	(PCRE) locale table to use (NULL uses default table)

Return values:

*mirep	pattern array
*nmirep	no. of patterns in array

Definition at line 489 of file mire.c.

References mireGetPool(), mireRegcomp(), mireSetCOptions(), and xrealloc().

Referenced by mireLoadPatterns(), rpmdbTriggerGlobs(), rpmfcExpandRegexps(), rpmPlatform(), and strsubFormat().

int mireApply	(	miRE	mire,
		int	nmire,
		const char *	s,
		size_t	slen,
		int	rc
	)

Apply array of patterns to a string.

Parameters:

mire	compiled pattern array
nmire	no. of patterns in array
s	string to apply against
slen	length of string (0 will use strlen(s))
rc	-1 == excluding, +1 == including, 0 == single pattern

Returns:: termination condition

Definition at line 543 of file mire.c.

References mireRegexec().

Referenced by grep_or_recurse(), and rpmrepoGetFileList().

int mireClean ( miRE mire )

Deallocate pattern match memory.

Parameters:

mire	pattern container

Returns:: 0 on success

Definition at line 38 of file mire.c.

References _free(), _mire_debug, RPMMIRE_PCRE, and RPMMIRE_REGEX.

Referenced by handleOneTrigger(), mireFini(), mireFreeAll(), and mireRegcomp().

miRE mireFree ( miRE mire )

Free pattern container.

Parameters:

mire	pattern container

Returns:: NULL on last derefernce

Referenced by dbiMireKeys(), handleOneTrigger(), rpmcliFini(), rpmcliInstallElementPath(), rpmfcApply(), rpmfcExpandRegexps(), rpmfcSCRIPT(), rpmmiAddPattern(), and tagValidate().

void* mireFreeAll	(	miRE	mire,
		int	nmire
	)

Destroy compiled patterns.

Parameters:

mire	pattern array
nre	no of patterns in array

Returns:: NULL always

Definition at line 95 of file mire.c.

References _free(), mireClean(), and rpmioFreePoolItem().

Referenced by rpmdsFini(), rpmfcFreeRegexps(), rpmfiFini(), rpmFreeRpmrc(), rpmmiFini(), rpmPlatform(), rpmrepoFini(), runTriggers(), and strsubFormat().

miRE mireGetPool ( rpmioPool pool )

Allocate a miRE container from the pool.

Parameters:

pool mire pool

Returns:: miRE container

Definition at line 80 of file mire.c.

References _mire_debug, _mirePool, mireFini(), rpmioGetPool(), and rpmioNewPool().

Referenced by mireAppend(), mireNew(), and rpmmiAddPattern().

miRE mireLink ( miRE mire )

Reference a pattern container instance.

Parameters:

mire	pattern container

Returns:: new pattern container reference

Referenced by mireNew(), and rpmmiAddPattern().

int mireLoadPatterns	(	rpmMireMode	mode,
		int	tag,
		const char **	patterns,
		const unsigned char *	table,
		miRE *	mirep,
		int *	nmirep
	)

Load patterns from string array.

Parameters:

mode	type of pattern match
tag	identifier (like an rpmTag)
patterns	patterns to compile
table	(PCRE) locale table to use (NULL uses default table)

Return values:

*mirep	pattern array
*nmirep	no. of patterns in array

Returns:: 0 on success

Definition at line 521 of file mire.c.

References mireAppend().

Referenced by main().

miRE mireNew	(	rpmMireMode	mode,
		int	tag
	)

Create pattern container.

Parameters:

mode	type of pattern match
tag	identifier (e.g. an rpmTag)

Returns:: new pattern container (NULL on error)

Definition at line 110 of file mire.c.

References mireGetPool(), and mireLink().

Referenced by dbiMireKeys(), handleOneTrigger(), rpmcliInstallElementPath(), rpmEVRmire(), rpmfcApply(), rpmfcSCRIPT(), rpmmiAddPattern(), and tagValidate().

int mireRegcomp	(	miRE	mire,
		const char *	pattern
	)

Compile pattern match.

Parameters:

mire	pattern container
val	pattern to compile

Returns:: 0 on success

Definition at line 331 of file mire.c.

References _, _mire_debug, _mireGLOBoptions, _mireREGEXoptions, mireClean(), rpmlog(), RPMLOG_ERR, RPMMIRE_DEFAULT, RPMMIRE_GLOB, RPMMIRE_PCRE, RPMMIRE_REGEX, RPMMIRE_STRCMP, xcalloc(), and xstrdup().

Referenced by compile_single_pattern(), dbiMireKeys(), handleOneTrigger(), mireAppend(), rpmcliInstallElementPath(), rpmEVRmire(), rpmfcApply(), rpmfcSCRIPT(), rpmmiAddPattern(), and tagValidate().

int mireRegexec	(	miRE	mire,
		const char *	val,
		size_t	vallen
	)

Execute pattern match.

Parameters:

mire	pattern container
val	value to match
vallen	length of value string (0 will use strlen)

Returns:: >=0 if pattern matches, -1 on nomatch, else error

Definition at line 395 of file mire.c.

References _, _mire_debug, alloca(), FNM_NOMATCH, fnmatch(), rpmlog(), RPMLOG_ERR, RPMMIRE_DEFAULT, RPMMIRE_GLOB, RPMMIRE_PCRE, RPMMIRE_REGEX, and RPMMIRE_STRCMP.

Referenced by dbiMireKeys(), handleOneTrigger(), mireApply(), mireSkip(), pcregrep(), rpmcliWalkFirst(), rpmEVRparse(), rpmfcApply(), rpmfcMatchRegexps(), rpmfcSCRIPT(), rpmGetMacroEntries(), rpmPlatformScore(), runTriggersLoop(), strsubFormat(), and tagValidate().

int mireSetCOptions	(	miRE	mire,
		rpmMireMode	mode,
		int	tag,
		int	options,
		const unsigned char *	table
	)

Initialize pattern compile options.

Parameters:

mire	pattern container
mode	type of pattern match
tag	identifier (e.g. an rpmTag)
options	pattern options (0 uses default options)
table	(PCRE only) locale tables