0853ddd1cb
This adds new syntax to read a field from the tree as bytes, instead
of the actual type. This is a useful extension for example to match
matformed strings that contain unicode replacement characters. In
this case it is not possible to match the raw value of the malformed
string field. This extension fills this need and is generic enough
that it should be useful in many other situations.
The syntax used is to prefix the field name with "@". The following
artificial example tests if the HTTP user agent contains a particular
invalid UTF-8 sequence:
@http.user_agent == "Mozill\xAA"
Where simply using "http.user_agent" won't work because the invalid byte
sequence will have been replaced with U+FFFD.
Considering the following programs:
$ dftest '_ws.ftypes.string == "ABC"'
Filter: _ws.ftypes.string == "ABC"
Syntax tree:
0 TEST_ANY_EQ:
1 FIELD(_ws.ftypes.string <FT_STRING>)
1 FVALUE("ABC" <FT_STRING>)
Instructions:
00000 READ_TREE _ws.ftypes.string <FT_STRING> -> reg#0
00001 IF_FALSE_GOTO 3
00002 ANY_EQ reg#0 == "ABC" <FT_STRING>
00003 RETURN
$ dftest '@_ws.ftypes.string == "ABC"'
Filter: @_ws.ftypes.string == "ABC"
Syntax tree:
0 TEST_ANY_EQ:
1 FIELD(_ws.ftypes.string <RAW>)
1 FVALUE(41:42:43 <FT_BYTES>)
Instructions:
00000 READ_TREE @_ws.ftypes.string <FT_BYTES> -> reg#0
00001 IF_FALSE_GOTO 3
00002 ANY_EQ reg#0 == 41:42:43 <FT_BYTES>
00003 RETURN
In the second case the field has a "raw" type, that equates directly to
FT_BYTES, and the field value is read from the protocol raw data.
55 lines
1,005 B
C
55 lines
1,005 B
C
/** @file
|
|
*
|
|
* Wireshark - Network traffic analyzer
|
|
* By Gerald Combs <gerald@wireshark.org>
|
|
* Copyright 2001 Gerald Combs
|
|
*
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later
|
|
*/
|
|
|
|
#ifndef STTYPE_FIELD_H
|
|
#define STTYPE_FIELD_H
|
|
|
|
#include "syntax-tree.h"
|
|
#include "drange.h"
|
|
|
|
|
|
header_field_info *
|
|
sttype_field_hfinfo(stnode_t *node);
|
|
|
|
ftenum_t
|
|
sttype_field_ftenum(stnode_t *node);
|
|
|
|
drange_t *
|
|
sttype_field_drange(stnode_t *node);
|
|
|
|
drange_t *
|
|
sttype_field_drange_steal(stnode_t *node);
|
|
|
|
gboolean
|
|
sttype_field_raw(stnode_t *node);
|
|
|
|
/* Set a range */
|
|
void
|
|
sttype_field_set_range(stnode_t *node, GSList* drange_list);
|
|
|
|
void
|
|
sttype_field_set_range1(stnode_t *node, drange_node *rn);
|
|
|
|
void
|
|
sttype_field_set_drange(stnode_t *node, drange_t *dr);
|
|
|
|
void
|
|
sttype_field_set_raw(stnode_t *node, gboolean raw);
|
|
|
|
char *
|
|
sttype_field_set_number(stnode_t *node, const char *number_str);
|
|
|
|
/* Clear the 'drange' variable to remove responsibility for
|
|
* freeing it. */
|
|
void
|
|
sttype_field_remove_drange(stnode_t *node);
|
|
|
|
#endif
|