mate_util.h

/* mate_util.h
 *
 * Copyright 2004, Luis E. Garcia Ontanon <[email protected]>
 *
 * Wireshark - Network traffic analyzer
 * By Gerald Combs <[email protected]>
 * Copyright 1998 Gerald Combs
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 
#ifndef __AVP_H_
#define __AVP_H_
#include "epan/proto.h"
#include <sys/types.h>
 
/* #define _AVP_DEBUGGING */
 
 
/******* dbg_print *********/
#define DEBUG_BUFFER_SIZE 4096
 
extern void dbg_print(const int* which, int how, FILE* where,
    const char* fmt, ... ) G_GNUC_PRINTF(4, 5);
 
 
/******* single copy strings *********/
typedef struct _scs_collection SCS_collection;
 
#define SCS_HUGE_SIZE 65535
 
extern char* scs_subscribe(SCS_collection* collection, const char* s);
extern void scs_unsubscribe(SCS_collection* collection, char* s);
 
extern char* scs_subscribe_printf(SCS_collection* collection, char* fmt, ...)
    G_GNUC_PRINTF(2, 3);
 
/******* AVPs & Co. *********/
 
/* these are the defined operators of avps */
#define AVP_OP_EQUAL        '='
#define AVP_OP_NOTEQUAL     '!'
#define AVP_OP_STARTS       '^'
#define AVP_OP_ENDS     '$'
#define AVP_OP_CONTAINS     '~'
#define AVP_OP_LOWER        '<'
#define AVP_OP_HIGHER       '>'
#define AVP_OP_EXISTS       '?'
#define AVP_OP_ONEOFF       '|'
#define AVP_OP_TRANSF       '&'
 
 
typedef struct _avp {
    char *n; 
    char *v; 
    char  o; 
} AVP;
 
 
typedef struct _avp_node {
    AVP            *avp;  
    struct _avp_node *next; 
    struct _avp_node *prev; 
} AVPN;
 
 
typedef struct _avp_list {
    char    *name; 
    uint32_t len;  
    AVPN     null; 
} AVPL;
 
 
typedef enum _avpl_match_mode {
    AVPL_NO_MATCH, 
    AVPL_STRICT,   
    AVPL_LOOSE,    
    AVPL_EVERY     
} avpl_match_mode;
 
 
typedef enum _avpl_replace_mode {
    AVPL_NO_REPLACE, 
    AVPL_INSERT,     
    AVPL_REPLACE     
} avpl_replace_mode;
 
 
typedef struct _avpl_transf AVPL_Transf;
 
 
struct _avpl_transf {
    char *name;                    
    AVPL *match;                   
    AVPL *replace;                 
    avpl_match_mode   match_mode;   
    avpl_replace_mode replace_mode; 
    GHashTable  *map;  
    AVPL_Transf *next; 
};
 
 
typedef struct _loal_node {
    AVPL               *avpl; 
    struct _loal_node  *next; 
    struct _loal_node  *prev; 
} LoALnode;
 
 
typedef struct _loal {
    char     *name; 
    unsigned  len;  
    LoALnode  null; 
} LoAL;
 
 
/* avp library (re)initialization */
 
extern void avp_init(void);
 
/* If enabled set's up the debug facilities for the avp library */
#ifdef _AVP_DEBUGGING
extern void setup_avp_debug(FILE* fp, int* general, int* avp, int* avp_op, int* avpl, int* avpl_op);
#endif /* _AVP_DEBUGGING */
 
/*
 * avp constructors
 */
 
/* creates a new avp */
 
extern AVP* new_avp(const char* name, const char* value, char op);
 
extern AVP* avp_copy(AVP* from);
 
extern AVP* new_avp_from_finfo(const char* name, field_info* finfo);
 
extern void delete_avp(AVP* avp);
 
/*
 * avp methods
 */
#define avp_to_str(avp) (ws_strdup_printf("%s%c%s",avp->n,avp->o,avp->v))
 
extern AVP* match_avp(AVP* src, AVP* op);
 
 
/*
 * avplist constructors
 */
 
extern AVPL* new_avpl(const char* name);
 
 
extern AVPL* new_avpl_from_avpl(const char* name, AVPL* avpl, bool copy_avps);
 
extern AVPL* new_avpl_loose_match(const char* name, AVPL* src, AVPL* op, bool copy_avps);
 
 
extern AVPL* new_avpl_pairs_match(const char* name, AVPL* src, AVPL* op, bool strict, bool copy_avps);
 
/* uses mode to call one of the former matches. NO_MATCH = merge(merge(copy(src),op)) */
 
extern AVPL* new_avpl_from_match(avpl_match_mode mode, const char* name,AVPL* src, AVPL* op, bool copy_avps);
 
 
/*
 * functions on avpls
 */
 
extern bool insert_avp(AVPL* avpl, AVP* avp);
 
extern void rename_avpl(AVPL* avpl, char* name);
 
extern void merge_avpl(AVPL* dest, AVPL* src, bool copy);
 
extern AVP* get_avp_by_name(AVPL* avpl, char* name, void** cookie);
 
extern AVP* get_next_avp(AVPL* avpl, void** cookie);
 
extern AVP* extract_first_avp(AVPL* avpl);
 
extern AVP* extract_last_avp(AVPL* avpl);
 
extern AVP* extract_avp_by_name(AVPL* avpl, char* name);
 
extern char* avpl_to_str(AVPL* avpl);
 
extern char* avpl_to_dotstr(AVPL* avpl);
 
/* deletes an avp list  and eventually its contents */
 
extern void delete_avpl(AVPL* avpl, bool avps_too);
 
/*
 *  AVPL transformations
 */
extern void delete_avpl_transform(AVPL_Transf* it);
 
extern void avpl_transform(AVPL* src, AVPL_Transf* op);
 
 
/*
 * Lists of AVP lists
 */
 
extern LoAL* new_loal(const char* name);
 
extern LoAL* loal_from_file(char* filename);
 
extern void loal_append(LoAL* loal, AVPL* avpl);
 
extern AVPL* extract_first_avpl(LoAL* loal);
 
extern AVPL* extract_last_avpl(LoAL* loal);
 
extern AVPL* get_next_avpl(LoAL* loal,void** cookie);
 
extern void delete_loal(LoAL* loal, bool avpls_too, bool avps_too);
 
 
#endif