suricata
packet.c
Go to the documentation of this file.
1 /* Copyright (C) 2007-2022 Open Information Security Foundation
2  *
3  * You can copy, redistribute or modify this Program under the terms of
4  * the GNU General Public License version 2 as published by the Free
5  * Software Foundation.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * version 2 along with this program; if not, write to the Free Software
14  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
15  * 02110-1301, USA.
16  */
17 
18 #include "packet.h"
19 #include "pkt-var.h"
20 #include "flow.h"
21 #include "host.h"
22 #include "util-profiling.h"
23 #include "util-validate.h"
24 #include "action-globals.h"
25 
26 /** \brief issue drop action
27  *
28  * Set drop (+reject) flags in both current and root packet.
29  *
30  * \param action action bit flags. Must be limited to ACTION_DROP_REJECT
31  */
32 void PacketDrop(Packet *p, const uint8_t action, enum PacketDropReason r)
33 {
35 
37  p->drop_reason = (uint8_t)r;
38 
39  if (p->root) {
40  p->root->action |= action;
43  }
44  }
45  p->action |= action;
46 }
47 
48 bool PacketCheckAction(const Packet *p, const uint8_t a)
49 {
50  if (likely(p->root == NULL)) {
51  return (p->action & a) != 0;
52  } else {
53  /* check against both */
54  const uint8_t actions = p->action | p->root->action;
55  return (actions & a) != 0;
56  }
57 }
58 
59 /**
60  * \brief Initialize a packet structure for use.
61  */
63 {
66  p->livedev = NULL;
67 }
68 
70 {
71  FlowDeReference(&p->flow);
74 }
75 
76 /**
77  * \brief Recycle a packet structure for reuse.
78  */
80 {
81 /* clear the address structure by setting all fields to 0 */
82 #define CLEAR_ADDR(a) \
83  do { \
84  (a)->family = 0; \
85  (a)->addr_data32[0] = 0; \
86  (a)->addr_data32[1] = 0; \
87  (a)->addr_data32[2] = 0; \
88  (a)->addr_data32[3] = 0; \
89  } while (0)
90 
91  CLEAR_ADDR(&p->src);
92  CLEAR_ADDR(&p->dst);
93  p->sp = 0;
94  p->dp = 0;
95  p->proto = 0;
96  p->recursion_level = 0;
98  p->app_update_direction = 0;
99  p->flags = 0;
100  p->flowflags = 0;
101  p->pkt_src = 0;
102  p->vlan_id[0] = 0;
103  p->vlan_id[1] = 0;
104  p->vlan_idx = 0;
105  p->ttype = PacketTunnelNone;
106  SCTIME_INIT(p->ts);
107  p->datalink = 0;
108  p->drop_reason = 0;
109 #define PACKET_RESET_ACTION(p) (p)->action = 0
111  if (p->pktvar != NULL) {
112  PktVarFree(p->pktvar);
113  p->pktvar = NULL;
114  }
115  PacketClearL2(p);
116  PacketClearL3(p);
117  PacketClearL4(p);
118  p->payload = NULL;
119  p->payload_len = 0;
120  p->BypassPacketsFlow = NULL;
121 #define RESET_PKT_LEN(p) ((p)->pktlen = 0)
122  RESET_PKT_LEN(p);
123  p->alerts.cnt = 0;
124  p->alerts.discarded = 0;
125  p->alerts.suppressed = 0;
126  p->alerts.drop.action = 0;
127  p->pcap_cnt = 0;
128  p->tunnel_rtv_cnt = 0;
129  p->tunnel_tpr_cnt = 0;
130  p->events.cnt = 0;
132  p->next = NULL;
133  p->prev = NULL;
134  p->tunnel_verdicted = false;
135  p->root = NULL;
136  p->livedev = NULL;
138  p->tenant_id = 0;
139  p->nb_decoded_layers = 0;
140 }
141 
143 {
145  PacketReinit(p);
146 }
147 
148 /**
149  * \brief Cleanup a packet so that we can free it. No memset needed..
150  */
152 {
154  if (p->pktvar != NULL) {
155  PktVarFree(p->pktvar);
156  }
162 }
PacketCheckAction
bool PacketCheckAction(const Packet *p, const uint8_t a)
Definition: packet.c:48
HostDeReference
#define HostDeReference(src_h_ptr)
Definition: host.h:124
host.h
Packet_::proto
uint8_t proto
Definition: decode.h:513
SCSpinDestroy
#define SCSpinDestroy
Definition: threads-debug.h:239
Packet_::host_src
struct Host_ * host_src
Definition: decode.h:614
Packet_::pcap_cnt
uint64_t pcap_cnt
Definition: decode.h:618
Packet_::payload
uint8_t * payload
Definition: decode.h:597
PacketAlerts_::cnt
uint16_t cnt
Definition: decode.h:274
action-globals.h
Packet_::flags
uint32_t flags
Definition: decode.h:528
PacketRecycle
void PacketRecycle(Packet *p)
Definition: packet.c:142
Packet_::action
uint8_t action
Definition: decode.h:601
PacketAlertCreate
PacketAlert * PacketAlertCreate(void)
Initialize PacketAlerts with dynamic alerts array size.
Definition: decode.c:140
Packet_::vlan_idx
uint8_t vlan_idx
Definition: decode.h:519
RESET_PKT_LEN
#define RESET_PKT_LEN(p)
Packet_::tunnel_verdicted
bool tunnel_verdicted
Definition: decode.h:642
PacketReleaseRefs
void PacketReleaseRefs(Packet *p)
Definition: packet.c:69
PacketAlerts_::alerts
PacketAlert * alerts
Definition: decode.h:277
AppLayerDecoderEventsFreeEvents
void AppLayerDecoderEventsFreeEvents(AppLayerDecoderEvents **events)
Definition: app-layer-events.c:133
Packet_::persistent
struct Packet_::@39 persistent
PacketAlerts_::drop
PacketAlert drop
Definition: decode.h:280
ACTION_DROP_REJECT
#define ACTION_DROP_REJECT
Definition: action-globals.h:39
AppLayerDecoderEventsResetEvents
void AppLayerDecoderEventsResetEvents(AppLayerDecoderEvents *events)
Definition: app-layer-events.c:124
Packet_::host_dst
struct Host_ * host_dst
Definition: decode.h:615
Packet_::flowflags
uint8_t flowflags
Definition: decode.h:522
Packet_::BypassPacketsFlow
int(* BypassPacketsFlow)(struct Packet_ *)
Definition: decode.h:586
PacketDropReason
PacketDropReason
Definition: decode.h:375
CLEAR_ADDR
#define CLEAR_ADDR(a)
Packet_::payload_len
uint16_t payload_len
Definition: decode.h:598
Packet_::alerts
PacketAlerts alerts
Definition: decode.h:612
Packet_::tunnel_tpr_cnt
uint16_t tunnel_tpr_cnt
Definition: decode.h:654
Packet_::app_layer_events
AppLayerDecoderEvents * app_layer_events
Definition: decode.h:624
PacketAlertFree
void PacketAlertFree(PacketAlert *pa)
Definition: decode.c:148
Packet_::events
PacketEngineEvents events
Definition: decode.h:622
PacketAlert_::action
uint8_t action
Definition: decode.h:250
Packet_::datalink
int datalink
Definition: decode.h:631
PacketReinit
void PacketReinit(Packet *p)
Recycle a packet structure for reuse.
Definition: packet.c:79
Packet_::pktvar
PktVar * pktvar
Definition: decode.h:589
Packet_::tunnel_lock
SCSpinlock tunnel_lock
Definition: decode.h:675
Packet_::ts
SCTime_t ts
Definition: decode.h:539
SCTIME_INIT
#define SCTIME_INIT(t)
Definition: util-time.h:45
PKT_DROP_REASON_NOT_SET
@ PKT_DROP_REASON_NOT_SET
Definition: decode.h:376
Packet_::prev
struct Packet_ * prev
Definition: decode.h:628
PacketDestructor
void PacketDestructor(Packet *p)
Cleanup a packet so that we can free it. No memset needed..
Definition: packet.c:151
Packet_::tunnel_rtv_cnt
uint16_t tunnel_rtv_cnt
Definition: decode.h:652
pkt-var.h
Packet_::sp
Port sp
Definition: decode.h:498
PacketAlerts_::discarded
uint16_t discarded
Definition: decode.h:275
PACKET_RESET_ACTION
#define PACKET_RESET_ACTION(p)
util-profiling.h
Packet_
Definition: decode.h:491
Packet_::livedev
struct LiveDevice_ * livedev
Definition: decode.h:610
PacketTunnelNone
@ PacketTunnelNone
Definition: decode.h:396
Packet_::nb_decoded_layers
uint8_t nb_decoded_layers
Definition: decode.h:636
PACKET_FREE_EXTDATA
#define PACKET_FREE_EXTDATA(p)
Definition: decode.h:1051
Packet_::tenant_id
uint32_t tenant_id
Definition: decode.h:657
Packet_::flow
struct Flow_ * flow
Definition: decode.h:530
PKT_DROP_REASON_INNER_PACKET
@ PKT_DROP_REASON_INNER_PACKET
Definition: decode.h:391
packet.h
Packet_::app_update_direction
uint8_t app_update_direction
Definition: decode.h:525
Packet_::ttype
enum PacketTunnelType ttype
Definition: decode.h:537
util-validate.h
PACKET_PROFILING_RESET
#define PACKET_PROFILING_RESET(p)
Definition: util-profiling.h:161
SCSpinInit
#define SCSpinInit
Definition: threads-debug.h:238
Packet_::next
struct Packet_ * next
Definition: decode.h:627
Packet_::root
struct Packet_ * root
Definition: decode.h:645
PacketAlerts_::suppressed
uint16_t suppressed
Definition: decode.h:276
Packet_::pkt_src
uint8_t pkt_src
Definition: decode.h:603
Packet_::recursion_level
uint8_t recursion_level
Definition: decode.h:516
PktVarFree
void PktVarFree(PktVar *pv)
Definition: pkt-var.c:111
PacketDrop
void PacketDrop(Packet *p, const uint8_t action, enum PacketDropReason r)
issue drop action
Definition: packet.c:32
Packet_::drop_reason
uint8_t drop_reason
Definition: decode.h:639
Packet_::dst
Address dst
Definition: decode.h:496
Packet_::vlan_id
uint16_t vlan_id[VLAN_MAX_LAYERS]
Definition: decode.h:518
likely
#define likely(expr)
Definition: util-optimize.h:32
flow.h
PacketInit
void PacketInit(Packet *p)
Initialize a packet structure for use.
Definition: packet.c:62
Packet_::dp
Port dp
Definition: decode.h:506
DEBUG_VALIDATE_BUG_ON
#define DEBUG_VALIDATE_BUG_ON(exp)
Definition: util-validate.h:102
Packet_::src
Address src
Definition: decode.h:495
PacketEngineEvents_::cnt
uint8_t cnt
Definition: decode.h:293