mirror of
https://github.com/owasp-modsecurity/ModSecurity.git
synced 2025-08-14 13:56:01 +03:00
122 lines
3.4 KiB
C
122 lines
3.4 KiB
C
/*
|
||
* ModSecurity for Apache 2.x, http://www.modsecurity.org/
|
||
* Copyright (c) 2004-2013 Trustwave Holdings, Inc. (http://www.trustwave.com/)
|
||
*
|
||
* You may not use this file except in compliance with
|
||
* the License. You may obtain a copy of the License at
|
||
*
|
||
* http://www.apache.org/licenses/LICENSE-2.0
|
||
*
|
||
* If any of the files related to licensing are missing or if you have any
|
||
* other questions related to licensing please contact Trustwave Holdings, Inc.
|
||
* directly using the email address security@modsecurity.org.
|
||
*/
|
||
|
||
#ifndef ACMP_H_
|
||
#define ACMP_H_
|
||
|
||
#include <apr.h>
|
||
#include <apr_pools.h>
|
||
|
||
#define ACMP_FLAG_BYTE 0
|
||
#define ACMP_FLAG_CASE_SENSITIVE 1
|
||
#define ACMP_FLAG_CASE_INSENSITIVE 0
|
||
#ifdef ACMP_USE_UTF8
|
||
#define ACMP_FLAG_UTF8 0x100
|
||
#endif
|
||
|
||
/**
|
||
* Opaque struct with parser data
|
||
*/
|
||
typedef struct ACMP ACMP;
|
||
|
||
/**
|
||
* Used to separate state from the trie for acmp_process_quick function
|
||
*/
|
||
typedef struct {
|
||
ACMP *parser;
|
||
void *ptr;
|
||
} ACMPT;
|
||
|
||
/**
|
||
* Callback function. Arguments are:
|
||
* ACMP * - acmp parser that initiated callback
|
||
* void * - custom data you supplied when adding callback
|
||
* apr_size_t - position in bytes where pattern was found
|
||
* apr_size_t - position in chars where pattern was found, for multibyte strings
|
||
*/
|
||
typedef void (*acmp_callback_t)(ACMP *, void *, apr_size_t, apr_size_t);
|
||
|
||
/**
|
||
* flags - OR-ed values of ACMP_FLAG constants
|
||
* pool - apr_pool to use as parent pool, can be set to NULL
|
||
*/
|
||
ACMP *acmp_create(int flags, apr_pool_t *pool);
|
||
|
||
/**
|
||
* Destroys previously created parser
|
||
*/
|
||
void acmp_destroy(ACMP *parser);
|
||
|
||
/**
|
||
* Creates parser with same options and same patterns
|
||
* parser - ACMP parser to duplicate
|
||
* pool - parent pool to use, if left as NULL original parser's parent pool is used
|
||
*/
|
||
ACMP *acmp_duplicate(ACMP *parser, apr_pool_t *pool);
|
||
|
||
/**
|
||
* Adds pattern to parser. Cannot be done after starting the search.
|
||
* parser - ACMP parser
|
||
* pattern - string with pattern to match
|
||
* callback - Optional, pointer to an acmp_callback_t function
|
||
* data - pointer to data that will be passed to callback function, only used if callback
|
||
* is supplied
|
||
* len - Length of pattern in characters, if zero string length is used.
|
||
*/
|
||
apr_status_t acmp_add_pattern(ACMP *parser, const char *pattern,
|
||
acmp_callback_t callback, void *data, apr_size_t len);
|
||
|
||
/**
|
||
* Called to process incoming data stream. You must call acmp_done after sending
|
||
* last data packet
|
||
*
|
||
* data - ptr to incoming data
|
||
* len - size of data in bytes
|
||
*/
|
||
apr_status_t acmp_process(ACMP *parser, const char *data, apr_size_t len);
|
||
|
||
/**
|
||
* Returns number of matches on all patterns combined
|
||
*/
|
||
apr_size_t acmp_match_count_total(ACMP *parser);
|
||
|
||
/**
|
||
* Returns number of matches for given pattern
|
||
*/
|
||
apr_size_t acmp_match_count(ACMP *parser, const char *pattern);
|
||
|
||
/**
|
||
* Resets the state of parser so you can start using it with new set of data,
|
||
* or add new patterns.
|
||
*/
|
||
void acmp_reset(ACMP *parser);
|
||
|
||
/**
|
||
* Creates an ACMPT struct that will use parser's tree, without duplicating its data
|
||
*/
|
||
ACMPT *acmp_duplicate_quick(ACMP *parser, apr_pool_t *pool);
|
||
|
||
/**
|
||
* Process the data using ACMPT to keep state, and ACMPT's parser to keep the tree
|
||
*/
|
||
apr_status_t acmp_process_quick(ACMPT *acmpt, const char **match, const char *data, apr_size_t len);
|
||
|
||
/**
|
||
* Prepares parser for searching
|
||
*/
|
||
apr_status_t acmp_prepare(ACMP *parser);
|
||
|
||
|
||
#endif /*ACMP_H_*/
|