85 lines
2.5 KiB
C
85 lines
2.5 KiB
C
|
/* SPDX-License-Identifier: GPL-2.0 */
|
||
|
#ifndef __PERF_STRFILTER_H
|
||
|
#define __PERF_STRFILTER_H
|
||
|
/* General purpose glob matching filter */
|
||
|
|
||
|
#include <linux/list.h>
|
||
|
#include <stdbool.h>
|
||
|
|
||
|
/* A node of string filter */
|
||
|
struct strfilter_node {
|
||
|
struct strfilter_node *l; /* Tree left branche (for &,|) */
|
||
|
struct strfilter_node *r; /* Tree right branche (for !,&,|) */
|
||
|
const char *p; /* Operator or rule */
|
||
|
};
|
||
|
|
||
|
/* String filter */
|
||
|
struct strfilter {
|
||
|
struct strfilter_node *root;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* strfilter__new - Create a new string filter
|
||
|
* @rules: Filter rule, which is a combination of glob expressions.
|
||
|
* @err: Pointer which points an error detected on @rules
|
||
|
*
|
||
|
* Parse @rules and return new strfilter. Return NULL if an error detected.
|
||
|
* In that case, *@err will indicate where it is detected, and *@err is NULL
|
||
|
* if a memory allocation is failed.
|
||
|
*/
|
||
|
struct strfilter *strfilter__new(const char *rules, const char **err);
|
||
|
|
||
|
/**
|
||
|
* strfilter__or - Append an additional rule by logical-or
|
||
|
* @filter: Original string filter
|
||
|
* @rules: Filter rule to be appended at left of the root of
|
||
|
* @filter by using logical-or.
|
||
|
* @err: Pointer which points an error detected on @rules
|
||
|
*
|
||
|
* Parse @rules and join it to the @filter by using logical-or.
|
||
|
* Return 0 if success, or return the error code.
|
||
|
*/
|
||
|
int strfilter__or(struct strfilter *filter,
|
||
|
const char *rules, const char **err);
|
||
|
|
||
|
/**
|
||
|
* strfilter__add - Append an additional rule by logical-and
|
||
|
* @filter: Original string filter
|
||
|
* @rules: Filter rule to be appended at left of the root of
|
||
|
* @filter by using logical-and.
|
||
|
* @err: Pointer which points an error detected on @rules
|
||
|
*
|
||
|
* Parse @rules and join it to the @filter by using logical-and.
|
||
|
* Return 0 if success, or return the error code.
|
||
|
*/
|
||
|
int strfilter__and(struct strfilter *filter,
|
||
|
const char *rules, const char **err);
|
||
|
|
||
|
/**
|
||
|
* strfilter__compare - compare given string and a string filter
|
||
|
* @filter: String filter
|
||
|
* @str: target string
|
||
|
*
|
||
|
* Compare @str and @filter. Return true if the str match the rule
|
||
|
*/
|
||
|
bool strfilter__compare(struct strfilter *filter, const char *str);
|
||
|
|
||
|
/**
|
||
|
* strfilter__delete - delete a string filter
|
||
|
* @filter: String filter to delete
|
||
|
*
|
||
|
* Delete @filter.
|
||
|
*/
|
||
|
void strfilter__delete(struct strfilter *filter);
|
||
|
|
||
|
/**
|
||
|
* strfilter__string - Reconstruct a rule string from filter
|
||
|
* @filter: String filter to reconstruct
|
||
|
*
|
||
|
* Reconstruct a rule string from @filter. This will be good for
|
||
|
* debug messages. Note that returning string must be freed afterward.
|
||
|
*/
|
||
|
char *strfilter__string(struct strfilter *filter);
|
||
|
|
||
|
#endif
|