2 * Routines for {fragment,segment} reassembly
4 * Wireshark - Network traffic analyzer
5 * By Gerald Combs <gerald@wireshark.org>
6 * Copyright 1998 Gerald Combs
8 * SPDX-License-Identifier: GPL-2.0-or-later
15 #include <epan/packet.h>
16 #include <epan/exceptions.h>
17 #include <epan/reassemble.h>
18 #include <epan/tvbuff-int.h>
20 #include <wsutil/str_util.h>
21 #include <wsutil/ws_assert.h>
24 * Functions for reassembly tables where the endpoint addresses, and a
25 * fragment ID, are used as the key.
27 typedef struct _fragment_addresses_key
{
31 } fragment_addresses_key
;
33 GList
* reassembly_table_list
;
36 fragment_addresses_hash(const void *k
)
38 const fragment_addresses_key
* key
= (const fragment_addresses_key
*) k
;
46 /* More than likely: in most captures src and dst addresses are the
47 same, and would hash the same.
48 We only use id as the hash as an optimization.
50 for (i = 0; i < key->src.len; i++)
51 hash_val += key->src.data[i];
52 for (i = 0; i < key->dst.len; i++)
53 hash_val += key->dst.data[i];
62 fragment_addresses_equal(const void *k1
, const void *k2
)
64 const fragment_addresses_key
* key1
= (const fragment_addresses_key
*) k1
;
65 const fragment_addresses_key
* key2
= (const fragment_addresses_key
*) k2
;
68 * key.id is the first item to compare since it's the item most
69 * likely to differ between sessions, thus short-circuiting
70 * the comparison of addresses.
72 return (key1
->id
== key2
->id
) &&
73 (addresses_equal(&key1
->src
, &key2
->src
)) &&
74 (addresses_equal(&key1
->dst
, &key2
->dst
));
78 * Create a fragment key for temporary use; it can point to non-
79 * persistent data, and so must only be used to look up and
80 * delete entries, not to add them.
83 fragment_addresses_temporary_key(const packet_info
*pinfo
, const uint32_t id
,
86 fragment_addresses_key
*key
= g_slice_new(fragment_addresses_key
);
89 * Do a shallow copy of the addresses.
91 copy_address_shallow(&key
->src
, &pinfo
->src
);
92 copy_address_shallow(&key
->dst
, &pinfo
->dst
);
99 * Create a fragment key for permanent use; it must point to persistent
100 * data, so that it can be used to add entries.
103 fragment_addresses_persistent_key(const packet_info
*pinfo
, const uint32_t id
,
104 const void *data _U_
)
106 fragment_addresses_key
*key
= g_slice_new(fragment_addresses_key
);
109 * Do a deep copy of the addresses.
111 copy_address(&key
->src
, &pinfo
->src
);
112 copy_address(&key
->dst
, &pinfo
->dst
);
119 fragment_addresses_free_temporary_key(void *ptr
)
121 fragment_addresses_key
*key
= (fragment_addresses_key
*)ptr
;
122 g_slice_free(fragment_addresses_key
, key
);
126 fragment_addresses_free_persistent_key(void *ptr
)
128 fragment_addresses_key
*key
= (fragment_addresses_key
*)ptr
;
132 * Free up the copies of the addresses from the old key.
134 free_address(&key
->src
);
135 free_address(&key
->dst
);
137 g_slice_free(fragment_addresses_key
, key
);
141 const reassembly_table_functions
142 addresses_reassembly_table_functions
= {
143 fragment_addresses_hash
,
144 fragment_addresses_equal
,
145 fragment_addresses_temporary_key
,
146 fragment_addresses_persistent_key
,
147 fragment_addresses_free_temporary_key
,
148 fragment_addresses_free_persistent_key
152 * Functions for reassembly tables where the endpoint addresses and ports,
153 * and a fragment ID, are used as the key.
155 typedef struct _fragment_addresses_ports_key
{
161 } fragment_addresses_ports_key
;
164 fragment_addresses_ports_hash(const void *k
)
166 const fragment_addresses_ports_key
* key
= (const fragment_addresses_ports_key
*) k
;
174 /* More than likely: in most captures src and dst addresses and ports
175 are the same, and would hash the same.
176 We only use id as the hash as an optimization.
178 for (i = 0; i < key->src.len; i++)
179 hash_val += key->src_addr.data[i];
180 for (i = 0; i < key->dst.len; i++)
181 hash_val += key->dst_addr.data[i];
182 hash_val += key->src_port;
183 hash_val += key->dst_port;
192 fragment_addresses_ports_equal(const void *k1
, const void *k2
)
194 const fragment_addresses_ports_key
* key1
= (const fragment_addresses_ports_key
*) k1
;
195 const fragment_addresses_ports_key
* key2
= (const fragment_addresses_ports_key
*) k2
;
198 * key.id is the first item to compare since it's the item most
199 * likely to differ between sessions, thus short-circuiting
200 * the comparison of addresses and ports.
202 return (key1
->id
== key2
->id
) &&
203 (addresses_equal(&key1
->src_addr
, &key2
->src_addr
)) &&
204 (addresses_equal(&key1
->dst_addr
, &key2
->dst_addr
)) &&
205 (key1
->src_port
== key2
->src_port
) &&
206 (key1
->dst_port
== key2
->dst_port
);
210 * Create a fragment key for temporary use; it can point to non-
211 * persistent data, and so must only be used to look up and
212 * delete entries, not to add them.
215 fragment_addresses_ports_temporary_key(const packet_info
*pinfo
, const uint32_t id
,
216 const void *data _U_
)
218 fragment_addresses_ports_key
*key
= g_slice_new(fragment_addresses_ports_key
);
221 * Do a shallow copy of the addresses.
223 copy_address_shallow(&key
->src_addr
, &pinfo
->src
);
224 copy_address_shallow(&key
->dst_addr
, &pinfo
->dst
);
225 key
->src_port
= pinfo
->srcport
;
226 key
->dst_port
= pinfo
->destport
;
233 * Create a fragment key for permanent use; it must point to persistent
234 * data, so that it can be used to add entries.
237 fragment_addresses_ports_persistent_key(const packet_info
*pinfo
,
238 const uint32_t id
, const void *data _U_
)
240 fragment_addresses_ports_key
*key
= g_slice_new(fragment_addresses_ports_key
);
243 * Do a deep copy of the addresses.
245 copy_address(&key
->src_addr
, &pinfo
->src
);
246 copy_address(&key
->dst_addr
, &pinfo
->dst
);
247 key
->src_port
= pinfo
->srcport
;
248 key
->dst_port
= pinfo
->destport
;
255 fragment_addresses_ports_free_temporary_key(void *ptr
)
257 fragment_addresses_ports_key
*key
= (fragment_addresses_ports_key
*)ptr
;
258 g_slice_free(fragment_addresses_ports_key
, key
);
262 fragment_addresses_ports_free_persistent_key(void *ptr
)
264 fragment_addresses_ports_key
*key
= (fragment_addresses_ports_key
*)ptr
;
268 * Free up the copies of the addresses from the old key.
270 free_address(&key
->src_addr
);
271 free_address(&key
->dst_addr
);
273 g_slice_free(fragment_addresses_ports_key
, key
);
277 const reassembly_table_functions
278 addresses_ports_reassembly_table_functions
= {
279 fragment_addresses_ports_hash
,
280 fragment_addresses_ports_equal
,
281 fragment_addresses_ports_temporary_key
,
282 fragment_addresses_ports_persistent_key
,
283 fragment_addresses_ports_free_temporary_key
,
284 fragment_addresses_ports_free_persistent_key
287 typedef struct _reassembled_key
{
293 reassembled_equal(const void *k1
, const void *k2
)
295 const reassembled_key
* key1
= (const reassembled_key
*) k1
;
296 const reassembled_key
* key2
= (const reassembled_key
*) k2
;
299 * We assume that the frame numbers are unlikely to be equal,
300 * so we check them first.
302 return key1
->frame
== key2
->frame
&& key1
->id
== key2
->id
;
306 reassembled_hash(const void *k
)
308 const reassembled_key
* key
= (const reassembled_key
*) k
;
314 reassembled_key_free(void *ptr
)
316 g_slice_free(reassembled_key
, (reassembled_key
*)ptr
);
320 * For a fragment hash table entry, free the associated fragments.
321 * The entry value (fd_chain) is freed herein and the entry is freed
322 * when the key freeing routine is called (as a consequence of returning
323 * true from this function).
326 free_all_fragments(void *key_arg _U_
, void *value
, void *user_data _U_
)
328 fragment_head
*fd_head
;
329 fragment_item
*fd_i
= NULL
, *tmp_fd
;
331 /* g_hash_table_new_full() was used to supply a function
332 * to free the key and anything to which it points
334 fd_head
= (fragment_head
*)value
;
335 if (fd_head
!= NULL
) {
336 fd_i
= fd_head
->next
;
337 if(fd_head
->tvb_data
&& !(fd_head
->flags
&FD_SUBSET_TVB
))
338 tvb_free(fd_head
->tvb_data
);
339 g_slice_free(fragment_head
, fd_head
);
342 for (; fd_i
!= NULL
; fd_i
= tmp_fd
) {
345 if(fd_i
->tvb_data
&& !(fd_i
->flags
&FD_SUBSET_TVB
))
346 tvb_free(fd_i
->tvb_data
);
347 g_slice_free(fragment_item
, fd_i
);
353 /* ------------------------- */
354 static fragment_head
*new_head(const uint32_t flags
)
356 fragment_head
*fd_head
;
357 /* If head/first structure in list only holds no other data than
358 * 'datalen' then we don't have to change the head of the list
359 * even if we want to keep it sorted
361 fd_head
=g_slice_new0(fragment_head
);
363 fd_head
->flags
=flags
;
368 * For a reassembled-packet hash table entry, free the fragment data
369 * to which the value refers. (The key is freed by reassembled_key_free.)
372 free_fd_head(fragment_head
*fd_head
)
374 fragment_item
*fd_i
, *tmp
;
376 if (fd_head
->flags
& FD_SUBSET_TVB
)
377 fd_head
->tvb_data
= NULL
;
378 if (fd_head
->tvb_data
)
379 tvb_free(fd_head
->tvb_data
);
380 for (fd_i
= fd_head
->next
; fd_i
; fd_i
= tmp
) {
382 if (fd_i
->flags
& FD_SUBSET_TVB
)
383 fd_i
->tvb_data
= NULL
;
384 if (fd_i
->tvb_data
) {
385 tvb_free(fd_i
->tvb_data
);
387 g_slice_free(fragment_item
, fd_i
);
389 g_slice_free(fragment_head
, fd_head
);
393 unref_fd_head(void *data
)
395 fragment_head
*fd_head
= (fragment_head
*) data
;
396 fd_head
->ref_count
--;
398 if (fd_head
->ref_count
== 0) {
399 free_fd_head(fd_head
);
404 reassembled_table_insert(GHashTable
*reassembled_table
, reassembled_key
*key
, fragment_head
*fd_head
)
406 fragment_head
*old_fd_head
;
407 fd_head
->ref_count
++;
408 if ((old_fd_head
= g_hash_table_lookup(reassembled_table
, key
)) != NULL
) {
409 if (old_fd_head
->ref_count
== 1) {
410 /* We're replacing the last entry in the reassembled
411 * table for an old reassembly. Does it have a tvb?
412 * We might still be using that tvb's memory for an
413 * address via set_address_tvb(). (See #19094.)
415 if (old_fd_head
->tvb_data
&& fd_head
->tvb_data
) {
416 /* Free it when the new tvb is freed */
417 tvb_set_child_real_data_tvbuff(fd_head
->tvb_data
, old_fd_head
->tvb_data
);
419 /* XXX: Set the old data to NULL regardless. If we
420 * have old data but not new data, that is odd (we're
421 * replacing a reassembly with tvb data with something
422 * with no tvb data, possibly because a zero length or
423 * null tvb was passed into a defragment function,
424 * which is a dissector bug.)
425 * This leaks the tvb data if we couldn't add it to
426 * a new tvb's chain, but we might not be able to free
427 * it yet if set_address_tvb() was used.
429 old_fd_head
->tvb_data
= NULL
;
432 g_hash_table_insert(reassembled_table
, key
, fd_head
);
435 typedef struct register_reassembly_table
{
436 reassembly_table
*table
;
437 const reassembly_table_functions
*funcs
;
438 } register_reassembly_table_t
;
441 * Register a reassembly table.
444 reassembly_table_register(reassembly_table
*table
,
445 const reassembly_table_functions
*funcs
)
447 register_reassembly_table_t
* reg_table
;
449 DISSECTOR_ASSERT(table
);
450 DISSECTOR_ASSERT(funcs
);
452 reg_table
= g_new(register_reassembly_table_t
,1);
454 reg_table
->table
= table
;
455 reg_table
->funcs
= funcs
;
457 reassembly_table_list
= g_list_prepend(reassembly_table_list
, reg_table
);
461 * Initialize a reassembly table, with specified functions.
464 reassembly_table_init(reassembly_table
*table
,
465 const reassembly_table_functions
*funcs
)
467 if (table
->temporary_key_func
== NULL
)
468 table
->temporary_key_func
= funcs
->temporary_key_func
;
469 if (table
->persistent_key_func
== NULL
)
470 table
->persistent_key_func
= funcs
->persistent_key_func
;
471 if (table
->free_temporary_key_func
== NULL
)
472 table
->free_temporary_key_func
= funcs
->free_temporary_key_func
;
473 if (table
->fragment_table
!= NULL
) {
475 * The fragment hash table exists.
477 * Remove all entries and free fragment data for each entry.
479 * The keys, and anything to which they point, are freed by
480 * calling the table's key freeing function. The values
481 * are freed in free_all_fragments().
483 g_hash_table_foreach_remove(table
->fragment_table
,
484 free_all_fragments
, NULL
);
486 /* The fragment table does not exist. Create it */
487 table
->fragment_table
= g_hash_table_new_full(funcs
->hash_func
,
488 funcs
->equal_func
, funcs
->free_persistent_key_func
, NULL
);
491 if (table
->reassembled_table
!= NULL
) {
493 * The reassembled-packet hash table exists.
495 * Remove all entries and free reassembled packet
496 * data and key for each entry.
498 g_hash_table_remove_all(table
->reassembled_table
);
500 /* The fragment table does not exist. Create it */
501 table
->reassembled_table
= g_hash_table_new_full(reassembled_hash
,
502 reassembled_equal
, reassembled_key_free
, unref_fd_head
);
507 * Destroy a reassembly table.
510 reassembly_table_destroy(reassembly_table
*table
)
513 * Clear the function pointers.
515 table
->temporary_key_func
= NULL
;
516 table
->persistent_key_func
= NULL
;
517 table
->free_temporary_key_func
= NULL
;
518 if (table
->fragment_table
!= NULL
) {
520 * The fragment hash table exists.
522 * Remove all entries and free fragment data for each entry.
524 * The keys, and anything to which they point, are freed by
525 * calling the table's key freeing function. The values
526 * are freed in free_all_fragments().
528 g_hash_table_foreach_remove(table
->fragment_table
,
529 free_all_fragments
, NULL
);
532 * Now destroy the hash table.
534 g_hash_table_destroy(table
->fragment_table
);
535 table
->fragment_table
= NULL
;
537 if (table
->reassembled_table
!= NULL
) {
539 * The reassembled-packet hash table exists.
541 * Remove all entries and free reassembled packet
542 * data and key for each entry.
545 g_hash_table_remove_all(table
->reassembled_table
);
548 * Now destroy the hash table.
550 g_hash_table_destroy(table
->reassembled_table
);
551 table
->reassembled_table
= NULL
;
556 * Look up an fd_head in the fragment table, optionally returning the key
559 static fragment_head
*
560 lookup_fd_head(reassembly_table
*table
, const packet_info
*pinfo
,
561 const uint32_t id
, const void *data
, void * *orig_keyp
)
566 /* Create key to search hash with */
567 key
= table
->temporary_key_func(pinfo
, id
, data
);
570 * Look up the reassembly in the fragment table.
572 if (!g_hash_table_lookup_extended(table
->fragment_table
, key
, orig_keyp
,
576 table
->free_temporary_key_func(key
);
578 return (fragment_head
*)value
;
582 * Insert an fd_head into the fragment table, and return the key used.
585 insert_fd_head(reassembly_table
*table
, fragment_head
*fd_head
,
586 const packet_info
*pinfo
, const uint32_t id
, const void *data
)
591 * We're going to use the key to insert the fragment,
592 * so make a persistent version of it.
594 key
= table
->persistent_key_func(pinfo
, id
, data
);
595 g_hash_table_insert(table
->fragment_table
, key
, fd_head
);
599 /* This function cleans up the stored state and removes the reassembly data and
600 * (with one exception) all allocated memory for matching reassembly.
603 * If the PDU was already completely reassembled, then the tvbuff containing the
604 * reassembled data WILL NOT be free()d, and the pointer to that tvbuff will be
606 * Othervise the function will return NULL.
608 * So, if you call fragment_delete and it returns non-NULL, YOU are responsible
609 * to tvb_free() that tvbuff.
612 fragment_delete(reassembly_table
*table
, const packet_info
*pinfo
,
613 const uint32_t id
, const void *data
)
615 fragment_head
*fd_head
;
617 tvbuff_t
*fd_tvb_data
=NULL
;
620 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, &key
);
622 /* We do not recognize this as a PDU we have seen before. return */
626 fd_tvb_data
=fd_head
->tvb_data
;
627 /* loop over all partial fragments and free any tvbuffs */
628 for(fd
=fd_head
->next
;fd
;){
629 fragment_item
*tmp_fd
;
632 if (fd
->tvb_data
&& !(fd
->flags
& FD_SUBSET_TVB
))
633 tvb_free(fd
->tvb_data
);
634 g_slice_free(fragment_item
, fd
);
637 g_slice_free(fragment_head
, fd_head
);
638 g_hash_table_remove(table
->fragment_table
, key
);
643 /* This function is used to check if there is partial or completed reassembly state
644 * matching this packet. I.e. Is there reassembly going on or not for this packet?
647 fragment_get(reassembly_table
*table
, const packet_info
*pinfo
,
648 const uint32_t id
, const void *data
)
650 return lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
654 fragment_get_reassembled_id(reassembly_table
*table
, const packet_info
*pinfo
,
657 fragment_head
*fd_head
;
660 /* create key to search hash with */
661 key
.frame
= pinfo
->num
;
663 fd_head
= (fragment_head
*)g_hash_table_lookup(table
->reassembled_table
, &key
);
668 /* To specify the offset for the fragment numbering, the first fragment is added with 0, and
669 * afterwards this offset is set. All additional calls to off_seq_check will calculate
670 * the number in sequence in regards to the offset */
672 fragment_add_seq_offset(reassembly_table
*table
, const packet_info
*pinfo
, const uint32_t id
,
673 const void *data
, const uint32_t fragment_offset
)
675 fragment_head
*fd_head
;
677 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
681 /* Resetting the offset is not allowed */
682 if ( fd_head
->fragment_nr_offset
!= 0 )
685 fd_head
->fragment_nr_offset
= fragment_offset
;
689 update_first_gap(fragment_head
*fd_head
, fragment_item
*inserted
, bool multi_insert
)
691 uint32_t frag_end
= inserted
->offset
+ inserted
->len
;
695 if (inserted
->offset
> fd_head
->contiguous_len
) {
696 /* first inserted node is after first gap */
698 } else if (fd_head
->first_gap
== NULL
) {
699 /* we haven't seen first fragment yet */
700 if (inserted
->offset
!= 0) {
701 /* inserted node is not first fragment */
704 contiguous
= inserted
->len
;
707 contiguous
= MAX(fd_head
->contiguous_len
, frag_end
);
708 iter
= multi_insert
? inserted
: fd_head
->first_gap
;
712 if (iter
->next
->offset
> contiguous
) {
716 contiguous
= MAX(contiguous
, iter
->offset
+ iter
->len
);
719 /* iter is either pointing to last fragment before gap or tail */
720 fd_head
->first_gap
= iter
;
721 fd_head
->contiguous_len
= contiguous
;
725 * Keeping first gap and contiguous length in sync significantly speeds up
726 * LINK_FRAG() when fragments in capture file are mostly ordered. However, when
727 * fragments are removed from the list, the first gap can point to fragments
728 * that were either moved to another list or freed. Therefore when any fragment
729 * before first gap is removed, the first gap (and contiguous length) must be
732 static void fragment_reset_first_gap(fragment_head
*fd_head
)
734 fd_head
->first_gap
= NULL
;
735 fd_head
->contiguous_len
= 0;
737 bool multi_insert
= (fd_head
->next
->next
!= NULL
);
738 update_first_gap(fd_head
, fd_head
->next
, multi_insert
);
743 * Determines whether list modification requires first gap reset. On entry
744 * modified is NULL if all elements were removed, otherwise it points to
745 * element (reachable from fd_head) whose next pointer was changed.
747 static void fragment_items_removed(fragment_head
*fd_head
, fragment_item
*modified
)
749 if ((fd_head
->first_gap
== modified
) ||
750 ((modified
!= NULL
) && (modified
->offset
> fd_head
->contiguous_len
))) {
751 /* Removed elements were after first gap */
754 fragment_reset_first_gap(fd_head
);
758 * For use with fragment_add (and not the fragment_add_seq functions).
759 * When the reassembled result is wrong (perhaps it needs to be extended), this
760 * function clears any previous reassembly result, allowing the new reassembled
761 * length to be set again.
764 fragment_reset_defragmentation(fragment_head
*fd_head
)
766 /* Caller must ensure that this function is only called when
767 * defragmentation is safe to undo. */
768 DISSECTOR_ASSERT(fd_head
->flags
& FD_DEFRAGMENTED
);
770 for (fragment_item
*fd_i
= fd_head
->next
; fd_i
; fd_i
= fd_i
->next
) {
771 if (!fd_i
->tvb_data
) {
772 fd_i
->tvb_data
= tvb_new_subset_remaining(fd_head
->tvb_data
, fd_i
->offset
);
773 fd_i
->flags
|= FD_SUBSET_TVB
;
775 fd_i
->flags
&= (~FD_TOOLONGFRAGMENT
) & (~FD_MULTIPLETAILS
);
777 fd_head
->flags
&= ~(FD_DEFRAGMENTED
|FD_PARTIAL_REASSEMBLY
|FD_DATALEN_SET
);
778 fd_head
->flags
&= ~(FD_TOOLONGFRAGMENT
|FD_MULTIPLETAILS
);
779 fd_head
->datalen
= 0;
780 fd_head
->reassembled_in
= 0;
781 fd_head
->reas_in_layer_num
= 0;
784 /* This function can be used to explicitly set the total length (if known)
785 * for reassembly of a PDU.
786 * This is useful for reassembly of PDUs where one may have the total length specified
787 * in the first fragment instead of as for, say, IPv4 where a flag indicates which
788 * is the last fragment.
790 * Such protocols might fragment_add with a more_frags==true for every fragment
791 * and just tell the reassembly engine the expected total length of the reassembled data
792 * using fragment_set_tot_len immediately after doing fragment_add for the first packet.
794 * Note that for FD_BLOCKSEQUENCE tot_len is the index for the tail fragment.
795 * i.e. since the block numbers start at 0, if we specify tot_len==2, that
796 * actually means we want to defragment 3 blocks, block 0, 1 and 2.
799 fragment_set_tot_len(reassembly_table
*table
, const packet_info
*pinfo
,
800 const uint32_t id
, const void *data
, const uint32_t tot_len
)
802 fragment_head
*fd_head
;
804 uint32_t max_offset
= 0;
806 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
810 /* If we're setting a block sequence number, verify that it
811 * doesn't conflict with values set by existing fragments.
812 * XXX - eliminate this check?
814 if (fd_head
->flags
& FD_BLOCKSEQUENCE
) {
815 for (fd
= fd_head
->next
; fd
; fd
= fd
->next
) {
816 if (fd
->offset
> max_offset
) {
817 max_offset
= fd
->offset
;
818 if (max_offset
> tot_len
) {
819 fd_head
->error
= "Bad total reassembly block count";
820 THROW_MESSAGE(ReassemblyError
, fd_head
->error
);
826 if (fd_head
->flags
& FD_DEFRAGMENTED
) {
827 if (max_offset
!= tot_len
) {
828 fd_head
->error
= "Defragmented complete but total length not satisfied";
829 THROW_MESSAGE(ReassemblyError
, fd_head
->error
);
833 /* We got this far so the value is sane. */
834 fd_head
->datalen
= tot_len
;
835 fd_head
->flags
|= FD_DATALEN_SET
;
839 fragment_reset_tot_len(reassembly_table
*table
, const packet_info
*pinfo
,
840 const uint32_t id
, const void *data
, const uint32_t tot_len
)
842 fragment_head
*fd_head
;
844 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
849 * If FD_PARTIAL_REASSEMBLY is set, it would make the next fragment_add
850 * call set the reassembled length based on the fragment offset and
851 * length. As the length is known now, be sure to disable that magic.
853 fd_head
->flags
&= ~FD_PARTIAL_REASSEMBLY
;
855 /* If the length is already as expected, there is nothing else to do. */
856 if (tot_len
== fd_head
->datalen
)
859 if (fd_head
->flags
& FD_DEFRAGMENTED
) {
861 * Fragments were reassembled before, clear it to allow
862 * increasing the reassembled length.
864 fragment_reset_defragmentation(fd_head
);
867 fd_head
->datalen
= tot_len
;
868 fd_head
->flags
|= FD_DATALEN_SET
;
872 fragment_truncate(reassembly_table
*table
, const packet_info
*pinfo
,
873 const uint32_t id
, const void *data
, const uint32_t tot_len
)
876 tvbuff_t
*old_tvb_data
;
877 fragment_head
*fd_head
;
879 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
883 /* Caller must ensure that this function is only called when
884 * we are defragmented. */
885 DISSECTOR_ASSERT(fd_head
->flags
& FD_DEFRAGMENTED
);
888 * If FD_PARTIAL_REASSEMBLY is set, it would make the next fragment_add
889 * call set the reassembled length based on the fragment offset and
890 * length. As the length is known now, be sure to disable that magic.
892 fd_head
->flags
&= ~FD_PARTIAL_REASSEMBLY
;
894 /* If the length is already as expected, there is nothing else to do. */
895 if (tot_len
== fd_head
->datalen
)
898 DISSECTOR_ASSERT(fd_head
->datalen
> tot_len
);
900 old_tvb_data
=fd_head
->tvb_data
;
901 fd_head
->tvb_data
= tvb_clone_offset_len(old_tvb_data
, 0, tot_len
);
902 tvb_set_free_cb(fd_head
->tvb_data
, g_free
);
905 tvb_add_to_chain(fd_head
->tvb_data
, old_tvb_data
);
906 fd_head
->datalen
= tot_len
;
908 /* Keep the fragments before the split point, dividing any if
910 * XXX: In rare cases, there might be fragments marked as overlap that
911 * have data both before and after the split point, and which only
912 * overlap after the split point. In that case, after dividing the
913 * fragments the first part no longer overlap.
914 * However, at this point we can't test for overlap conflicts,
915 * so we'll just leave the overlap flags as-is.
917 fd_head
->flags
&= ~(FD_OVERLAP
|FD_OVERLAPCONFLICT
|FD_TOOLONGFRAGMENT
|FD_MULTIPLETAILS
);
918 fragment_item
*fd_i
, *prev_fd
= NULL
;
919 for (fd_i
= fd_head
->next
; fd_i
&& (fd_i
->offset
< tot_len
); fd_i
= fd_i
->next
) {
920 fd_i
->flags
&= ~(FD_TOOLONGFRAGMENT
|FD_MULTIPLETAILS
);
921 /* Check for the split point occurring in the middle of the
923 if (fd_i
->offset
+ fd_i
->len
> tot_len
) {
924 fd_i
->len
= tot_len
- fd_i
->offset
;
926 fd_head
->flags
|= fd_i
->flags
& (FD_OVERLAP
|FD_OVERLAPCONFLICT
);
929 /* Below should do nothing since this is already defragmented */
930 if (fd_i
->flags
& FD_SUBSET_TVB
)
931 fd_i
->flags
&= ~FD_SUBSET_TVB
;
932 else if (fd_i
->tvb_data
)
933 tvb_free(fd_i
->tvb_data
);
938 /* Remove all the other fragments, as they are past the split point. */
940 prev_fd
->next
= NULL
;
942 fd_head
->next
= NULL
;
944 fd_head
->contiguous_len
= MIN(fd_head
->contiguous_len
, tot_len
);
945 fragment_items_removed(fd_head
, prev_fd
);
946 fragment_item
*tmp_fd
;
947 for (; fd_i
; fd_i
= tmp_fd
) {
950 if (fd_i
->tvb_data
&& !(fd_i
->flags
& FD_SUBSET_TVB
))
951 tvb_free(fd_i
->tvb_data
);
952 g_slice_free(fragment_item
, fd_i
);
957 fragment_get_tot_len(reassembly_table
*table
, const packet_info
*pinfo
,
958 const uint32_t id
, const void *data
)
960 fragment_head
*fd_head
;
962 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
965 return fd_head
->datalen
;
971 /* This function will set the partial reassembly flag for a fh.
972 When this function is called, the fh MUST already exist, i.e.
973 the fh MUST be created by the initial call to fragment_add() before
974 this function is called.
975 Also note that this function MUST be called to indicate a fh will be
976 extended (increase the already stored data)
980 fragment_set_partial_reassembly(reassembly_table
*table
,
981 const packet_info
*pinfo
, const uint32_t id
,
984 fragment_head
*fd_head
;
986 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
989 * XXX - why not do all the stuff done early in "fragment_add_work()",
990 * turning off FD_DEFRAGMENTED and pointing the fragments' data
991 * pointers to the appropriate part of the already-reassembled
992 * data, and clearing the data length and "reassembled in" frame
993 * number, here? We currently have a hack in the TCP dissector
994 * not to set the "reassembled in" value if the "partial reassembly"
995 * flag is set, so that in the first pass through the packets
996 * we don't falsely set a packet as reassembled in that packet
997 * if the dissector decided that even more reassembly was needed.
1000 fd_head
->flags
|= FD_PARTIAL_REASSEMBLY
;
1005 * This function gets rid of an entry from a fragment table, given
1006 * a pointer to the key for that entry.
1008 * The key freeing routine will be called by g_hash_table_remove().
1011 fragment_unhash(reassembly_table
*table
, void *key
)
1014 * Remove the entry from the fragment table.
1016 g_hash_table_remove(table
->fragment_table
, key
);
1020 * This function adds fragment_head structure to a reassembled-packet
1021 * hash table, using the frame numbers of each of the frames from
1022 * which it was reassembled as keys, and sets the "reassembled_in"
1026 fragment_reassembled(reassembly_table
*table
, fragment_head
*fd_head
,
1027 const packet_info
*pinfo
, const uint32_t id
)
1029 reassembled_key
*new_key
;
1032 fd_head
->ref_count
= 0;
1033 if (fd_head
->next
== NULL
) {
1035 * This was not fragmented, so there's no fragment
1036 * table; just hash it using the current frame number.
1038 new_key
= g_slice_new(reassembled_key
);
1039 new_key
->frame
= pinfo
->num
;
1041 reassembled_table_insert(table
->reassembled_table
, new_key
, fd_head
);
1044 * Hash it with the frame numbers for all the frames.
1046 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
){
1047 new_key
= g_slice_new(reassembled_key
);
1048 new_key
->frame
= fd
->frame
;
1050 reassembled_table_insert(table
->reassembled_table
, new_key
, fd_head
);
1053 fd_head
->flags
|= FD_DEFRAGMENTED
;
1054 fd_head
->reassembled_in
= pinfo
->num
;
1055 fd_head
->reas_in_layer_num
= pinfo
->curr_layer_num
;
1059 * This function is a variant of the above for the single sequence
1060 * case, using id+offset (i.e., the original sequence number) for the id
1064 fragment_reassembled_single(reassembly_table
*table
, fragment_head
*fd_head
,
1065 const packet_info
*pinfo
, const uint32_t id
)
1067 reassembled_key
*new_key
;
1070 fd_head
->ref_count
= 0;
1071 if (fd_head
->next
== NULL
) {
1073 * This was not fragmented, so there's no fragment
1074 * table; just hash it using the current frame number.
1076 new_key
= g_slice_new(reassembled_key
);
1077 new_key
->frame
= pinfo
->num
;
1079 reassembled_table_insert(table
->reassembled_table
, new_key
, fd_head
);
1082 * Hash it with the frame numbers for all the frames.
1084 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
){
1085 new_key
= g_slice_new(reassembled_key
);
1086 new_key
->frame
= fd
->frame
;
1087 new_key
->id
= id
+ fd
->offset
;
1088 reassembled_table_insert(table
->reassembled_table
, new_key
, fd_head
);
1091 fd_head
->flags
|= FD_DEFRAGMENTED
;
1092 fd_head
->reassembled_in
= pinfo
->num
;
1093 fd_head
->reas_in_layer_num
= pinfo
->curr_layer_num
;
1097 LINK_FRAG(fragment_head
*fd_head
,fragment_item
*fd
)
1099 fragment_item
*fd_i
;
1101 /* add fragment to list, keep list sorted */
1102 if (fd_head
->next
== NULL
|| fd
->offset
< fd_head
->next
->offset
) {
1103 /* New first fragment */
1104 fd
->next
= fd_head
->next
;
1107 fd_i
= fd_head
->next
;
1108 if (fd_head
->first_gap
!= NULL
) {
1109 if (fd
->offset
>= fd_head
->first_gap
->offset
) {
1110 /* fragment is after first gap */
1111 fd_i
= fd_head
->first_gap
;
1114 for(; fd_i
->next
; fd_i
=fd_i
->next
) {
1115 if (fd
->offset
< fd_i
->next
->offset
)
1118 fd
->next
= fd_i
->next
;
1122 update_first_gap(fd_head
, fd
, false);
1126 MERGE_FRAG(fragment_head
*fd_head
, fragment_item
*fd
)
1128 fragment_item
*fd_i
, *tmp
, *inserted
= fd
;
1131 if (fd
== NULL
) return;
1133 multi_insert
= (fd
->next
!= NULL
);
1135 if (fd_head
->next
== NULL
) {
1137 update_first_gap(fd_head
, fd
, multi_insert
);
1141 if ((fd_head
->first_gap
!= NULL
) &&
1142 (fd
->offset
>= fd_head
->first_gap
->offset
)) {
1143 /* all new fragments go after first gap */
1144 fd_i
= fd_head
->first_gap
;
1146 /* at least one new fragment goes before first gap */
1147 if (fd
->offset
< fd_head
->next
->offset
) {
1148 /* inserted fragment is new head, "swap" the lists */
1149 tmp
= fd_head
->next
;
1153 fd_i
= fd_head
->next
;
1156 /* Traverse the list linked to fragment head ("main" list), checking if
1157 * fd pointer ("merge" list) should go before or after fd_i->next. Swap
1158 * fd_i->next ("main") and fd pointers ("merge") if "merge" list should
1159 * go before iterated element (fd_i). After the swap what formerly was
1160 * "merge" list essentially becomes part of "main" list (just detached
1161 * element, i.e. fd, is now head of new "merge list").
1163 for(; fd_i
->next
; fd_i
=fd_i
->next
) {
1164 if (fd
->offset
< fd_i
->next
->offset
) {
1170 /* Reached "main" list end, attach remaining elements */
1173 update_first_gap(fd_head
, inserted
, multi_insert
);
1177 * This function adds a new fragment to the fragment hash table.
1178 * If this is the first fragment seen for this datagram, a new entry
1179 * is created in the hash table, otherwise this fragment is just added
1180 * to the linked list of fragments for this packet.
1181 * The list of fragments for a specific datagram is kept sorted for
1184 * Returns a pointer to the head of the fragment data list if we have all the
1185 * fragments, NULL otherwise.
1187 * This function assumes frag_offset being a byte offset into the defragment
1191 * Once the fh is defragmented (= FD_DEFRAGMENTED set), it can be
1192 * extended using the FD_PARTIAL_REASSEMBLY flag. This flag should be set
1193 * using fragment_set_partial_reassembly() before calling fragment_add
1194 * with the new fragment. FD_TOOLONGFRAGMENT and FD_MULTIPLETAILS flags
1195 * are lowered when a new extension process is started.
1198 fragment_add_work(fragment_head
*fd_head
, tvbuff_t
*tvb
, const int offset
,
1199 const packet_info
*pinfo
, const uint32_t frag_offset
,
1200 const uint32_t frag_data_len
, const bool more_frags
,
1201 const uint32_t frag_frame
, const bool allow_overlaps
)
1204 fragment_item
*fd_i
;
1205 uint32_t dfpos
, fraglen
, overlap
;
1206 tvbuff_t
*old_tvb_data
;
1209 /* create new fd describing this fragment */
1210 fd
= g_slice_new(fragment_item
);
1213 fd
->frame
= frag_frame
;
1214 fd
->offset
= frag_offset
;
1215 fd
->len
= frag_data_len
;
1216 fd
->tvb_data
= NULL
;
1219 * Are we adding to an already-completed reassembly?
1221 if (fd_head
->flags
& FD_DEFRAGMENTED
) {
1223 * Yes. Does this fragment go past the end of the results
1224 * of that reassembly?
1226 if (frag_offset
+ frag_data_len
> fd_head
->datalen
) {
1228 * Yes. Have we been requested to continue reassembly?
1230 if (fd_head
->flags
& FD_PARTIAL_REASSEMBLY
) {
1232 * Yes. Set flag in already empty fds &
1233 * point old fds to malloc'ed data.
1235 fragment_reset_defragmentation(fd_head
);
1236 } else if (!allow_overlaps
) {
1238 * No. Bail out since we have no idea what to
1239 * do with this fragment (and if we keep going
1240 * we'll run past the end of a buffer sooner
1243 g_slice_free(fragment_item
, fd
);
1246 * This is an attempt to add a fragment to a
1247 * reassembly that had already completed.
1248 * If it had no error, we don't want to
1249 * mark it with an error, and if it had an
1250 * error, we don't want to overwrite it, so
1251 * we don't set fd_head->error.
1253 if (frag_offset
>= fd_head
->datalen
) {
1255 * The fragment starts past the end
1256 * of the reassembled data.
1258 THROW_MESSAGE(ReassemblyError
, "New fragment past old data limits");
1261 * The fragment starts before the end
1262 * of the reassembled data, but
1263 * runs past the end. That could
1264 * just be a retransmission with extra
1265 * data, but the calling dissector
1266 * didn't set FD_PARTIAL_REASSEMBLY
1267 * so it won't be handled correctly.
1269 * XXX: We could set FD_TOOLONGFRAGMENT
1272 THROW_MESSAGE(ReassemblyError
, "New fragment overlaps old data (retransmission?)");
1277 * No. That means it overlaps the completed reassembly.
1278 * This is probably a retransmission and normal
1279 * behavior. (If not, it's because the dissector
1280 * doesn't handle reused sequence numbers correctly,
1281 * e.g. #10503). Handle below.
1286 /* Do this after we may have bailed out (above) so that we don't leave
1287 * fd_head->frame in a bad state if we do */
1288 if (fd
->frame
> fd_head
->frame
)
1289 fd_head
->frame
= fd
->frame
;
1293 * This is the tail fragment in the sequence.
1295 if (fd_head
->flags
& FD_DATALEN_SET
) {
1296 /* ok we have already seen other tails for this packet
1297 * it might be a duplicate.
1299 if (fd_head
->datalen
!= (fd
->offset
+ fd
->len
) ){
1300 /* Oops, this tail indicates a different packet
1301 * len than the previous ones. Something's wrong.
1303 fd
->flags
|= FD_MULTIPLETAILS
;
1304 fd_head
->flags
|= FD_MULTIPLETAILS
;
1307 /* This was the first tail fragment; now we know
1308 * what the length of the packet should be.
1310 fd_head
->datalen
= fd
->offset
+ fd
->len
;
1311 fd_head
->flags
|= FD_DATALEN_SET
;
1317 /* If the packet is already defragmented, this MUST be an overlap.
1318 * The entire defragmented packet is in fd_head->data.
1319 * Even if we have previously defragmented this packet, we still
1320 * check it. Someone might play overlap and TTL games.
1322 if (fd_head
->flags
& FD_DEFRAGMENTED
) {
1323 uint32_t end_offset
= fd
->offset
+ fd
->len
;
1324 fd
->flags
|= FD_OVERLAP
;
1325 fd_head
->flags
|= FD_OVERLAP
;
1326 /* make sure it's not too long */
1327 /* XXX: We probably don't call this, unlike the _seq()
1328 * functions, because we throw an exception above.
1330 if (end_offset
> fd_head
->datalen
|| end_offset
< fd
->offset
|| end_offset
< fd
->len
) {
1331 fd
->flags
|= FD_TOOLONGFRAGMENT
;
1332 fd_head
->flags
|= FD_TOOLONGFRAGMENT
;
1334 /* make sure it doesn't conflict with previous data */
1335 else if ( tvb_memeql(fd_head
->tvb_data
, fd
->offset
,
1336 tvb_get_ptr(tvb
,offset
,fd
->len
),fd
->len
) ){
1337 fd
->flags
|= FD_OVERLAPCONFLICT
;
1338 fd_head
->flags
|= FD_OVERLAPCONFLICT
;
1340 /* it was just an overlap, link it and return */
1341 LINK_FRAG(fd_head
,fd
);
1347 /* If we have reached this point, the packet is not defragmented yet.
1348 * Save all payload in a buffer until we can defragment.
1350 if (!tvb_bytes_exist(tvb
, offset
, fd
->len
)) {
1351 g_slice_free(fragment_item
, fd
);
1354 fd
->tvb_data
= tvb_clone_offset_len(tvb
, offset
, fd
->len
);
1355 LINK_FRAG(fd_head
,fd
);
1358 if( !(fd_head
->flags
& FD_DATALEN_SET
) ){
1359 /* if we don't know the datalen, there are still missing
1360 * packets. Cheaper than the check below.
1365 /* Check if we have received the entire fragment. */
1366 if (fd_head
->contiguous_len
< fd_head
->datalen
) {
1368 * The amount of contiguous data we have is less than the
1369 * amount of data we're trying to reassemble, so we haven't
1370 * received all packets yet.
1375 /* we have received an entire packet, defragment it and
1376 * free all fragments
1378 /* store old data just in case */
1379 old_tvb_data
=fd_head
->tvb_data
;
1380 data
= (uint8_t *) g_malloc(fd_head
->datalen
);
1381 fd_head
->tvb_data
= tvb_new_real_data(data
, fd_head
->datalen
, fd_head
->datalen
);
1382 tvb_set_free_cb(fd_head
->tvb_data
, g_free
);
1384 /* add all data fragments */
1385 for (dfpos
=0,fd_i
=fd_head
->next
;fd_i
;fd_i
=fd_i
->next
) {
1388 * The contiguous length check above also
1389 * ensures that the only gaps that exist here
1390 * are ones where a fragment starts past the
1391 * end of the reassembled datagram, and there's
1392 * a gap between the previous fragment and
1395 * A "DESEGMENT_UNTIL_FIN" was involved wherein the
1396 * FIN packet had an offset less than the highest
1397 * fragment offset seen. [Seen from a fuzz-test:
1400 * Note that the "overlap" compare must only be
1401 * done for fragments with (offset+len) <= fd_head->datalen
1402 * and thus within the newly g_malloc'd buffer.
1405 if (fd_i
->offset
>= fd_head
->datalen
) {
1407 * Fragment starts after the end
1408 * of the reassembled packet.
1410 * This can happen if the length was
1411 * set after the offending fragment
1412 * was added to the reassembly.
1414 * Flag this fragment, but don't
1415 * try to extract any data from
1416 * it, as there's no place to put
1419 * XXX - add different flag value
1422 fd_i
->flags
|= FD_TOOLONGFRAGMENT
;
1423 fd_head
->flags
|= FD_TOOLONGFRAGMENT
;
1424 } else if (fd_i
->offset
+ fd_i
->len
< fd_i
->offset
) {
1425 /* Integer overflow, unhandled by rest of
1426 * code so error out. This check handles
1427 * all possible remaining overflows.
1429 fd_head
->error
= "offset + len < offset";
1430 } else if (!fd_i
->tvb_data
) {
1431 fd_head
->error
= "no data";
1433 fraglen
= fd_i
->len
;
1434 if (fd_i
->offset
+ fraglen
> fd_head
->datalen
) {
1436 * Fragment goes past the end
1437 * of the packet, as indicated
1438 * by the last fragment.
1440 * This can happen if the
1441 * length was set after the
1442 * offending fragment was
1443 * added to the reassembly.
1445 * Mark it as such, and only
1446 * copy from it what fits in
1449 fd_i
->flags
|= FD_TOOLONGFRAGMENT
;
1450 fd_head
->flags
|= FD_TOOLONGFRAGMENT
;
1451 fraglen
= fd_head
->datalen
- fd_i
->offset
;
1453 overlap
= dfpos
- fd_i
->offset
;
1454 /* Guaranteed to be >= 0, previous code
1455 * has checked for gaps. */
1457 /* duplicate/retransmission/overlap */
1458 uint32_t cmp_len
= MIN(fd_i
->len
,overlap
);
1460 fd_i
->flags
|= FD_OVERLAP
;
1461 fd_head
->flags
|= FD_OVERLAP
;
1462 if ( memcmp(data
+ fd_i
->offset
,
1463 tvb_get_ptr(fd_i
->tvb_data
, 0, cmp_len
),
1466 fd_i
->flags
|= FD_OVERLAPCONFLICT
;
1467 fd_head
->flags
|= FD_OVERLAPCONFLICT
;
1470 /* XXX: As in the fragment_add_seq funcs
1471 * like fragment_defragment_and_free() the
1472 * existing behavior does not overwrite
1473 * overlapping bytes even if there is a
1474 * conflict. It only adds new bytes.
1476 * Since we only add fragments to a reassembly
1477 * if the reassembly isn't complete, the most
1478 * common case for overlap conflicts is when
1479 * an earlier reassembly isn't fully contained
1480 * in the capture, and we've reused an
1481 * indentification number / wrapped around
1482 * offset sequence numbers much later in the
1483 * capture. In that case, we probably *do*
1484 * want to overwrite conflicting bytes, since
1485 * the earlier fragments didn't form a complete
1486 * reassembly and should be effectively thrown
1487 * out rather than mixed with the new ones?
1489 if (fd_i
->offset
+ fraglen
> dfpos
) {
1491 tvb_get_ptr(fd_i
->tvb_data
, overlap
, fraglen
-overlap
),
1493 dfpos
= fd_i
->offset
+ fraglen
;
1497 if (fd_i
->flags
& FD_SUBSET_TVB
)
1498 fd_i
->flags
&= ~FD_SUBSET_TVB
;
1499 else if (fd_i
->tvb_data
)
1500 tvb_free(fd_i
->tvb_data
);
1502 fd_i
->tvb_data
=NULL
;
1507 tvb_add_to_chain(tvb
, old_tvb_data
);
1508 /* mark this packet as defragmented.
1509 allows us to skip any trailing fragments */
1510 fd_head
->flags
|= FD_DEFRAGMENTED
;
1511 fd_head
->reassembled_in
=pinfo
->num
;
1512 fd_head
->reas_in_layer_num
= pinfo
->curr_layer_num
;
1514 /* we don't throw until here to avoid leaking old_data and others */
1515 if (fd_head
->error
) {
1516 THROW_MESSAGE(ReassemblyError
, fd_head
->error
);
1522 static fragment_head
*
1523 fragment_add_common(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
1524 const packet_info
*pinfo
, const uint32_t id
,
1525 const void *data
, const uint32_t frag_offset
,
1526 const uint32_t frag_data_len
, const bool more_frags
,
1527 const bool check_already_added
,
1528 const uint32_t frag_frame
)
1530 fragment_head
*fd_head
;
1531 fragment_item
*fd_item
;
1536 * Dissector shouldn't give us garbage tvb info.
1538 * XXX - should this code take responsibility for preventing
1539 * reassembly if data is missing due to the packets being
1540 * sliced, rather than leaving it up to dissectors?
1542 DISSECTOR_ASSERT(tvb_bytes_exist(tvb
, offset
, frag_data_len
));
1544 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
1547 /* debug output of associated fragments. */
1548 /* leave it here for future debugging sessions */
1549 if(strcmp(pinfo
->current_proto
, "DCERPC") == 0) {
1550 printf("proto:%s num:%u id:%u offset:%u len:%u more:%u visited:%u\n",
1551 pinfo
->current_proto
, pinfo
->num
, id
, frag_offset
, frag_data_len
, more_frags
, pinfo
->fd
->visited
);
1552 if(fd_head
!= NULL
) {
1553 for(fd_item
=fd_head
->next
;fd_item
;fd_item
=fd_item
->next
){
1554 printf("fd_frame:%u fd_offset:%u len:%u datalen:%u\n",
1555 fd_item
->frame
, fd_item
->offset
, fd_item
->len
, fd_item
->datalen
);
1562 * Is this the first pass through the capture?
1564 if (!pinfo
->fd
->visited
) {
1566 * Yes, so we could be doing reassembly. If
1567 * "check_already_added" is true, and fd_head is non-null,
1568 * meaning that this fragment would be added to an
1569 * in-progress reassembly, check if we have seen this
1570 * fragment before, i.e., if we have already added it to
1571 * that reassembly. That can be true even on the first pass
1572 * since we sometimes might call a subdissector multiple
1575 * We check both the frame number and the fragment offset,
1576 * so that we support multiple fragments from the same
1577 * frame being added to the same reassembled PDU.
1579 if (check_already_added
&& fd_head
!= NULL
) {
1581 * fd_head->frame is the maximum of the frame
1582 * numbers of all the fragments added to this
1583 * reassembly; if this frame is later than that
1584 * frame, we know it hasn't been added yet.
1586 if (frag_frame
<= fd_head
->frame
) {
1587 already_added
= false;
1589 * The first item in the reassembly list
1590 * is not a fragment, it's a data structure
1591 * for the reassembled packet, so we
1592 * start checking with the next item.
1594 for (fd_item
= fd_head
->next
; fd_item
;
1595 fd_item
= fd_item
->next
) {
1596 if (frag_frame
== fd_item
->frame
&&
1597 frag_offset
== fd_item
->offset
) {
1598 already_added
= true;
1602 if (already_added
) {
1604 * Have we already finished
1607 if (fd_head
->flags
& FD_DEFRAGMENTED
) {
1610 * XXX - can this ever happen?
1612 THROW_MESSAGE(ReassemblyError
,
1613 "Frame already added in first pass");
1625 * No, so we've already done all the reassembly and added
1626 * all the fragments. Do we have a reassembly and, if so,
1627 * have we finished reassembling?
1629 if (fd_head
!= NULL
&& fd_head
->flags
& FD_DEFRAGMENTED
) {
1631 * Yes. This is probably being done after the
1632 * first pass, and we've already done the work
1633 * on the first pass.
1635 * If the reassembly got a fatal error, throw that
1639 THROW_MESSAGE(ReassemblyError
, fd_head
->error
);
1642 * Is it later in the capture than all of the
1643 * fragments in the reassembly?
1645 if (frag_frame
> fd_head
->frame
) {
1647 * Yes, so report this as a problem,
1648 * possibly a retransmission.
1650 THROW_MESSAGE(ReassemblyError
, "New fragment overlaps old data (retransmission?)");
1654 * Does this fragment go past the end of the
1655 * results of that reassembly?
1657 if (frag_offset
+ frag_data_len
> fd_head
->datalen
) {
1661 if (frag_offset
>= fd_head
->datalen
) {
1663 * The fragment starts past the
1664 * end of the reassembled data.
1666 THROW_MESSAGE(ReassemblyError
, "New fragment past old data limits");
1669 * The fragment starts before the end
1670 * of the reassembled data, but
1671 * runs past the end. That could
1672 * just be a retransmission.
1674 THROW_MESSAGE(ReassemblyError
, "New fragment overlaps old data (retransmission?)");
1688 /* not found, this must be the first snooped fragment for this
1689 * packet. Create list-head.
1691 fd_head
= new_head(0);
1694 * Insert it into the hash table.
1696 insert_fd_head(table
, fd_head
, pinfo
, id
, data
);
1699 if (fragment_add_work(fd_head
, tvb
, offset
, pinfo
, frag_offset
,
1700 frag_data_len
, more_frags
, frag_frame
, false)) {
1702 * Reassembly is complete.
1707 * Reassembly isn't complete.
1714 fragment_add(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
1715 const packet_info
*pinfo
, const uint32_t id
, const void *data
,
1716 const uint32_t frag_offset
, const uint32_t frag_data_len
,
1717 const bool more_frags
)
1719 return fragment_add_common(table
, tvb
, offset
, pinfo
, id
, data
,
1720 frag_offset
, frag_data_len
, more_frags
, true, pinfo
->num
);
1724 * For use when you can have multiple fragments in the same frame added
1725 * to the same reassembled PDU, e.g. with ONC RPC-over-TCP.
1728 fragment_add_multiple_ok(reassembly_table
*table
, tvbuff_t
*tvb
,
1729 const int offset
, const packet_info
*pinfo
,
1730 const uint32_t id
, const void *data
,
1731 const uint32_t frag_offset
,
1732 const uint32_t frag_data_len
, const bool more_frags
)
1734 return fragment_add_common(table
, tvb
, offset
, pinfo
, id
, data
,
1735 frag_offset
, frag_data_len
, more_frags
, false, pinfo
->num
);
1739 * For use in protocols like TCP when you are adding an out of order segment
1740 * that arrived in an earlier frame because the correct fragment id could not
1741 * be determined until later. By allowing fd->frame to be different than
1742 * pinfo->num, show_fragment_tree will display the correct fragment numbers.
1744 * Note that pinfo is still used to set reassembled_in if we have all the
1745 * fragments, so that results on subsequent passes can be the same as the
1749 fragment_add_out_of_order(reassembly_table
*table
, tvbuff_t
*tvb
,
1750 const int offset
, const packet_info
*pinfo
,
1751 const uint32_t id
, const void *data
,
1752 const uint32_t frag_offset
,
1753 const uint32_t frag_data_len
,
1754 const bool more_frags
, const uint32_t frag_frame
)
1756 return fragment_add_common(table
, tvb
, offset
, pinfo
, id
, data
,
1757 frag_offset
, frag_data_len
, more_frags
, true, frag_frame
);
1761 fragment_add_check_with_fallback(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
1762 const packet_info
*pinfo
, const uint32_t id
,
1763 const void *data
, const uint32_t frag_offset
,
1764 const uint32_t frag_data_len
, const bool more_frags
,
1765 const uint32_t fallback_frame
)
1767 reassembled_key reass_key
;
1768 fragment_head
*fd_head
;
1770 bool late_retransmission
= false;
1773 * If this isn't the first pass, look for this frame in the table
1774 * of reassembled packets.
1776 if (pinfo
->fd
->visited
) {
1777 reass_key
.frame
= pinfo
->num
;
1779 return (fragment_head
*)g_hash_table_lookup(table
->reassembled_table
, &reass_key
);
1782 /* Looks up a key in the GHashTable, returning the original key and the associated value
1783 * and a bool which is true if the key was found. This is useful if you need to free
1784 * the memory allocated for the original key, for example before calling g_hash_table_remove()
1786 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, &orig_key
);
1787 if ((fd_head
== NULL
) && (fallback_frame
!= pinfo
->num
)) {
1788 /* Check if there is completed reassembly reachable from fallback frame */
1789 reass_key
.frame
= fallback_frame
;
1791 fd_head
= (fragment_head
*)g_hash_table_lookup(table
->reassembled_table
, &reass_key
);
1792 if (fd_head
!= NULL
) {
1793 /* Found completely reassembled packet, hash it with current frame number */
1794 reassembled_key
*new_key
= g_slice_new(reassembled_key
);
1795 new_key
->frame
= pinfo
->num
;
1797 reassembled_table_insert(table
->reassembled_table
, new_key
, fd_head
);
1798 late_retransmission
= true;
1801 if (fd_head
== NULL
) {
1802 /* not found, this must be the first snooped fragment for this
1803 * packet. Create list-head.
1805 fd_head
= new_head(0);
1808 * Save the key, for unhashing it later.
1810 orig_key
= insert_fd_head(table
, fd_head
, pinfo
, id
, data
);
1814 * If this is a short frame, then we can't, and don't, do
1815 * reassembly on it. We just give up.
1817 if (!tvb_bytes_exist(tvb
, offset
, frag_data_len
)) {
1821 if (fragment_add_work(fd_head
, tvb
, offset
, pinfo
, frag_offset
,
1822 frag_data_len
, more_frags
, pinfo
->num
, late_retransmission
)) {
1823 /* Nothing left to do if it was a late retransmission */
1824 if (late_retransmission
) {
1828 * Reassembly is complete.
1829 * Remove this from the table of in-progress
1830 * reassemblies, add it to the table of
1831 * reassembled packets, and return it.
1835 * Remove this from the table of in-progress reassemblies,
1836 * and free up any memory used for it in that table.
1838 fragment_unhash(table
, orig_key
);
1841 * Add this item to the table of reassembled packets.
1843 fragment_reassembled(table
, fd_head
, pinfo
, id
);
1847 * Reassembly isn't complete.
1854 fragment_add_check(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
1855 const packet_info
*pinfo
, const uint32_t id
,
1856 const void *data
, const uint32_t frag_offset
,
1857 const uint32_t frag_data_len
, const bool more_frags
)
1859 return fragment_add_check_with_fallback(table
, tvb
, offset
, pinfo
, id
, data
,
1860 frag_offset
, frag_data_len
, more_frags
, pinfo
->num
);
1864 fragment_defragment_and_free (fragment_head
*fd_head
, const packet_info
*pinfo
)
1866 fragment_item
*fd_i
= NULL
;
1867 fragment_item
*last_fd
= NULL
;
1868 uint32_t dfpos
= 0, size
= 0;
1869 tvbuff_t
*old_tvb_data
= NULL
;
1872 for(fd_i
=fd_head
->next
;fd_i
;fd_i
=fd_i
->next
) {
1873 if(!last_fd
|| last_fd
->offset
!=fd_i
->offset
){
1879 /* store old data in case the fd_i->data pointers refer to it */
1880 old_tvb_data
=fd_head
->tvb_data
;
1881 data
= (uint8_t *) g_malloc(size
);
1882 fd_head
->tvb_data
= tvb_new_real_data(data
, size
, size
);
1883 tvb_set_free_cb(fd_head
->tvb_data
, g_free
);
1884 fd_head
->len
= size
; /* record size for caller */
1886 /* add all data fragments */
1888 for (fd_i
=fd_head
->next
; fd_i
; fd_i
=fd_i
->next
) {
1890 if(!last_fd
|| last_fd
->offset
!= fd_i
->offset
) {
1891 /* First fragment or in-sequence fragment */
1892 memcpy(data
+dfpos
, tvb_get_ptr(fd_i
->tvb_data
, 0, fd_i
->len
), fd_i
->len
);
1895 /* duplicate/retransmission/overlap */
1896 fd_i
->flags
|= FD_OVERLAP
;
1897 fd_head
->flags
|= FD_OVERLAP
;
1898 if(last_fd
->len
!= fd_i
->len
1899 || tvb_memeql(last_fd
->tvb_data
, 0, tvb_get_ptr(fd_i
->tvb_data
, 0, last_fd
->len
), last_fd
->len
) ) {
1900 fd_i
->flags
|= FD_OVERLAPCONFLICT
;
1901 fd_head
->flags
|= FD_OVERLAPCONFLICT
;
1908 /* we have defragmented the pdu, now free all fragments*/
1909 for (fd_i
=fd_head
->next
;fd_i
;fd_i
=fd_i
->next
) {
1910 if (fd_i
->flags
& FD_SUBSET_TVB
)
1911 fd_i
->flags
&= ~FD_SUBSET_TVB
;
1912 else if (fd_i
->tvb_data
)
1913 tvb_free(fd_i
->tvb_data
);
1914 fd_i
->tvb_data
=NULL
;
1917 tvb_free(old_tvb_data
);
1919 /* mark this packet as defragmented.
1920 * allows us to skip any trailing fragments.
1922 fd_head
->flags
|= FD_DEFRAGMENTED
;
1923 fd_head
->reassembled_in
=pinfo
->num
;
1924 fd_head
->reas_in_layer_num
= pinfo
->curr_layer_num
;
1928 * This function adds a new fragment to the entry for a reassembly
1931 * The list of fragments for a specific datagram is kept sorted for
1934 * Returns true if we have all the fragments, false otherwise.
1936 * This function assumes frag_number being a block sequence number.
1937 * The bsn for the first block is 0.
1940 fragment_add_seq_work(fragment_head
*fd_head
, tvbuff_t
*tvb
, const int offset
,
1941 const packet_info
*pinfo
, const uint32_t frag_number
,
1942 const uint32_t frag_data_len
, const bool more_frags
)
1945 fragment_item
*fd_i
;
1946 fragment_item
*last_fd
;
1947 uint32_t max
, dfpos
;
1948 uint32_t frag_number_work
;
1950 /* Enables the use of fragment sequence numbers, which do not start with 0 */
1951 frag_number_work
= frag_number
;
1952 if ( fd_head
->fragment_nr_offset
!= 0 )
1953 if ( frag_number_work
>= fd_head
->fragment_nr_offset
)
1954 frag_number_work
= frag_number
- fd_head
->fragment_nr_offset
;
1956 /* if the partial reassembly flag has been set, and we are extending
1957 * the pdu, un-reassemble the pdu. This means pointing old fds to malloc'ed data.
1959 if(fd_head
->flags
& FD_DEFRAGMENTED
&& frag_number_work
>= fd_head
->datalen
&&
1960 fd_head
->flags
& FD_PARTIAL_REASSEMBLY
){
1961 uint32_t lastdfpos
= 0;
1963 for(fd_i
=fd_head
->next
; fd_i
; fd_i
=fd_i
->next
){
1964 if( !fd_i
->tvb_data
) {
1965 if( fd_i
->flags
& FD_OVERLAP
) {
1966 /* this is a duplicate of the previous
1968 fd_i
->tvb_data
= tvb_new_subset_remaining(fd_head
->tvb_data
, lastdfpos
);
1970 fd_i
->tvb_data
= tvb_new_subset_remaining(fd_head
->tvb_data
, dfpos
);
1974 fd_i
->flags
|= FD_SUBSET_TVB
;
1976 fd_i
->flags
&= (~FD_TOOLONGFRAGMENT
) & (~FD_MULTIPLETAILS
);
1978 fd_head
->flags
&= ~(FD_DEFRAGMENTED
|FD_PARTIAL_REASSEMBLY
|FD_DATALEN_SET
);
1979 fd_head
->flags
&= (~FD_TOOLONGFRAGMENT
) & (~FD_MULTIPLETAILS
);
1981 fd_head
->reassembled_in
=0;
1982 fd_head
->reas_in_layer_num
= 0;
1986 /* create new fd describing this fragment */
1987 fd
= g_slice_new(fragment_item
);
1990 fd
->frame
= pinfo
->num
;
1991 fd
->offset
= frag_number_work
;
1992 fd
->len
= frag_data_len
;
1993 fd
->tvb_data
= NULL
;
1995 /* fd_head->frame is the maximum of the frame numbers of all the
1996 * fragments added to the reassembly. */
1997 if (fd
->frame
> fd_head
->frame
)
1998 fd_head
->frame
= fd
->frame
;
2002 * This is the tail fragment in the sequence.
2004 if (fd_head
->flags
&FD_DATALEN_SET
) {
2005 /* ok we have already seen other tails for this packet
2006 * it might be a duplicate.
2008 if (fd_head
->datalen
!= fd
->offset
){
2009 /* Oops, this tail indicates a different packet
2010 * len than the previous ones. Something's wrong.
2012 fd
->flags
|= FD_MULTIPLETAILS
;
2013 fd_head
->flags
|= FD_MULTIPLETAILS
;
2016 /* this was the first tail fragment, now we know the
2017 * sequence number of that fragment (which is NOT
2018 * the length of the packet!)
2020 fd_head
->datalen
= fd
->offset
;
2021 fd_head
->flags
|= FD_DATALEN_SET
;
2025 /* If the packet is already defragmented, this MUST be an overlap.
2026 * The entire defragmented packet is in fd_head->data
2027 * Even if we have previously defragmented this packet, we still check
2028 * check it. Someone might play overlap and TTL games.
2030 if (fd_head
->flags
& FD_DEFRAGMENTED
) {
2031 fd
->flags
|= FD_OVERLAP
;
2032 fd_head
->flags
|= FD_OVERLAP
;
2034 /* make sure it's not past the end */
2035 if (fd
->offset
> fd_head
->datalen
) {
2036 /* new fragment comes after the end */
2037 fd
->flags
|= FD_TOOLONGFRAGMENT
;
2038 fd_head
->flags
|= FD_TOOLONGFRAGMENT
;
2039 LINK_FRAG(fd_head
,fd
);
2042 /* make sure it doesn't conflict with previous data */
2045 for (fd_i
=fd_head
->next
;fd_i
&& (fd_i
->offset
!=fd
->offset
);fd_i
=fd_i
->next
) {
2046 if (!last_fd
|| last_fd
->offset
!=fd_i
->offset
){
2052 /* new fragment overlaps existing fragment */
2053 if(fd_i
->len
!=fd
->len
){
2055 * They have different lengths; this
2056 * is definitely a conflict.
2058 fd
->flags
|= FD_OVERLAPCONFLICT
;
2059 fd_head
->flags
|= FD_OVERLAPCONFLICT
;
2060 LINK_FRAG(fd_head
,fd
);
2063 DISSECTOR_ASSERT(fd_head
->len
>= dfpos
+ fd
->len
);
2064 if (tvb_memeql(fd_head
->tvb_data
, dfpos
,
2065 tvb_get_ptr(tvb
,offset
,fd
->len
),fd
->len
) ){
2067 * They have the same length, but the
2068 * data isn't the same.
2070 fd
->flags
|= FD_OVERLAPCONFLICT
;
2071 fd_head
->flags
|= FD_OVERLAPCONFLICT
;
2072 LINK_FRAG(fd_head
,fd
);
2075 /* it was just an overlap, link it and return */
2076 LINK_FRAG(fd_head
,fd
);
2080 * New fragment doesn't overlap an existing
2081 * fragment - there was presumably a gap in
2082 * the sequence number space.
2084 * XXX - what should we do here? Is it always
2085 * the case that there are no gaps, or are there
2086 * protcols using sequence numbers where there
2089 * If the former, the check below for having
2090 * received all the fragments should check for
2091 * holes in the sequence number space and for the
2092 * first sequence number being 0. If we do that,
2093 * the only way we can get here is if this fragment
2094 * is past the end of the sequence number space -
2095 * but the check for "fd->offset > fd_head->datalen"
2096 * would have caught that above, so it can't happen.
2098 * If the latter, we don't have a good way of
2099 * knowing whether reassembly is complete if we
2100 * get packet out of order such that the "last"
2101 * fragment doesn't show up last - but, unless
2102 * in-order reliable delivery of fragments is
2103 * guaranteed, an implementation of the protocol
2104 * has no way of knowing whether reassembly is
2107 * For now, we just link the fragment in and
2110 LINK_FRAG(fd_head
,fd
);
2115 /* If we have reached this point, the packet is not defragmented yet.
2116 * Save all payload in a buffer until we can defragment.
2118 /* check len, there may be a fragment with 0 len, that is actually the tail */
2120 if (!tvb_bytes_exist(tvb
, offset
, fd
->len
)) {
2121 /* abort if we didn't capture the entire fragment due
2122 * to a too-short snapshot length */
2123 g_slice_free(fragment_item
, fd
);
2127 fd
->tvb_data
= tvb_clone_offset_len(tvb
, offset
, fd
->len
);
2129 LINK_FRAG(fd_head
,fd
);
2132 if( !(fd_head
->flags
& FD_DATALEN_SET
) ){
2133 /* if we don't know the sequence number of the last fragment,
2134 * there are definitely still missing packets. Cheaper than
2141 /* check if we have received the entire fragment
2142 * this is easy since the list is sorted and the head is faked.
2143 * common case the whole list is scanned.
2146 for(fd_i
=fd_head
->next
;fd_i
;fd_i
=fd_i
->next
) {
2147 if ( fd_i
->offset
==max
){
2151 /* max will now be datalen+1 if all fragments have been seen */
2153 if (max
<= fd_head
->datalen
) {
2154 /* we have not received all packets yet */
2159 if (max
> (fd_head
->datalen
+1)) {
2160 /* oops, too long fragment detected */
2161 fd
->flags
|= FD_TOOLONGFRAGMENT
;
2162 fd_head
->flags
|= FD_TOOLONGFRAGMENT
;
2166 /* we have received an entire packet, defragment it and
2167 * free all fragments
2169 fragment_defragment_and_free(fd_head
, pinfo
);
2175 * This function adds a new fragment to the fragment hash table.
2176 * If this is the first fragment seen for this datagram, a new entry
2177 * is created in the hash table, otherwise this fragment is just added
2178 * to the linked list of fragments for this packet.
2180 * Returns a pointer to the head of the fragment data list if we have all the
2181 * fragments, NULL otherwise.
2183 * This function assumes frag_number being a block sequence number.
2184 * The bsn for the first block is 0.
2186 static fragment_head
*
2187 fragment_add_seq_common(reassembly_table
*table
, tvbuff_t
*tvb
,
2188 const int offset
, const packet_info
*pinfo
,
2189 const uint32_t id
, const void *data
,
2190 uint32_t frag_number
, const uint32_t frag_data_len
,
2191 const bool more_frags
, const uint32_t flags
,
2194 fragment_head
*fd_head
;
2197 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, &orig_key
);
2199 /* have we already seen this frame ?*/
2200 if (pinfo
->fd
->visited
) {
2201 if (fd_head
!= NULL
&& fd_head
->flags
& FD_DEFRAGMENTED
) {
2202 if (orig_keyp
!= NULL
)
2203 *orig_keyp
= orig_key
;
2211 /* not found, this must be the first snooped fragment for this
2212 * packet. Create list-head.
2214 fd_head
= new_head(FD_BLOCKSEQUENCE
);
2216 if((flags
& (REASSEMBLE_FLAGS_NO_FRAG_NUMBER
|REASSEMBLE_FLAGS_802_11_HACK
))
2219 * This is the last fragment for this packet, and
2220 * is the only one we've seen.
2222 * Either we don't have sequence numbers, in which
2223 * case we assume this is the first fragment for
2224 * this packet, or we're doing special 802.11
2225 * processing, in which case we assume it's one
2226 * of those reassembled packets with a non-zero
2227 * fragment number (see packet-80211.c); just
2228 * return a pointer to the head of the list;
2229 * fragment_add_seq_check will then add it to the table
2230 * of reassembled packets.
2232 if (orig_keyp
!= NULL
)
2234 fd_head
->reassembled_in
=pinfo
->num
;
2235 fd_head
->reas_in_layer_num
= pinfo
->curr_layer_num
;
2239 orig_key
= insert_fd_head(table
, fd_head
, pinfo
, id
, data
);
2240 if (orig_keyp
!= NULL
)
2241 *orig_keyp
= orig_key
;
2244 * If we weren't given an initial fragment number,
2247 if (flags
& REASSEMBLE_FLAGS_NO_FRAG_NUMBER
)
2250 if (orig_keyp
!= NULL
)
2251 *orig_keyp
= orig_key
;
2253 if (flags
& REASSEMBLE_FLAGS_NO_FRAG_NUMBER
) {
2256 * If we weren't given an initial fragment number,
2257 * use the next expected fragment number as the fragment
2258 * number for this fragment.
2260 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
) {
2261 if (fd
->next
== NULL
)
2262 frag_number
= fd
->offset
+ 1;
2267 if (fragment_add_seq_work(fd_head
, tvb
, offset
, pinfo
,
2268 frag_number
, frag_data_len
, more_frags
)) {
2270 * Reassembly is complete.
2275 * Reassembly isn't complete.
2282 fragment_add_seq(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
2283 const packet_info
*pinfo
, const uint32_t id
, const void *data
,
2284 const uint32_t frag_number
, const uint32_t frag_data_len
,
2285 const bool more_frags
, const uint32_t flags
)
2287 return fragment_add_seq_common(table
, tvb
, offset
, pinfo
, id
, data
,
2288 frag_number
, frag_data_len
,
2289 more_frags
, flags
, NULL
);
2293 * This does the work for "fragment_add_seq_check()" and
2294 * "fragment_add_seq_next()".
2296 * This function assumes frag_number being a block sequence number.
2297 * The bsn for the first block is 0.
2299 * If REASSEMBLE_FLAGS_NO_FRAG_NUMBER, it uses the next expected fragment number
2300 * as the fragment number if there is a reassembly in progress, otherwise
2303 * If not REASSEMBLE_FLAGS_NO_FRAG_NUMBER, it uses the "frag_number" argument as
2304 * the fragment number.
2306 * If this is the first fragment seen for this datagram, a new
2307 * "fragment_head" structure is allocated to refer to the reassembled
2310 * This fragment is added to the linked list of fragments for this packet.
2312 * If "more_frags" is false and REASSEMBLE_FLAGS_802_11_HACK (as the name
2313 * implies, a special hack for 802.11) or REASSEMBLE_FLAGS_NO_FRAG_NUMBER
2314 * (implying messages must be in order since there's no sequence number) are
2315 * set in "flags", then this (one element) list is returned.
2317 * If, after processing this fragment, we have all the fragments,
2318 * "fragment_add_seq_check_work()" removes that from the fragment hash
2319 * table if necessary and adds it to the table of reassembled fragments,
2320 * and returns a pointer to the head of the fragment list.
2322 * Otherwise, it returns NULL.
2324 * XXX - Should we simply return NULL for zero-length fragments?
2326 static fragment_head
*
2327 fragment_add_seq_check_work(reassembly_table
*table
, tvbuff_t
*tvb
,
2328 const int offset
, const packet_info
*pinfo
,
2329 const uint32_t id
, const void *data
,
2330 const uint32_t frag_number
,
2331 const uint32_t frag_data_len
,
2332 const bool more_frags
, const uint32_t flags
)
2334 reassembled_key reass_key
;
2335 fragment_head
*fd_head
;
2339 * Have we already seen this frame?
2340 * If so, look for it in the table of reassembled packets.
2342 if (pinfo
->fd
->visited
) {
2343 reass_key
.frame
= pinfo
->num
;
2345 return (fragment_head
*)g_hash_table_lookup(table
->reassembled_table
, &reass_key
);
2348 fd_head
= fragment_add_seq_common(table
, tvb
, offset
, pinfo
, id
, data
,
2349 frag_number
, frag_data_len
,
2355 * Reassembly is complete.
2357 * If this is in the table of in-progress reassemblies,
2358 * remove it from that table. (It could be that this
2359 * was the first and last fragment, so that no
2360 * reassembly was done.)
2362 if (orig_key
!= NULL
)
2363 fragment_unhash(table
, orig_key
);
2366 * Add this item to the table of reassembled packets.
2368 fragment_reassembled(table
, fd_head
, pinfo
, id
);
2372 * Reassembly isn't complete.
2379 fragment_add_seq_check(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
2380 const packet_info
*pinfo
, const uint32_t id
,
2382 const uint32_t frag_number
, const uint32_t frag_data_len
,
2383 const bool more_frags
)
2385 return fragment_add_seq_check_work(table
, tvb
, offset
, pinfo
, id
, data
,
2386 frag_number
, frag_data_len
,
2391 fragment_add_seq_802_11(reassembly_table
*table
, tvbuff_t
*tvb
,
2392 const int offset
, const packet_info
*pinfo
,
2393 const uint32_t id
, const void *data
,
2394 const uint32_t frag_number
, const uint32_t frag_data_len
,
2395 const bool more_frags
)
2397 return fragment_add_seq_check_work(table
, tvb
, offset
, pinfo
, id
, data
,
2398 frag_number
, frag_data_len
,
2400 REASSEMBLE_FLAGS_802_11_HACK
);
2404 fragment_add_seq_next(reassembly_table
*table
, tvbuff_t
*tvb
, const int offset
,
2405 const packet_info
*pinfo
, const uint32_t id
,
2406 const void *data
, const uint32_t frag_data_len
,
2407 const bool more_frags
)
2409 /* Use a dummy frag_number (0), it is ignored since
2410 * REASSEMBLE_FLAGS_NO_FRAG_NUMBER is set. */
2411 return fragment_add_seq_check_work(table
, tvb
, offset
, pinfo
, id
, data
,
2412 0, frag_data_len
, more_frags
,
2413 REASSEMBLE_FLAGS_NO_FRAG_NUMBER
);
2417 fragment_add_seq_single_move(reassembly_table
*table
, const packet_info
*pinfo
,
2418 const uint32_t id
, const void *data
,
2419 const uint32_t offset
)
2421 fragment_head
*fh
, *new_fh
;
2422 fragment_item
*fd
, *prev_fd
;
2423 tvbuff_t
*old_tvb_data
;
2427 fh
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
2429 /* Shouldn't be called this way.
2430 * Probably wouldn't hurt to just create fh in this case. */
2431 ws_assert_not_reached();
2434 if (fh
->flags
& FD_DATALEN_SET
&& fh
->datalen
<= offset
) {
2435 /* Don't take from past the end. <= because we don't
2436 * want to take a First fragment from the next one
2440 new_fh
= lookup_fd_head(table
, pinfo
, id
+offset
, data
, NULL
);
2441 if (new_fh
!= NULL
) {
2442 /* Attach to the end of the sorted list. */
2444 for(fd
= fh
->next
; fd
!= NULL
; fd
=fd
->next
) {
2447 /* Don't take a reassembly starting with a First fragment. */
2449 if (fd
&& fd
->offset
!= 0) {
2450 fragment_item
*inserted
= fd
;
2451 bool multi_insert
= (inserted
->next
!= NULL
);
2457 for (; fd
; fd
=fd
->next
) {
2458 fd
->offset
+= offset
;
2459 if (fh
->frame
< fd
->frame
) {
2460 fh
->frame
= fd
->frame
;
2463 update_first_gap(fh
, inserted
, multi_insert
);
2464 /* If previously found a Last fragment,
2465 * transfer that info to the new one. */
2466 if (new_fh
->flags
& FD_DATALEN_SET
) {
2467 fh
->flags
|= FD_DATALEN_SET
;
2468 fh
->datalen
= new_fh
->datalen
+ offset
;
2470 /* Now remove and delete */
2471 new_fh
->next
= NULL
;
2472 old_tvb_data
= fragment_delete(table
, pinfo
, id
+offset
, data
);
2474 tvb_free(old_tvb_data
);
2479 static fragment_head
*
2480 fragment_add_seq_single_work(reassembly_table
*table
, tvbuff_t
*tvb
,
2481 const int offset
, const packet_info
*pinfo
,
2482 const uint32_t id
, const void* data
,
2483 const uint32_t frag_data_len
,
2484 const bool first
, const bool last
,
2485 const uint32_t max_frags
, const uint32_t max_age
,
2486 const uint32_t flags
)
2488 reassembled_key reass_key
;
2489 tvbuff_t
*old_tvb_data
;
2491 fragment_head
*fh
, *new_fh
;
2492 fragment_item
*fd
, *prev_fd
;
2493 uint32_t frag_number
, tmp_offset
;
2494 /* Have we already seen this frame?
2495 * If so, look for it in the table of reassembled packets.
2496 * Note here we store in the reassembly table by the single sequence
2497 * number rather than the sequence number of the First fragment. */
2498 if (pinfo
->fd
->visited
) {
2499 reass_key
.frame
= pinfo
->num
;
2501 fh
= (fragment_head
*)g_hash_table_lookup(table
->reassembled_table
, &reass_key
);
2504 /* First let's figure out where we want to add our new fragment */
2508 fh
= lookup_fd_head(table
, pinfo
, id
-frag_number
, data
, NULL
);
2509 if ((flags
& REASSEMBLE_FLAGS_AGING
) &&
2510 fh
&& ((fh
->frame
+ max_age
) < pinfo
->num
)) {
2511 old_tvb_data
= fragment_delete(table
, pinfo
, id
-frag_number
, data
);
2513 tvb_free(old_tvb_data
);
2517 /* Not found. Create list-head. */
2518 fh
= new_head(FD_BLOCKSEQUENCE
);
2519 insert_fd_head(table
, fh
, pinfo
, id
-frag_number
, data
);
2521 /* As this is the first fragment, we might have added segments
2522 * for this reassembly to the previous one in-progress. */
2524 for (frag_number
=1; frag_number
< max_frags
; frag_number
++) {
2525 new_fh
= lookup_fd_head(table
, pinfo
, id
-frag_number
, data
, NULL
);
2526 if (new_fh
!= NULL
) {
2529 for (fd
=new_fh
->next
; fd
&& fd
->offset
< frag_number
; fd
=fd
->next
) {
2531 if (new_fh
->frame
< fd
->frame
) {
2532 new_fh
->frame
= fd
->frame
;
2536 prev_fd
->next
= NULL
;
2538 new_fh
->next
= NULL
;
2540 fragment_items_removed(new_fh
, prev_fd
);
2546 for (prev_fd
= fd
; prev_fd
; prev_fd
= prev_fd
->next
) {
2547 prev_fd
->offset
-= frag_number
;
2548 tmp_offset
= prev_fd
->offset
;
2549 if (fh
->frame
< prev_fd
->frame
) {
2550 fh
->frame
= prev_fd
->frame
;
2554 if (new_fh
!= NULL
) {
2555 /* If we've moved a Last packet, change datalen.
2556 * Second part of this test prob. redundant? */
2557 if (new_fh
->flags
& FD_DATALEN_SET
&&
2558 new_fh
->datalen
>= frag_number
) {
2559 fh
->flags
|= FD_DATALEN_SET
;
2560 fh
->datalen
= new_fh
->datalen
- frag_number
;
2561 new_fh
->flags
&= ~FD_DATALEN_SET
;
2562 new_fh
->datalen
= 0;
2564 /* If we've moved all the fragments,
2565 * delete the old head */
2566 if (new_fh
->next
== NULL
) {
2567 old_tvb_data
= fragment_delete(table
, pinfo
, id
-frag_number
, data
);
2569 tvb_free(old_tvb_data
);
2572 /* Look forward and take off the next (this is
2573 * necessary in some edge cases where max_frags
2574 * prevented some fragments from going on the
2575 * previous First, but they can go on this one. */
2576 fragment_add_seq_single_move(table
, pinfo
, id
,
2580 frag_number
= 0; /* For the rest of the function */
2582 for (frag_number
=1; frag_number
< max_frags
; frag_number
++) {
2583 fh
= lookup_fd_head(table
, pinfo
, id
-frag_number
, data
, NULL
);
2584 if ((flags
& REASSEMBLE_FLAGS_AGING
) &&
2585 fh
&& ((fh
->frame
+ max_age
) < pinfo
->num
)) {
2586 old_tvb_data
= fragment_delete(table
, pinfo
, id
-frag_number
, data
);
2588 tvb_free(old_tvb_data
);
2592 if (fh
->flags
& FD_DATALEN_SET
&&
2593 fh
->datalen
< frag_number
) {
2594 /* This fragment is after the Last
2595 * fragment, so must go after here. */
2601 if (fh
== NULL
) { /* Didn't find location, use default */
2603 /* Already looked for frag_number 1, so just create */
2604 fh
= new_head(FD_BLOCKSEQUENCE
);
2605 insert_fd_head(table
, fh
, pinfo
, id
-frag_number
, data
);
2609 /* Look for fragments past the end set by this Last fragment. */
2611 for (fd
=fh
->next
; fd
&& fd
->offset
<= frag_number
; fd
=fd
->next
) {
2614 /* fd is now all fragments offset > frag_number (the Last).
2615 * It shouldn't have a fragment with offset frag_number+1,
2616 * as that would be a First fragment not marked as such.
2617 * However, this can happen if we had unreassembled fragments
2618 * (missing, or at the start of the capture) and we've also
2619 * looped around on the sequence numbers. It can also happen
2620 * if bit errors mess up Last or First. */
2623 prev_fd
->next
= NULL
;
2627 fragment_items_removed(fh
, prev_fd
);
2629 for (prev_fd
=fh
->next
; prev_fd
; prev_fd
=prev_fd
->next
) {
2630 if (fh
->frame
< prev_fd
->frame
) {
2631 fh
->frame
= prev_fd
->frame
;
2634 while (fd
&& fd
->offset
== frag_number
+1) {
2635 /* Definitely have bad data here. Best to
2636 * delete these and leave unreassembled. */
2637 fragment_item
*tmp_fd
;
2640 if (fd
->tvb_data
&& !(fd
->flags
& FD_SUBSET_TVB
))
2641 tvb_free(fd
->tvb_data
);
2642 g_slice_free(fragment_item
, fd
);
2647 /* Move these onto the next frame. */
2648 new_fh
= lookup_fd_head(table
, pinfo
, id
+1, data
, NULL
);
2650 /* Not found. Create list-head. */
2651 new_fh
= new_head(FD_BLOCKSEQUENCE
);
2652 insert_fd_head(table
, new_fh
, pinfo
, id
+1, data
);
2655 for (prev_fd
= fd
; prev_fd
; prev_fd
= prev_fd
->next
) {
2656 prev_fd
->offset
-= (frag_number
+1);
2657 tmp_offset
= prev_fd
->offset
;
2658 if (new_fh
->frame
< fd
->frame
) {
2659 new_fh
->frame
= fd
->frame
;
2662 MERGE_FRAG(new_fh
, fd
);
2663 /* If we previously found a different Last fragment,
2664 * transfer that information to the new reassembly. */
2665 if (fh
->flags
& FD_DATALEN_SET
&&
2666 fh
->datalen
> frag_number
) {
2667 new_fh
->flags
|= FD_DATALEN_SET
;
2668 new_fh
->datalen
= fh
->datalen
- (frag_number
+1);
2669 fh
->flags
&= ~FD_DATALEN_SET
;
2672 /* Look forward and take off the next (this is
2673 * necessary in some edge cases where max_frags
2674 * prevented some fragments from going on the
2675 * previous First, but they can go on this one. */
2676 fragment_add_seq_single_move(table
, pinfo
, id
+1,
2681 fragment_add_seq_single_move(table
, pinfo
, id
-frag_number
, data
,
2684 /* Having cleaned up everything, finally ready to add our new
2685 * fragment. Note that only this will ever complete a reassembly. */
2686 fh
= fragment_add_seq_common(table
, tvb
, offset
, pinfo
,
2687 id
-frag_number
, data
,
2688 frag_number
, frag_data_len
,
2689 !last
, 0, &orig_key
);
2692 * Reassembly is complete.
2694 * If this is in the table of in-progress reassemblies,
2695 * remove it from that table. (It could be that this
2696 * was the first and last fragment, so that no
2697 * reassembly was done.)
2699 if (orig_key
!= NULL
)
2700 fragment_unhash(table
, orig_key
);
2703 * Add this item to the table of reassembled packets.
2705 fragment_reassembled_single(table
, fh
, pinfo
, id
-frag_number
);
2709 * Reassembly isn't complete.
2716 fragment_add_seq_single(reassembly_table
*table
, tvbuff_t
*tvb
,
2717 const int offset
, const packet_info
*pinfo
,
2718 const uint32_t id
, const void* data
,
2719 const uint32_t frag_data_len
,
2720 const bool first
, const bool last
,
2721 const uint32_t max_frags
)
2723 return fragment_add_seq_single_work(table
, tvb
, offset
, pinfo
,
2724 id
, data
, frag_data_len
,
2725 first
, last
, max_frags
, 0, 0);
2729 fragment_add_seq_single_aging(reassembly_table
*table
, tvbuff_t
*tvb
,
2730 const int offset
, const packet_info
*pinfo
,
2731 const uint32_t id
, const void* data
,
2732 const uint32_t frag_data_len
,
2733 const bool first
, const bool last
,
2734 const uint32_t max_frags
, const uint32_t max_age
)
2736 return fragment_add_seq_single_work(table
, tvb
, offset
, pinfo
,
2737 id
, data
, frag_data_len
,
2738 first
, last
, max_frags
, max_age
,
2739 REASSEMBLE_FLAGS_AGING
);
2743 fragment_start_seq_check(reassembly_table
*table
, const packet_info
*pinfo
,
2744 const uint32_t id
, const void *data
,
2745 const uint32_t tot_len
)
2747 fragment_head
*fd_head
;
2749 /* Have we already seen this frame ?*/
2750 if (pinfo
->fd
->visited
) {
2754 /* Check if fragment data exists */
2755 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, NULL
);
2757 if (fd_head
== NULL
) {
2758 /* Create list-head. */
2759 fd_head
= g_slice_new(fragment_head
);
2760 fd_head
->next
= NULL
;
2761 fd_head
->first_gap
= NULL
;
2762 fd_head
->contiguous_len
= 0;
2765 fd_head
->fragment_nr_offset
= 0;
2766 fd_head
->datalen
= tot_len
;
2767 fd_head
->reassembled_in
= 0;
2768 fd_head
->reas_in_layer_num
= 0;
2769 fd_head
->flags
= FD_BLOCKSEQUENCE
|FD_DATALEN_SET
;
2770 fd_head
->tvb_data
= NULL
;
2771 fd_head
->error
= NULL
;
2773 insert_fd_head(table
, fd_head
, pinfo
, id
, data
);
2778 fragment_end_seq_next(reassembly_table
*table
, const packet_info
*pinfo
,
2779 const uint32_t id
, const void *data
)
2781 reassembled_key reass_key
;
2782 reassembled_key
*new_key
;
2783 fragment_head
*fd_head
;
2786 uint32_t max_offset
= 0;
2789 * Have we already seen this frame?
2790 * If so, look for it in the table of reassembled packets.
2792 if (pinfo
->fd
->visited
) {
2793 reass_key
.frame
= pinfo
->num
;
2795 return (fragment_head
*)g_hash_table_lookup(table
->reassembled_table
, &reass_key
);
2798 fd_head
= lookup_fd_head(table
, pinfo
, id
, data
, &orig_key
);
2801 for (fd
= fd_head
->next
; fd
; fd
= fd
->next
) {
2802 if (fd
->offset
> max_offset
) {
2803 max_offset
= fd
->offset
;
2806 fd_head
->datalen
= max_offset
;
2807 fd_head
->flags
|= FD_DATALEN_SET
;
2809 fragment_defragment_and_free (fd_head
, pinfo
);
2812 * Remove this from the table of in-progress reassemblies,
2813 * and free up any memory used for it in that table.
2815 fragment_unhash(table
, orig_key
);
2818 * Add this item to the table of reassembled packets.
2820 fragment_reassembled(table
, fd_head
, pinfo
, id
);
2821 if (fd_head
->next
!= NULL
) {
2822 new_key
= g_slice_new(reassembled_key
);
2823 new_key
->frame
= pinfo
->num
;
2825 reassembled_table_insert(table
->reassembled_table
, new_key
, fd_head
);
2831 * Fragment data not found.
2838 * Process reassembled data; if we're on the frame in which the data
2839 * was reassembled, put the fragment information into the protocol
2840 * tree, and construct a tvbuff with the reassembled data, otherwise
2841 * just put a "reassembled in" item into the protocol tree.
2842 * offset from start of tvb, result up to end of tvb
2845 process_reassembled_data(tvbuff_t
*tvb
, const int offset
, packet_info
*pinfo
,
2846 const char *name
, fragment_head
*fd_head
, const fragment_items
*fit
,
2847 bool *update_col_infop
, proto_tree
*tree
)
2850 bool update_col_info
;
2851 proto_item
*frag_tree_item
;
2853 if (fd_head
!= NULL
&& pinfo
->num
== fd_head
->reassembled_in
&& pinfo
->curr_layer_num
== fd_head
->reas_in_layer_num
) {
2855 * OK, we've reassembled this.
2856 * Is this something that's been reassembled from more
2857 * than one fragment?
2859 if (fd_head
->next
!= NULL
) {
2862 * Allocate a new tvbuff, referring to the
2863 * reassembled payload, and set
2864 * the tvbuff to the list of tvbuffs to which
2865 * the tvbuff we were handed refers, so it'll get
2866 * cleaned up when that tvbuff is cleaned up.
2868 next_tvb
= tvb_new_chain(tvb
, fd_head
->tvb_data
);
2870 /* Add the defragmented data to the data source list. */
2871 add_new_data_source(pinfo
, next_tvb
, name
);
2873 /* show all fragments */
2874 if (fd_head
->flags
& FD_BLOCKSEQUENCE
) {
2875 update_col_info
= !show_fragment_seq_tree(
2876 fd_head
, fit
, tree
, pinfo
, next_tvb
, &frag_tree_item
);
2878 update_col_info
= !show_fragment_tree(fd_head
,
2879 fit
, tree
, pinfo
, next_tvb
, &frag_tree_item
);
2884 * Return a tvbuff with the payload. next_tvb is from offset until end
2885 * XXX - The length of next_tvb should be truncated to the data len
2886 * given in the sole "fragment_" call (should be stored in fd_head.)
2888 next_tvb
= tvb_new_subset_remaining(tvb
, offset
);
2889 pinfo
->fragmented
= false; /* one-fragment packet */
2890 update_col_info
= true;
2892 if (update_col_infop
!= NULL
)
2893 *update_col_infop
= update_col_info
;
2896 * We don't have the complete reassembled payload, or this
2897 * isn't the final frame of that payload.
2902 * If we know what frame this was reassembled in,
2903 * and if there's a field to use for the number of
2904 * the frame in which the packet was reassembled,
2905 * add it to the protocol tree.
2907 if (fd_head
!= NULL
&& fit
->hf_reassembled_in
!= NULL
) {
2908 proto_item
*fei
= proto_tree_add_uint(tree
,
2909 *(fit
->hf_reassembled_in
), tvb
,
2910 0, 0, fd_head
->reassembled_in
);
2911 proto_item_set_generated(fei
);
2918 * Show a single fragment in a fragment subtree, and put information about
2919 * it in the top-level item for that subtree.
2922 show_fragment(fragment_item
*fd
, const int offset
, const fragment_items
*fit
,
2923 proto_tree
*ft
, proto_item
*fi
, const bool first_frag
,
2924 const uint32_t count
, tvbuff_t
*tvb
, packet_info
*pinfo
)
2926 proto_item
*fei
=NULL
;
2932 name
= g_strdup(proto_registrar_get_name(*(fit
->hf_fragment
)));
2934 name
= g_strdup(proto_registrar_get_name(*(fit
->hf_fragments
)));
2936 proto_item_set_text(fi
, "%u %s (%u byte%s): ", count
, name
, tvb_captured_length(tvb
),
2937 plurality(tvb_captured_length(tvb
), "", "s"));
2940 proto_item_append_text(fi
, ", ");
2942 proto_item_append_text(fi
, "#%u(%u)", fd
->frame
, fd
->len
);
2944 if (fd
->flags
& (FD_OVERLAPCONFLICT
2945 |FD_MULTIPLETAILS
|FD_TOOLONGFRAGMENT
) ) {
2946 hf
= *(fit
->hf_fragment_error
);
2948 hf
= *(fit
->hf_fragment
);
2951 fei
= proto_tree_add_uint_format(ft
, hf
,
2952 tvb
, offset
, fd
->len
,
2954 "Frame: %u (no data)",
2957 fei
= proto_tree_add_uint_format(ft
, hf
,
2958 tvb
, offset
, fd
->len
,
2960 "Frame: %u, payload: %u-%u (%u byte%s)",
2965 plurality(fd
->len
, "", "s"));
2967 proto_item_set_generated(fei
);
2968 mark_frame_as_depended_upon(pinfo
->fd
, fd
->frame
);
2969 if (fd
->flags
& (FD_OVERLAP
|FD_OVERLAPCONFLICT
2970 |FD_MULTIPLETAILS
|FD_TOOLONGFRAGMENT
) ) {
2971 /* this fragment has some flags set, create a subtree
2972 * for it and display the flags.
2974 proto_tree
*fet
=NULL
;
2976 fet
= proto_item_add_subtree(fei
, *(fit
->ett_fragment
));
2977 if (fd
->flags
&FD_OVERLAP
) {
2978 fei
=proto_tree_add_boolean(fet
,
2979 *(fit
->hf_fragment_overlap
),
2982 proto_item_set_generated(fei
);
2984 if (fd
->flags
&FD_OVERLAPCONFLICT
) {
2985 fei
=proto_tree_add_boolean(fet
,
2986 *(fit
->hf_fragment_overlap_conflict
),
2989 proto_item_set_generated(fei
);
2991 if (fd
->flags
&FD_MULTIPLETAILS
) {
2992 fei
=proto_tree_add_boolean(fet
,
2993 *(fit
->hf_fragment_multiple_tails
),
2996 proto_item_set_generated(fei
);
2998 if (fd
->flags
&FD_TOOLONGFRAGMENT
) {
2999 fei
=proto_tree_add_boolean(fet
,
3000 *(fit
->hf_fragment_too_long_fragment
),
3003 proto_item_set_generated(fei
);
3009 show_fragment_errs_in_col(fragment_head
*fd_head
, const fragment_items
*fit
,
3012 if (fd_head
->flags
& (FD_OVERLAPCONFLICT
3013 |FD_MULTIPLETAILS
|FD_TOOLONGFRAGMENT
) ) {
3014 col_add_fstr(pinfo
->cinfo
, COL_INFO
, "[Illegal %s]", fit
->tag
);
3021 /* This function will build the fragment subtree; it's for fragments
3022 reassembled with "fragment_add()".
3024 It will return true if there were fragmentation errors
3025 or false if fragmentation was ok.
3028 show_fragment_tree(fragment_head
*fd_head
, const fragment_items
*fit
,
3029 proto_tree
*tree
, packet_info
*pinfo
, tvbuff_t
*tvb
, proto_item
**fi
)
3035 /* It's not fragmented. */
3036 pinfo
->fragmented
= false;
3038 *fi
= proto_tree_add_item(tree
, *(fit
->hf_fragments
), tvb
, 0, -1, ENC_NA
);
3039 proto_item_set_generated(*fi
);
3041 ft
= proto_item_add_subtree(*fi
, *(fit
->ett_fragments
));
3043 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
) {
3046 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
) {
3047 show_fragment(fd
, fd
->offset
, fit
, ft
, *fi
, first_frag
, count
, tvb
, pinfo
);
3051 if (fit
->hf_fragment_count
) {
3052 proto_item
*fli
= proto_tree_add_uint(ft
, *(fit
->hf_fragment_count
),
3054 proto_item_set_generated(fli
);
3057 if (fit
->hf_reassembled_length
) {
3058 proto_item
*fli
= proto_tree_add_uint(ft
, *(fit
->hf_reassembled_length
),
3059 tvb
, 0, 0, tvb_captured_length (tvb
));
3060 proto_item_set_generated(fli
);
3063 if (fit
->hf_reassembled_data
) {
3064 proto_item
*fli
= proto_tree_add_item(ft
, *(fit
->hf_reassembled_data
),
3065 tvb
, 0, tvb_captured_length(tvb
), ENC_NA
);
3066 proto_item_set_generated(fli
);
3069 return show_fragment_errs_in_col(fd_head
, fit
, pinfo
);
3072 /* This function will build the fragment subtree; it's for fragments
3073 reassembled with "fragment_add_seq()" or "fragment_add_seq_check()".
3075 It will return true if there were fragmentation errors
3076 or false if fragmentation was ok.
3079 show_fragment_seq_tree(fragment_head
*fd_head
, const fragment_items
*fit
,
3080 proto_tree
*tree
, packet_info
*pinfo
, tvbuff_t
*tvb
, proto_item
**fi
)
3082 uint32_t offset
, next_offset
, count
= 0;
3083 fragment_item
*fd
, *last_fd
;
3087 /* It's not fragmented. */
3088 pinfo
->fragmented
= false;
3090 *fi
= proto_tree_add_item(tree
, *(fit
->hf_fragments
), tvb
, 0, -1, ENC_NA
);
3091 proto_item_set_generated(*fi
);
3093 ft
= proto_item_add_subtree(*fi
, *(fit
->ett_fragments
));
3098 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
){
3101 for (fd
= fd_head
->next
; fd
!= NULL
; fd
= fd
->next
){
3102 if (last_fd
== NULL
|| last_fd
->offset
!= fd
->offset
) {
3103 offset
= next_offset
;
3104 next_offset
+= fd
->len
;
3107 show_fragment(fd
, offset
, fit
, ft
, *fi
, first_frag
, count
, tvb
, pinfo
);
3111 if (fit
->hf_fragment_count
) {
3112 proto_item
*fli
= proto_tree_add_uint(ft
, *(fit
->hf_fragment_count
),
3114 proto_item_set_generated(fli
);
3117 if (fit
->hf_reassembled_length
) {
3118 proto_item
*fli
= proto_tree_add_uint(ft
, *(fit
->hf_reassembled_length
),
3119 tvb
, 0, 0, tvb_captured_length (tvb
));
3120 proto_item_set_generated(fli
);
3123 if (fit
->hf_reassembled_data
) {
3124 proto_item
*fli
= proto_tree_add_item(ft
, *(fit
->hf_reassembled_data
),
3125 tvb
, 0, tvb_captured_length(tvb
), ENC_NA
);
3126 proto_item_set_generated(fli
);
3129 return show_fragment_errs_in_col(fd_head
, fit
, pinfo
);
3133 reassembly_table_init_reg_table(void *p
, void *user_data _U_
)
3135 register_reassembly_table_t
* reg_table
= (register_reassembly_table_t
*)p
;
3136 reassembly_table_init(reg_table
->table
, reg_table
->funcs
);
3140 reassembly_table_init_reg_tables(void)
3142 g_list_foreach(reassembly_table_list
, reassembly_table_init_reg_table
, NULL
);
3146 reassembly_table_cleanup_reg_table(void *p
, void *user_data _U_
)
3148 register_reassembly_table_t
* reg_table
= (register_reassembly_table_t
*)p
;
3149 reassembly_table_destroy(reg_table
->table
);
3153 reassembly_table_cleanup_reg_tables(void)
3155 g_list_foreach(reassembly_table_list
, reassembly_table_cleanup_reg_table
, NULL
);
3158 void reassembly_tables_init(void)
3160 register_init_routine(&reassembly_table_init_reg_tables
);
3161 register_cleanup_routine(&reassembly_table_cleanup_reg_tables
);
3165 reassembly_table_free(void *p
, void *user_data _U_
)
3167 register_reassembly_table_t
* reg_table
= (register_reassembly_table_t
*)p
;
3168 reassembly_table_destroy(reg_table
->table
);
3173 reassembly_table_cleanup(void)
3175 g_list_foreach(reassembly_table_list
, reassembly_table_free
, NULL
);
3176 g_list_free(reassembly_table_list
);
3179 /* One instance of this structure is created for each pdu that spans across
3180 * multiple segments. (MSP) */
3181 typedef struct _multisegment_pdu_t
{
3182 uint64_t first_frame
;
3183 uint64_t last_frame
;
3184 unsigned start_offset_at_first_frame
;
3185 unsigned end_offset_at_last_frame
;
3186 int length
; /* length of this MSP */
3187 uint32_t streaming_reassembly_id
;
3188 /* pointer to previous multisegment_pdu */
3189 struct _multisegment_pdu_t
* prev_msp
;
3190 } multisegment_pdu_t
;
3192 /* struct for keeping the reassembly information of each stream */
3193 struct streaming_reassembly_info_t
{
3194 /* This map is keyed by frame num and keeps track of all MSPs for this
3195 * stream. Different frames will point to the same MSP if they contain
3196 * part data of this MSP. If a frame contains data that
3197 * belongs to two MSPs, it will point to the second MSP. */
3198 wmem_map_t
* multisegment_pdus
;
3199 /* This map is keyed by frame num and keeps track of the frag_offset
3200 * of the first byte of frames for fragment_add() after first scan. */
3201 wmem_map_t
* frame_num_frag_offset_map
;
3202 /* how many bytes the current uncompleted MSP still needs. (only valid for first scan) */
3204 /* the current uncompleted MSP (only valid for first scan) */
3205 multisegment_pdu_t
* last_msp
;
3209 create_streaming_reassembly_id(void)
3211 static uint32_t global_streaming_reassembly_id
= 0;
3212 return ++global_streaming_reassembly_id
;
3215 streaming_reassembly_info_t
*
3216 streaming_reassembly_info_new(void)
3218 return wmem_new0(wmem_file_scope(), streaming_reassembly_info_t
);
3221 /* Following is an example of ProtoA and ProtoB protocols from the declaration of this function in 'reassemble.h':
3223 * +------------------ A Multisegment PDU of ProtoB ----------------------+
3225 * +--- ProtoA payload1 ---+ +- payload2 -+ +- Payload3 -+ +- Payload4 -+ +- ProtoA payload5 -+
3226 * | EoMSP | OmNFP | BoMSP | | MoMSP | | MoMSP | | MoMSP | | EoMSP | BoMSP |
3227 * +-------+-------+-------+ +------------+ +------------+ +------------+ +---------+---------+
3229 * +----------------------------------------------------------------------+
3231 * For a ProtoA payload composed of EoMSP + OmNFP + BoMSP will call fragment_add() twice on EoMSP and BoMSP; and call
3232 * process_reassembled_data() once for generating tvb of a MSP to which EoMSP belongs; and call subdissector twice on
3233 * reassembled MSP of EoMSP and OmNFP + BoMSP. After that finds BoMSP is a beginning of a MSP at first scan.
3237 * - If a ProtoA payload contains EoMSP, we will need call fragment_add(), process_reassembled_data() and subdissector
3238 * once on it to end a MSP. (May run twice or more times at first scan, because subdissector may only return the
3239 * head length of message by pinfo->desegment_len. We need run second time for subdissector to determine the length
3240 * of entire message).
3242 * - If a ProtoA payload contains OmNFP, we will need only call subdissector once on it. The subdissector need dissect
3243 * all non-fragment PDUs in it. (no desegment_len should output)
3245 * - If a ProtoA payload contains BoMSP, we will need call subdissector once on BoMSP or OmNFP+BoMSP (because unknown
3246 * during first scan). The subdissector will output desegment_len (!= 0). Then we will call fragment_add()
3247 * with a new reassembly id on BoMSP for starting a new MSP.
3249 * - If a ProtoA payload only contains MoMSP (entire payload is part of a MSP), we will only call fragment_add() once
3250 * or twice (at first scan) on it. The subdissector will not be called.
3252 * In this implementation, only multisegment PDUs are recorded in multisegment_pdus map keyed by the numbers (uint64_t)
3253 * of frames belongs to MSPs. Each MSP in the map has a pointer referred to previous MSP, because we may need
3254 * two MSPs to dissect a ProtoA payload that contains EoMSP + BoMSP at the same time. The multisegment_pdus map is built
3255 * during first scan (pinfo->visited == false) with help of prev_deseg_len and last_msp fields of streaming_reassembly_info_t
3256 * for each direction of a ProtoA STREAM. The prev_deseg_len record how many bytes of subsequent ProtoA payloads belong to
3257 * previous PDU during first scan. The last_msp member of streaming_reassembly_info_t is always point to last MSP which
3258 * is created during scan previous or early ProtoA payloads. Since subdissector might return only the head length of entire
3259 * message (by pinfo->desegment_len) when there is not enough data to determine the message length, we need to reopen
3260 * reassembly fragments for adding more bytes during scanning the next ProtoA payload. We have to use fragment_add()
3261 * instead of fragment_add_check() or fragment_add_seq_next().
3263 * Read more: please refer to comments of the declaration of this function in 'reassemble.h'.
3266 reassemble_streaming_data_and_call_subdissector(
3267 tvbuff_t
* tvb
, packet_info
* pinfo
, unsigned offset
, int length
,
3268 proto_tree
* segment_tree
, proto_tree
* reassembled_tree
, reassembly_table streaming_reassembly_table
,
3269 streaming_reassembly_info_t
* reassembly_info
, uint64_t cur_frame_num
,
3270 dissector_handle_t subdissector_handle
, proto_tree
* subdissector_tree
, void* subdissector_data
,
3271 const char* label
, const fragment_items
* frag_hf_items
, int hf_segment_data
3274 int orig_length
= length
;
3276 int bytes_belong_to_prev_msp
= 0; /* bytes belong to previous MSP */
3277 uint32_t reassembly_id
= 0, frag_offset
= 0;
3278 fragment_head
* head
= NULL
;
3279 bool need_more
= false;
3280 bool found_BoMSP
= false;
3281 multisegment_pdu_t
* cur_msp
= NULL
, * prev_msp
= NULL
;
3282 uint16_t save_can_desegment
;
3283 int save_desegment_offset
;
3284 uint32_t save_desegment_len
;
3285 uint64_t* frame_ptr
;
3287 save_can_desegment
= pinfo
->can_desegment
;
3288 save_desegment_offset
= pinfo
->desegment_offset
;
3289 save_desegment_len
= pinfo
->desegment_len
;
3291 /* calculate how many bytes of this payload belongs to previous MSP (EoMSP) */
3292 if (!PINFO_FD_VISITED(pinfo
)) {
3293 /* this is first scan */
3294 if (reassembly_info
->prev_deseg_len
== DESEGMENT_ONE_MORE_SEGMENT
) {
3295 /* assuming the entire tvb belongs to the previous MSP */
3296 bytes_belong_to_prev_msp
= length
;
3297 reassembly_info
->prev_deseg_len
= length
;
3298 } else if (reassembly_info
->prev_deseg_len
> 0) {
3299 /* part or all of current payload belong to previous MSP */
3300 bytes_belong_to_prev_msp
= MIN(reassembly_info
->prev_deseg_len
, length
);
3301 reassembly_info
->prev_deseg_len
-= bytes_belong_to_prev_msp
;
3302 need_more
= (reassembly_info
->prev_deseg_len
> 0);
3303 } /* else { beginning of a new PDU (might be a NFP or MSP) } */
3305 if (bytes_belong_to_prev_msp
> 0) {
3306 DISSECTOR_ASSERT(reassembly_info
->last_msp
!= NULL
);
3307 reassembly_id
= reassembly_info
->last_msp
->streaming_reassembly_id
;
3308 frag_offset
= reassembly_info
->last_msp
->length
;
3309 if (reassembly_info
->frame_num_frag_offset_map
== NULL
) {
3310 reassembly_info
->frame_num_frag_offset_map
= wmem_map_new(wmem_file_scope(), g_int64_hash
, g_int64_equal
);
3312 frame_ptr
= (uint64_t*)wmem_memdup(wmem_file_scope(), &cur_frame_num
, sizeof(uint64_t));
3313 wmem_map_insert(reassembly_info
->frame_num_frag_offset_map
, frame_ptr
, GUINT_TO_POINTER(frag_offset
));
3314 /* This payload contains the data of previous msp, so we point to it. That may be overridden late. */
3315 wmem_map_insert(reassembly_info
->multisegment_pdus
, frame_ptr
, reassembly_info
->last_msp
);
3318 /* not first scan, use information of multisegment_pdus built during first scan */
3319 if (reassembly_info
->multisegment_pdus
) {
3320 cur_msp
= (multisegment_pdu_t
*)wmem_map_lookup(reassembly_info
->multisegment_pdus
, &cur_frame_num
);
3323 if (cur_msp
->first_frame
== cur_frame_num
) {
3324 /* Current payload contains a beginning of a MSP. (BoMSP)
3325 * The cur_msp contains information about the beginning MSP.
3326 * If prev_msp is not null, that means this payload also contains
3327 * the last part of previous MSP. (EoMSP) */
3328 prev_msp
= cur_msp
->prev_msp
;
3330 /* Current payload is not a first frame of a MSP (not include BoMSP). */
3336 if (prev_msp
&& prev_msp
->last_frame
>= cur_frame_num
) {
3337 if (prev_msp
->last_frame
== cur_frame_num
) {
3338 /* this payload contains part of previous MSP (contains EoMSP) */
3339 bytes_belong_to_prev_msp
= prev_msp
->end_offset_at_last_frame
- offset
;
3340 } else { /* if (prev_msp->last_frame > cur_frame_num) */
3341 /* this payload all belongs to previous MSP */
3342 bytes_belong_to_prev_msp
= length
;
3345 reassembly_id
= prev_msp
->streaming_reassembly_id
;
3347 if (reassembly_info
->frame_num_frag_offset_map
) {
3348 frag_offset
= GPOINTER_TO_UINT(wmem_map_lookup(reassembly_info
->frame_num_frag_offset_map
, &cur_frame_num
));
3352 /* handling EoMSP or MoMSP (entire payload being middle part of a MSP) */
3353 while (bytes_belong_to_prev_msp
> 0) {
3354 tvbuff_t
* reassembled_tvb
= NULL
;
3355 DISSECTOR_ASSERT(reassembly_id
> 0);
3356 pinfo
->can_desegment
= 2; /* this will be decreased one while passing to subdissector */
3357 pinfo
->desegment_offset
= 0;
3358 pinfo
->desegment_len
= 0;
3360 head
= fragment_add(&streaming_reassembly_table
, tvb
, offset
, pinfo
, reassembly_id
, NULL
,
3361 frag_offset
, bytes_belong_to_prev_msp
, need_more
);
3364 if (frag_hf_items
->hf_reassembled_in
) {
3365 proto_item_set_generated(
3366 proto_tree_add_uint(segment_tree
, *(frag_hf_items
->hf_reassembled_in
), tvb
, offset
,
3367 bytes_belong_to_prev_msp
, head
->reassembled_in
)
3372 reassembled_tvb
= process_reassembled_data(tvb
, offset
, pinfo
,
3373 wmem_strdup_printf(pinfo
->pool
, "Reassembled %s", label
),
3374 head
, frag_hf_items
, NULL
, reassembled_tree
);
3378 proto_tree_add_bytes_format(segment_tree
, hf_segment_data
, tvb
, offset
,
3379 bytes_belong_to_prev_msp
, NULL
, "%s Segment data (%u byte%s)", label
,
3380 bytes_belong_to_prev_msp
, plurality(bytes_belong_to_prev_msp
, "", "s"));
3382 if (reassembled_tvb
) {
3383 /* normally, this stage will dissect one or more completed pdus */
3384 /* Note, don't call_dissector_with_data because sometime the pinfo->curr_layer_num will changed
3385 * after calling that will make reassembly failed! */
3386 call_dissector_only(subdissector_handle
, reassembled_tvb
, pinfo
, subdissector_tree
, subdissector_data
);
3389 if (pinfo
->desegment_len
) {
3390 /* that must only happen during first scan the reassembly_info->prev_deseg_len might be only the
3391 * head length of entire message. */
3392 DISSECTOR_ASSERT(!PINFO_FD_VISITED(pinfo
));
3393 DISSECTOR_ASSERT_HINT(pinfo
->desegment_len
!= DESEGMENT_UNTIL_FIN
, "Subdissector MUST NOT "
3394 "set pinfo->desegment_len to DESEGMENT_UNTIL_FIN. Instead, it can set pinfo->desegment_len to "
3395 " DESEGMENT_ONE_MORE_SEGMENT or the length of head if the length of entire message is not able to be determined.");
3397 if (pinfo
->desegment_offset
> 0) {
3398 DISSECTOR_ASSERT_HINT(pinfo
->desegment_offset
> reassembly_info
->last_msp
->length
3399 && pinfo
->desegment_offset
< reassembly_info
->last_msp
->length
+ bytes_belong_to_prev_msp
,
3400 wmem_strdup_printf(pinfo
->pool
,
3401 "Subdissector MUST NOT set pinfo->desegment_offset(%d) in previous or next part of MSP, must between (%d, %d).",
3402 pinfo
->desegment_offset
, reassembly_info
->last_msp
->length
, reassembly_info
->last_msp
->length
+ bytes_belong_to_prev_msp
));
3404 /* shorten the bytes_belong_to_prev_msp and just truncate the reassembled tvb */
3405 bytes_belong_to_prev_msp
= pinfo
->desegment_offset
- reassembly_info
->last_msp
->length
;
3406 fragment_truncate(&streaming_reassembly_table
, pinfo
, reassembly_id
, NULL
, pinfo
->desegment_offset
);
3409 if (pinfo
->desegment_len
== DESEGMENT_ONE_MORE_SEGMENT
) {
3410 /* just need more bytes, all remaining bytes belongs to previous MSP (to run fragment_add again) */
3411 bytes_belong_to_prev_msp
= length
;
3414 /* Remove the data added by previous fragment_add(), and reopen fragments for adding more bytes. */
3415 fragment_truncate(&streaming_reassembly_table
, pinfo
, reassembly_id
, NULL
, reassembly_info
->last_msp
->length
);
3416 fragment_set_partial_reassembly(&streaming_reassembly_table
, pinfo
, reassembly_id
, NULL
);
3418 reassembly_info
->prev_deseg_len
= bytes_belong_to_prev_msp
+ pinfo
->desegment_len
;
3419 bytes_belong_to_prev_msp
= MIN(reassembly_info
->prev_deseg_len
, length
);
3420 reassembly_info
->prev_deseg_len
-= bytes_belong_to_prev_msp
;
3421 need_more
= (reassembly_info
->prev_deseg_len
> 0);
3426 if (pinfo
->desegment_len
== 0 || found_BoMSP
) {
3427 /* We will arrive here, only when the MSP is defragmented and dissected or this
3428 * payload all belongs to previous MSP (only fragment_add() with need_more=true called)
3429 * or BoMSP is parsed while pinfo->desegment_offset > 0 and pinfo->desegment_len != 0
3431 offset
+= bytes_belong_to_prev_msp
;
3432 length
-= bytes_belong_to_prev_msp
;
3433 DISSECTOR_ASSERT(length
>= 0);
3434 if (!PINFO_FD_VISITED(pinfo
)) {
3435 reassembly_info
->last_msp
->length
+= bytes_belong_to_prev_msp
;
3438 if (!PINFO_FD_VISITED(pinfo
) && reassembled_tvb
) {
3439 /* completed current msp */
3440 reassembly_info
->last_msp
->last_frame
= cur_frame_num
;
3441 reassembly_info
->last_msp
->end_offset_at_last_frame
= offset
;
3442 reassembly_info
->prev_deseg_len
= pinfo
->desegment_len
;
3444 bytes_belong_to_prev_msp
= 0; /* break */
3448 /* to find and handle OmNFP, and find BoMSP at first scan. */
3449 if (length
> 0 && !found_BoMSP
) {
3450 if (!PINFO_FD_VISITED(pinfo
)) {
3451 /* It is first scan, to dissect remaining bytes to find whether it is OmNFP only, or BoMSP only or OmNFP + BoMSP. */
3453 DISSECTOR_ASSERT(cur_msp
== NULL
);
3455 /* Not first scan */
3457 /* There's a BoMSP. Let's calculate the length of OmNFP between EoMSP and BoMSP */
3458 datalen
= cur_msp
->start_offset_at_first_frame
- offset
; /* if result is zero that means no OmNFP */
3460 /* This payload is not a beginning of MSP. The remaining bytes all belong to OmNFP without BoMSP */
3464 DISSECTOR_ASSERT(datalen
>= 0);
3466 /* Dissect the remaining of this payload. If (datalen == 0) means remaining only have one BoMSP without OmNFP. */
3468 /* we dissect if it is not dissected before or it is a non-fragment pdu (between two multisegment pdus) */
3469 pinfo
->can_desegment
= 2;
3470 pinfo
->desegment_offset
= 0;
3471 pinfo
->desegment_len
= 0;
3473 call_dissector_only(subdissector_handle
, tvb_new_subset_length(tvb
, offset
, datalen
),
3474 pinfo
, subdissector_tree
, subdissector_data
);
3476 if (pinfo
->desegment_len
) {
3477 DISSECTOR_ASSERT_HINT(pinfo
->desegment_len
!= DESEGMENT_UNTIL_FIN
, "Subdissector MUST NOT "
3478 "set pinfo->desegment_len to DESEGMENT_UNTIL_FIN. Instead, it can set pinfo->desegment_len to "
3479 " DESEGMENT_ONE_MORE_SEGMENT or the length of head if the length of entire message is not able to be determined.");
3480 /* only happen during first scan */
3481 DISSECTOR_ASSERT(!PINFO_FD_VISITED(pinfo
) && datalen
== length
);
3482 offset
+= pinfo
->desegment_offset
;
3483 length
-= pinfo
->desegment_offset
;
3485 /* all remaining bytes are consumed by subdissector */
3489 if (!PINFO_FD_VISITED(pinfo
)) {
3490 reassembly_info
->prev_deseg_len
= pinfo
->desegment_len
;
3492 } /* else all remaining bytes (BoMSP) belong to a new MSP */
3493 DISSECTOR_ASSERT(length
>= 0);
3496 /* handling BoMSP */
3498 col_append_sep_fstr(pinfo
->cinfo
, COL_INFO
, " ", "[%s segment of a reassembled PDU] ", label
);
3499 if (!PINFO_FD_VISITED(pinfo
)) {
3500 /* create a msp for current frame during first scan */
3501 cur_msp
= wmem_new0(wmem_file_scope(), multisegment_pdu_t
);
3502 cur_msp
->first_frame
= cur_frame_num
;
3503 cur_msp
->last_frame
= UINT64_MAX
;
3504 cur_msp
->start_offset_at_first_frame
= offset
;
3505 cur_msp
->length
= length
;
3506 cur_msp
->streaming_reassembly_id
= reassembly_id
= create_streaming_reassembly_id();
3507 cur_msp
->prev_msp
= reassembly_info
->last_msp
;
3508 reassembly_info
->last_msp
= cur_msp
;
3509 if (reassembly_info
->multisegment_pdus
== NULL
) {
3510 reassembly_info
->multisegment_pdus
= wmem_map_new(wmem_file_scope(), g_int64_hash
, g_int64_equal
);
3512 frame_ptr
= (uint64_t*)wmem_memdup(wmem_file_scope(), &cur_frame_num
, sizeof(uint64_t));
3513 wmem_map_insert(reassembly_info
->multisegment_pdus
, frame_ptr
, cur_msp
);
3515 DISSECTOR_ASSERT(cur_msp
&& cur_msp
->start_offset_at_first_frame
== offset
);
3516 reassembly_id
= cur_msp
->streaming_reassembly_id
;
3518 /* add first fragment of the new MSP to reassembly table */
3519 head
= fragment_add(&streaming_reassembly_table
, tvb
, offset
, pinfo
, reassembly_id
,
3520 NULL
, 0, length
, true);
3522 if (head
&& frag_hf_items
->hf_reassembled_in
) {
3523 proto_item_set_generated(
3524 proto_tree_add_uint(segment_tree
, *(frag_hf_items
->hf_reassembled_in
),
3525 tvb
, offset
, length
, head
->reassembled_in
)
3528 proto_tree_add_bytes_format(segment_tree
, hf_segment_data
, tvb
, offset
, length
,
3529 NULL
, "%s Segment data (%u byte%s)", label
, length
, plurality(length
, "", "s"));
3532 pinfo
->can_desegment
= save_can_desegment
;
3533 pinfo
->desegment_offset
= save_desegment_offset
;
3534 pinfo
->desegment_len
= save_desegment_len
;
3540 additional_bytes_expected_to_complete_reassembly(streaming_reassembly_info_t
* reassembly_info
)
3542 return reassembly_info
->prev_deseg_len
;
3546 * Editor modelines - https://www.wireshark.org/tools/modelines.html
3551 * indent-tabs-mode: t
3554 * vi: set shiftwidth=8 tabstop=8 noexpandtab:
3555 * :indentSize=8:tabSize=8:noTabs=false: