/builds/wireshark/wireshark/epan/tvbuff.c

Bug Summary

File:	epan/tvbuff.c
Warning:	line 428, column 17 The left expression of the compound assignment is an uninitialized value. The computed value will also be garbage
Annotated Source Code

Press '?' to see keyboard shortcuts
Show analyzer invocation
clang -cc1 -cc1 -triple x86_64-pc-linux-gnu -analyze -disable-free -clear-ast-before-backend -disable-llvm-verifier -discard-value-names -main-file-name tvbuff.c -analyzer-checker=core -analyzer-checker=apiModeling -analyzer-checker=unix -analyzer-checker=deadcode -analyzer-checker=security.insecureAPI.UncheckedReturn -analyzer-checker=security.insecureAPI.getpw -analyzer-checker=security.insecureAPI.gets -analyzer-checker=security.insecureAPI.mktemp -analyzer-checker=security.insecureAPI.mkstemp -analyzer-checker=security.insecureAPI.vfork -analyzer-checker=nullability.NullPassedToNonnull -analyzer-checker=nullability.NullReturnedFromNonnull -analyzer-output plist -w -setup-static-analyzer -mrelocation-model pic -pic-level 2 -fhalf-no-semantic-interposition -fno-delete-null-pointer-checks -mframe-pointer=all -relaxed-aliasing -fmath-errno -ffp-contract=on -fno-rounding-math -ffloat16-excess-precision=fast -fbfloat16-excess-precision=fast -mconstructor-aliases -funwind-tables=2 -target-cpu x86-64 -tune-cpu generic -debugger-tuning=gdb -fdebug-compilation-dir=/builds/wireshark/wireshark/build -fcoverage-compilation-dir=/builds/wireshark/wireshark/build -resource-dir /usr/lib/llvm-20/lib/clang/20 -isystem /usr/include/glib-2.0 -isystem /usr/lib/x86_64-linux-gnu/glib-2.0/include -isystem /builds/wireshark/wireshark/epan -isystem /builds/wireshark/wireshark/build/epan -isystem /usr/include/mit-krb5 -isystem /usr/include/libxml2 -isystem /usr/include/lua5.4 -D G_DISABLE_DEPRECATED -D G_DISABLE_SINGLE_INCLUDES -D WS_BUILD_DLL -D WS_DEBUG -D WS_DEBUG_UTF_8 -D epan_EXPORTS -I /builds/wireshark/wireshark/build -I /builds/wireshark/wireshark -I /builds/wireshark/wireshark/include -I /builds/wireshark/wireshark/wiretap -D _GLIBCXX_ASSERTIONS -internal-isystem /usr/lib/llvm-20/lib/clang/20/include -internal-isystem /usr/local/include -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/14/../../../../x86_64-linux-gnu/include -internal-externc-isystem /usr/include/x86_64-linux-gnu -internal-externc-isystem /include -internal-externc-isystem /usr/include -fmacro-prefix-map=/builds/wireshark/wireshark/= -fmacro-prefix-map=/builds/wireshark/wireshark/build/= -fmacro-prefix-map=../= -Wno-format-truncation -Wno-format-nonliteral -Wno-pointer-sign -std=gnu11 -ferror-limit 19 -fvisibility=hidden -fwrapv -fwrapv-pointer -fstrict-flex-arrays=3 -stack-protector 2 -fstack-clash-protection -fcf-protection=full -fgnuc-version=4.2.1 -fskip-odr-check-in-gmf -fexceptions -fcolor-diagnostics -analyzer-output=html -faddrsig -D__GCC_HAVE_DWARF2_CFI_ASM=1 -o /builds/wireshark/wireshark/sbout/2025-09-17-100337-3933-1 -x c /builds/wireshark/wireshark/epan/tvbuff.c
1/* tvbuff.c
*
* Testy, Virtual(-izable) Buffer of uint8_t*'s
*
* "Testy" -- the buffer gets mad when an attempt to access data
*		beyond the bounds of the buffer. An exception is thrown.
*
* "Virtual" -- the buffer can have its own data, can use a subset of
*		the data of a backing tvbuff, or can be a composite of
*		other tvbuffs.
*
* Copyright (c) 2000 by Gilbert Ramirez <gram@alumni.rice.edu>
*
* Code to convert IEEE floating point formats to native floating point
* derived from code Copyright (c) Ashok Narayanan, 2000
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/

24#include "config.h"

26#include <string.h>
27#include <stdio.h>
28#include <errno(*__errno_location ()).h>

30#include <glib.h>

32#include "wsutil/pint.h"
33#include "wsutil/sign_ext.h"
34#include "wsutil/strtoi.h"
35#include "wsutil/unicode-utils.h"
36#include "wsutil/nstime.h"
37#include "wsutil/time_util.h"
38#include <wsutil/ws_assert.h>
39#include "tvbuff.h"
40#include "tvbuff-int.h"
41#include "strutil.h"
42#include "to_str.h"
43#include "charsets.h"
44#include "proto.h"	/* XXX - only used for DISSECTOR_ASSERT, probably a new header file? */
45#include "exceptions.h"

47#include <time.h>

49static uint64_t
50_tvb_get_bits64(tvbuff_t *tvb, unsigned bit_offset, const int total_no_of_bits);

52static uint64_t
53_tvb_get_bits64_le(tvbuff_t *tvb, unsigned bit_offset, const int total_no_of_bits);

55static inline int
56_tvb_captured_length_remaining(const tvbuff_t *tvb, const int offset);

58static inline const uint8_t*
59ensure_contiguous(tvbuff_t *tvb, const int offset, const int length);

61static inline uint8_t *
62tvb_get_raw_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int length);

64tvbuff_t *
65tvb_new(const struct tvb_ops *ops)
66{
tvbuff_t *tvb;
size_t    size = ops->tvb_size;

ws_assert(size >= sizeof(*tvb))do { if ((1) && !(size >= sizeof(*tvb))) ws_log_fatal_full
("", LOG_LEVEL_ERROR, "epan/tvbuff.c", 70, __func__, "assertion failed: %s"
, "size >= sizeof(*tvb)"); } while (0);

tvb = (tvbuff_t *) g_slice_alloc(size);

tvb->next		 = NULL((void*)0);
tvb->ops		 = ops;
tvb->initialized	 = false0;
tvb->flags		 = 0;
tvb->length		 = 0;
tvb->reported_length	 = 0;
tvb->contained_length	 = 0;
tvb->real_data		 = NULL((void*)0);
tvb->raw_offset		 = -1;
tvb->ds_tvb		 = NULL((void*)0);

return tvb;
86}

88static void
89tvb_free_internal(tvbuff_t *tvb)
90{
size_t    size;

DISSECTOR_ASSERT(tvb)((void) ((tvb) ? (void)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 93, "tvb"))));

if (tvb->ops->tvb_free)
tvb->ops->tvb_free(tvb);

size = tvb->ops->tvb_size;

g_slice_free1(size, tvb);
101}

103/* XXX: just call tvb_free_chain();
*      Not removed so that existing dissectors using tvb_free() need not be changed.
*      I'd argue that existing calls to tvb_free() should have actually beeen
*      calls to tvb_free_chain() although the calls were OK as long as no
*      subsets, etc had been created on the tvb. */
108void
109tvb_free(tvbuff_t *tvb)
110{
tvb_free_chain(tvb);
112}

114void
115tvb_free_chain(tvbuff_t  *tvb)
116{
tvbuff_t *next_tvb;
DISSECTOR_ASSERT(tvb)((void) ((tvb) ? (void)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 118, "tvb"))));
while (tvb) {
next_tvb = tvb->next;
tvb_free_internal(tvb);
tvb  = next_tvb;
}
124}

126tvbuff_t *
127tvb_new_chain(tvbuff_t *parent, tvbuff_t *backing)
128{
tvbuff_t *tvb = tvb_new_proxy(backing);

tvb_add_to_chain(parent, tvb);
return tvb;
133}

135void
136tvb_add_to_chain(tvbuff_t *parent, tvbuff_t *child)
137{
tvbuff_t *tmp;

DISSECTOR_ASSERT(parent)((void) ((parent) ? (void)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 140, "parent"))));
DISSECTOR_ASSERT(child)((void) ((child) ? (void)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 141, "child"))));

while (child) {
tmp   = child;
child = child->next;

tmp->next    = parent->next;
parent->next = tmp;
}
150}

152/*
* Check whether that offset goes more than one byte past the
* end of the buffer.
*
* If not, return 0; otherwise, return exception
*/
158static inline int
159validate_offset(const tvbuff_t *tvb, const unsigned abs_offset)
160{
if (G_LIKELY(abs_offset <= tvb->length)(abs_offset <= tvb->length)) {
/* It's OK. */
return 0;
}

/*
* It's not OK, but why?  Which boundaries is it
* past?
*/
if (abs_offset <= tvb->contained_length) {
/*
 * It's past the captured length, but not past
 * the reported end of any parent tvbuffs from
 * which this is constructed, or the reported
 * end of this tvbuff, so it's out of bounds
 * solely because we're past the end of the
 * captured data.
 */
return BoundsError1;
}

/*
* There's some actual packet boundary, not just the
* artificial boundary imposed by packet slicing, that
* we're past.
*/

if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
/*
 * This tvbuff is the first fragment of a larger
 * packet that hasn't been reassembled, so we
 * assume that's the source of the problem - if
 * we'd reassembled the packet, we wouldn't have
 * gone past the end.
 *
 * That might not be true, but for at least
 * some forms of reassembly, such as IP
 * reassembly, you don't know how big the
 * reassembled packet is unless you reassemble
 * it, so, in those cases, we can't determine
 * whether we would have gone past the end
 * had we reassembled the packet.
 */
return FragmentBoundsError4;
}

/* OK, we're not an unreassembled fragment (that we know of). */
if (abs_offset <= tvb->reported_length) {
/*
 * We're within the bounds of what this tvbuff
 * purportedly contains, based on some length
 * value, but we're not within the bounds of
 * something from which this tvbuff was
 * extracted, so that length value ran past
 * the end of some parent tvbuff.
 */
return ContainedBoundsError2;
}

/*
* OK, it looks as if we ran past the claimed length
* of data.
*/
return ReportedBoundsError3;
225}

227static inline int
228compute_offset(const tvbuff_t *tvb, const int offset, unsigned *offset_ptr)
229{
if (offset >= 0) {
/* Positive offset - relative to the beginning of the packet. */
if (G_LIKELY((unsigned) offset <= tvb->length)((unsigned) offset <= tvb->length)) {
	*offset_ptr = offset;
} else if ((unsigned) offset <= tvb->contained_length) {
	return BoundsError1;
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
	return FragmentBoundsError4;
} else if ((unsigned) offset <= tvb->reported_length) {
	return ContainedBoundsError2;
} else {
	return ReportedBoundsError3;
}
}
else {
/* Negative offset - relative to the end of the packet. */
/* Prevent UB on 2's complement platforms. All tested compilers
 * (gcc, clang, MSVC) compile this to a single instruction on
 * x86, ARM, RISC-V, S390x, SPARC, etc. at -O1 and higher
 * according to godbolt.org. */
unsigned abs_offset = ((unsigned)-(offset + 1)) + 1;
if (G_LIKELY(abs_offset <= tvb->length)(abs_offset <= tvb->length)) {
	*offset_ptr = tvb->length - abs_offset;
} else if (abs_offset <= tvb->contained_length) {
	return BoundsError1;
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
	return FragmentBoundsError4;
} else if (abs_offset <= tvb->reported_length) {
	return ContainedBoundsError2;
} else {
	return ReportedBoundsError3;
}
}

return 0;
265}

267static inline int
268compute_offset_and_remaining(const tvbuff_t *tvb, const int offset, unsigned *offset_ptr, unsigned *rem_len)
269{
int exception;

exception = compute_offset(tvb, offset, offset_ptr);
if (!exception)
*rem_len = tvb->length - *offset_ptr;

return exception;
277}

279/* Computes the absolute offset and length based on a possibly-negative offset
* and a length that is possible -1 (which means "to the end of the data").
* Returns integer indicating whether the offset is in bounds (0) or
* not (exception number). The integer ptrs are modified with the new offset,
* captured (available) length, and contained length (amount that's present
* in the parent tvbuff based on its reported length).
* No exception is thrown; on success, we return 0, otherwise we return an
* exception for the caller to throw if appropriate.
*
* XXX - we return success (0), if the offset is positive and right
* after the end of the tvbuff (i.e., equal to the length).  We do this
* so that a dissector constructing a subset tvbuff for the next protocol
* will get a zero-length tvbuff, not an exception, if there's no data
* left for the next protocol - we want the next protocol to be the one
* that gets an exception, so the error is reported as an error in that
* protocol rather than the containing protocol.  */
295static inline int
296check_offset_length_no_exception(const tvbuff_t *tvb,
		 const int offset, int const length_val,
		 unsigned *offset_ptr, unsigned *length_ptr)
299{
unsigned end_offset;
int   exception;

DISSECTOR_ASSERT(offset_ptr)((void) ((offset_ptr) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 303, "offset_ptr"
))));
DISSECTOR_ASSERT(length_ptr)((void) ((length_ptr) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 304, "length_ptr"
))));

/* Compute the offset */
exception = compute_offset(tvb, offset, offset_ptr);
if (exception)
return exception;

if (length_val < -1) {
/* XXX - ReportedBoundsError? */
return BoundsError1;
}

/* Compute the length */
if (length_val == -1)
*length_ptr = tvb->length - *offset_ptr;
else
*length_ptr = length_val;

/*
* Compute the offset of the first byte past the length.
*/
end_offset = *offset_ptr + *length_ptr;

/*
* Check for an overflow
*/
if (end_offset < *offset_ptr)
return BoundsError1;

return validate_offset(tvb, end_offset);
334}

336/* Checks (+/-) offset and length and throws an exception if
* either is out of bounds. Sets integer ptrs to the new offset
* and length. */
339static inline void
340check_offset_length(const tvbuff_t *tvb,
    const int offset, int const length_val,
    unsigned *offset_ptr, unsigned *length_ptr)
343{
int exception;

exception = check_offset_length_no_exception(tvb, offset, length_val, offset_ptr, length_ptr);
if (exception)
THROW(exception)except_throw(1, (exception), ((void*)0));
349}

351void
352tvb_check_offset_length(const tvbuff_t *tvb,
        const int offset, int const length_val,
        unsigned *offset_ptr, unsigned *length_ptr)
355{
check_offset_length(tvb, offset, length_val, offset_ptr, length_ptr);
357}

359static const unsigned char left_aligned_bitmask[] = {
0xff,
0x80,
0xc0,
0xe0,
0xf0,
0xf8,
0xfc,
0xfe
368};

370tvbuff_t *
371tvb_new_octet_aligned(tvbuff_t *tvb, uint32_t bit_offset, int32_t no_of_bits)
372{
tvbuff_t     *sub_tvb = NULL((void*)0);
uint32_t      byte_offset;
int32_t       datalen, i;
uint8_t       left, right, remaining_bits, *buf;
const uint8_t *data;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 379, "tvb && tvb->initialized"
))));
4
←
Assuming 'tvb' is non-null→
5
←
Assuming field 'initialized' is true→
6
←
'?' condition is true→

byte_offset = bit_offset >> 3;
left = bit_offset % 8; /* for left-shifting */
right = 8 - left; /* for right-shifting */

if (no_of_bits == -1) {
7
←
Assuming the condition is true→
8
←
Taking true branch→
datalen = _tvb_captured_length_remaining(tvb, byte_offset);
remaining_bits = 0;
} else {
datalen = no_of_bits >> 3;
remaining_bits = no_of_bits % 8;
if (remaining_bits) {
	datalen++;
}
}

/* already aligned -> shortcut */
if ((left == 0) && (remaining_bits == 0)) {
9
←
Assuming 'left' is not equal to 0→
return tvb_new_subset_length_caplen(tvb, byte_offset, datalen, datalen);
}

DISSECTOR_ASSERT(datalen>0)((void) ((datalen>0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 401, "datalen>0"
))));
10
←
Assuming 'datalen' is > 0→
11
←
'?' condition is true→

/* if at least one trailing byte is available, we must use the content
* of that byte for the last shift (i.e. tvb_get_ptr() must use datalen + 1
* if non extra byte is available, the last shifted byte requires
* special treatment
*/
if (_tvb_captured_length_remaining(tvb, byte_offset) > datalen) {
12
←
Assuming the condition is true→
13
←
Taking true branch→
data = ensure_contiguous(tvb, byte_offset, datalen + 1); /* tvb_get_ptr */

/* Do this allocation AFTER tvb_get_ptr() (which could throw an exception) */
buf = (uint8_t *)g_malloc(datalen);
14
←
Storing uninitialized value→

/* shift tvb data bit_offset bits to the left */
for (i = 0; i < datalen; i++)
15
←
Loop condition is false. Execution continues on line 428→
	buf[i] = (data[i] << left) | (data[i+1] >> right);
} else {
data = ensure_contiguous(tvb, byte_offset, datalen); /* tvb_get_ptr() */

/* Do this allocation AFTER tvb_get_ptr() (which could throw an exception) */
buf = (uint8_t *)g_malloc(datalen);

/* shift tvb data bit_offset bits to the left */
for (i = 0; i < (datalen-1); i++)
	buf[i] = (data[i] << left) | (data[i+1] >> right);
buf[datalen-1] = data[datalen-1] << left; /* set last octet */
}
buf[datalen-1] &= left_aligned_bitmask[remaining_bits];
16
←
The left expression of the compound assignment is an uninitialized value. The computed value will also be garbage

sub_tvb = tvb_new_child_real_data(tvb, buf, datalen, datalen);
tvb_set_free_cb(sub_tvb, g_free);

return sub_tvb;
434}

436tvbuff_t *
437tvb_new_octet_right_aligned(tvbuff_t *tvb, uint32_t bit_offset, int32_t no_of_bits)
438{
tvbuff_t     *sub_tvb = NULL((void*)0);
uint32_t      byte_offset;
int           src_len, dst_len, i;
uint8_t       left, right, remaining_bits, *buf;
const uint8_t *data;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 445, "tvb && tvb->initialized"
))));

byte_offset = bit_offset / 8;
/* right shift to put bits in place and discard least significant bits */
right = bit_offset % 8;
/* left shift to get most significant bits from next octet */
left = 8 - right;

if (no_of_bits == -1) {
dst_len = _tvb_captured_length_remaining(tvb, byte_offset);
remaining_bits = 0;
} else {
dst_len = no_of_bits / 8;
remaining_bits = no_of_bits % 8;
if (remaining_bits) {
	dst_len++;
}
}

/* already aligned -> shortcut */
if ((right == 0) && (remaining_bits == 0)) {
return tvb_new_subset_length_caplen(tvb, byte_offset, dst_len, dst_len);
}

DISSECTOR_ASSERT(dst_len>0)((void) ((dst_len>0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 469, "dst_len>0"
))));

if (_tvb_captured_length_remaining(tvb, byte_offset) > dst_len) {
/* last octet will get data from trailing octet */
src_len = dst_len + 1;
} else {
/* last octet will be zero padded */
src_len = dst_len;
}

data = ensure_contiguous(tvb, byte_offset, src_len); /* tvb_get_ptr */

/* Do this allocation AFTER tvb_get_ptr() (which could throw an exception) */
buf = (uint8_t *)g_malloc(dst_len);

for (i = 0; i < (dst_len - 1); i++)
buf[i] = (data[i] >> right) | (data[i+1] << left);

/* Special handling for last octet */
buf[i] = (data[i] >> right);
/* Shift most significant bits from trailing octet if available */
if (src_len > dst_len)
buf[i] |= (data[i+1] << left);
/* Preserve only remaining bits in last octet if not multiple of 8 */
if (remaining_bits)
buf[i] &= ((1 << remaining_bits) - 1);

sub_tvb = tvb_new_child_real_data(tvb, buf, dst_len, dst_len);
tvb_set_free_cb(sub_tvb, g_free);

return sub_tvb;
500}

502static tvbuff_t *
503tvb_generic_clone_offset_len(tvbuff_t *tvb, unsigned offset, unsigned len)
504{
tvbuff_t *cloned_tvb;
uint8_t *data;

DISSECTOR_ASSERT(tvb_bytes_exist(tvb, offset, len))((void) ((tvb_bytes_exist(tvb, offset, len)) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 508, "tvb_bytes_exist(tvb, offset, len)"
))));

data = (uint8_t *) g_malloc(len);

tvb_memcpy(tvb, data, offset, len);

cloned_tvb = tvb_new_real_data(data, len, len);
tvb_set_free_cb(cloned_tvb, g_free);

return cloned_tvb;
518}

520tvbuff_t *
521tvb_clone_offset_len(tvbuff_t *tvb, unsigned offset, unsigned len)
522{
if (tvb->ops->tvb_clone) {
tvbuff_t *cloned_tvb;

cloned_tvb = tvb->ops->tvb_clone(tvb, offset, len);
if (cloned_tvb)
	return cloned_tvb;
}

return tvb_generic_clone_offset_len(tvb, offset, len);
532}

534tvbuff_t *
535tvb_clone(tvbuff_t *tvb)
536{
return tvb_clone_offset_len(tvb, 0, tvb->length);
538}

540unsigned
541tvb_captured_length(const tvbuff_t *tvb)
542{
DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 543, "tvb && tvb->initialized"
))));

return tvb->length;
546}

548/* For tvbuff internal use */
549static inline int
550_tvb_captured_length_remaining(const tvbuff_t *tvb, const int offset)
551{
unsigned abs_offset = 0, rem_length;
int   exception;

exception = compute_offset_and_remaining(tvb, offset, &abs_offset, &rem_length);
if (exception)
return 0;

return rem_length;
560}

562int
563tvb_captured_length_remaining(const tvbuff_t *tvb, const int offset)
564{
unsigned abs_offset = 0, rem_length;
int   exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 568, "tvb && tvb->initialized"
))));

exception = compute_offset_and_remaining(tvb, offset, &abs_offset, &rem_length);
if (exception)
return 0;

return rem_length;
575}

577unsigned
578tvb_ensure_captured_length_remaining(const tvbuff_t *tvb, const int offset)
579{
unsigned abs_offset = 0, rem_length = 0;
int   exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 583, "tvb && tvb->initialized"
))));

exception = compute_offset_and_remaining(tvb, offset, &abs_offset, &rem_length);
if (exception)
THROW(exception)except_throw(1, (exception), ((void*)0));

if (rem_length == 0) {
/*
 * This routine ensures there's at least one byte available.
 * There aren't any bytes available, so throw the appropriate
 * exception.
 */
if (abs_offset < tvb->contained_length) {
	THROW(BoundsError)except_throw(1, (1), ((void*)0));
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
	THROW(FragmentBoundsError)except_throw(1, (4), ((void*)0));
} else if (abs_offset < tvb->reported_length) {
	THROW(ContainedBoundsError)except_throw(1, (2), ((void*)0));
} else {
	THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}
}
return rem_length;
606}

608/* Validates that 'length' bytes are available starting from
* offset (pos/neg). Does not throw an exception. */
610bool_Bool
611tvb_bytes_exist(const tvbuff_t *tvb, const int offset, const int length)
612{
unsigned abs_offset = 0, abs_length;
int   exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 616, "tvb && tvb->initialized"
))));

/*
* Negative lengths are not possible and indicate a bug (e.g. arithmetic
* error or an overly large value from packet data).
*/
if (length < 0)
return false0;

exception = check_offset_length_no_exception(tvb, offset, length, &abs_offset, &abs_length);
if (exception)
return false0;

return true1;
630}

632/* Validates that 'length' bytes, where 'length' is a 64-bit unsigned
* integer, are available starting from offset (pos/neg). Throws an
* exception if they aren't. */
635void
636tvb_ensure_bytes_exist64(const tvbuff_t *tvb, const int offset, const uint64_t length)
637{
/*
* Make sure the value fits in a signed integer; if not, assume
* that means that it's too big.
*/
if (length > INT_MAX2147483647) {
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}

/* OK, now cast it and try it with tvb_ensure_bytes_exist(). */
tvb_ensure_bytes_exist(tvb, offset, (int)length);
648}

650/* Validates that 'length' bytes are available starting from
* offset (pos/neg). Throws an exception if they aren't. */
652void
653tvb_ensure_bytes_exist(const tvbuff_t *tvb, const int offset, const int length)
654{
unsigned real_offset, end_offset;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 657, "tvb && tvb->initialized"
))));

/*
* -1 doesn't mean "until end of buffer", as that's pointless
* for this routine.  We must treat it as a Really Large Positive
* Number, so that we throw an exception; we throw
* ReportedBoundsError, as if it were past even the end of a
* reassembled packet, and past the end of even the data we
* didn't capture.
*
* We do the same with other negative lengths.
*/
if (length < 0) {
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}

/* XXX: Below this point could be replaced with a call to
* check_offset_length with no functional change, however this is a
* *very* hot path and check_offset_length is not well-optimized for
* this case (mostly because that function handles length -1 meaning
* "until the end of the buffer?"), so we eat some code duplication
* for a lot of speedup.
*
* XXX - Could it be replaced with a call just to compute_offset?
*/

if (offset >= 0) {
/* Positive offset - relative to the beginning of the packet. */
if (G_LIKELY((unsigned) offset <= tvb->length)((unsigned) offset <= tvb->length)) {
	real_offset = offset;
} else if ((unsigned) offset <= tvb->contained_length) {
	THROW(BoundsError)except_throw(1, (1), ((void*)0));
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
	THROW(FragmentBoundsError)except_throw(1, (4), ((void*)0));
} else if ((unsigned) offset <= tvb->reported_length) {
	THROW(ContainedBoundsError)except_throw(1, (2), ((void*)0));
} else {
	THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}
}
else {
/* Negative offset - relative to the end of the packet. */
/* Prevent UB on 2's complement platforms. */
unsigned abs_offset = ((unsigned)-(offset + 1)) + 1;
if (G_LIKELY(abs_offset <= tvb->length)(abs_offset <= tvb->length)) {
	real_offset = tvb->length - abs_offset;
} else if (abs_offset <= tvb->contained_length) {
	THROW(BoundsError)except_throw(1, (1), ((void*)0));
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
	THROW(FragmentBoundsError)except_throw(1, (4), ((void*)0));
} else if (abs_offset <= tvb->reported_length) {
	THROW(ContainedBoundsError)except_throw(1, (2), ((void*)0));
} else {
	THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}
}

/*
* Compute the offset of the first byte past the length.
*/
end_offset = real_offset + length;

/*
* Check for an overflow
*/
if (end_offset < real_offset)
THROW(BoundsError)except_throw(1, (1), ((void*)0));

if (G_LIKELY(end_offset <= tvb->length)(end_offset <= tvb->length))
return;
else if (end_offset <= tvb->contained_length)
THROW(BoundsError)except_throw(1, (1), ((void*)0));
else if (tvb->flags & TVBUFF_FRAGMENT0x00000001)
THROW(FragmentBoundsError)except_throw(1, (4), ((void*)0));
else if (end_offset <= tvb->reported_length)
THROW(ContainedBoundsError)except_throw(1, (2), ((void*)0));
else
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
735}

737bool_Bool
738tvb_offset_exists(const tvbuff_t *tvb, const int offset)
739{
unsigned abs_offset = 0;
int   exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 743, "tvb && tvb->initialized"
))));

exception = compute_offset(tvb, offset, &abs_offset);
if (exception)
return false0;

/* compute_offset only throws an exception on >, not >= because of the
* comment above check_offset_length_no_exception, but here we want the
* opposite behaviour so we check ourselves... */
return abs_offset < tvb->length;
753}

755unsigned
756tvb_reported_length(const tvbuff_t *tvb)
757{
DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 758, "tvb && tvb->initialized"
))));

return tvb->reported_length;
761}

763int
764tvb_reported_length_remaining(const tvbuff_t *tvb, const int offset)
765{
unsigned abs_offset = 0;
int   exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 769, "tvb && tvb->initialized"
))));

exception = compute_offset(tvb, offset, &abs_offset);
if (exception)
return 0;

if (tvb->reported_length >= abs_offset)
return tvb->reported_length - abs_offset;
else
return 0;
779}

781unsigned
782tvb_ensure_reported_length_remaining(const tvbuff_t *tvb, const int offset)
783{
unsigned abs_offset = 0;
int   exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 787, "tvb && tvb->initialized"
))));

exception = compute_offset(tvb, offset, &abs_offset);
if (exception)
THROW(exception)except_throw(1, (exception), ((void*)0));

if (tvb->reported_length >= abs_offset)
return tvb->reported_length - abs_offset;
else
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
797}

799/* Set the reported length of a tvbuff to a given value; used for protocols
* whose headers contain an explicit length and where the calling
* dissector's payload may include padding as well as the packet for
* this protocol.
* Also adjusts the available and contained length. */
804void
805tvb_set_reported_length(tvbuff_t *tvb, const unsigned reported_length)
806{
DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 807, "tvb && tvb->initialized"
))));

if (reported_length > tvb->reported_length)
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));

tvb->reported_length = reported_length;
if (reported_length < tvb->length)
tvb->length = reported_length;
if (reported_length < tvb->contained_length)
tvb->contained_length = reported_length;
817}

819/* Repair a tvbuff where the captured length is greater than the
* reported length; such a tvbuff makes no sense, as it's impossible
* to capture more data than is in the packet.
*/
823void
824tvb_fix_reported_length(tvbuff_t *tvb)
825{
DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 826, "tvb && tvb->initialized"
))));
DISSECTOR_ASSERT(tvb->reported_length < tvb->length)((void) ((tvb->reported_length < tvb->length) ? (void
)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 827, "tvb->reported_length < tvb->length"
))));

tvb->reported_length = tvb->length;
if (tvb->contained_length < tvb->length)
tvb->contained_length = tvb->length;
832}

834unsigned
835tvb_offset_from_real_beginning_counter(const tvbuff_t *tvb, const unsigned counter)
836{
if (tvb->ops->tvb_offset)
return tvb->ops->tvb_offset(tvb, counter);

DISSECTOR_ASSERT_NOT_REACHED()(proto_report_dissector_bug("%s:%u: failed assertion \"DISSECTOR_ASSERT_NOT_REACHED\""
, "epan/tvbuff.c", 840));
return 0;
842}

844unsigned
845tvb_offset_from_real_beginning(const tvbuff_t *tvb)
846{
return tvb_offset_from_real_beginning_counter(tvb, 0);
848}

850static inline const uint8_t*
851ensure_contiguous_no_exception(tvbuff_t *tvb, const int offset, const int length, int *pexception)
852{
unsigned abs_offset = 0, abs_length = 0;
int   exception;

exception = check_offset_length_no_exception(tvb, offset, length, &abs_offset, &abs_length);
if (exception) {
if (pexception)
	*pexception = exception;
return NULL((void*)0);
}

/*
* Special case: if the caller (e.g. tvb_get_ptr) requested no data,
* then it is acceptable to have an empty tvb (!tvb->real_data).
*/
if (length == 0) {
return NULL((void*)0);
}

/*
* We know that all the data is present in the tvbuff, so
* no exceptions should be thrown.
*/
if (tvb->real_data)
return tvb->real_data + abs_offset;

if (tvb->ops->tvb_get_ptr)
return tvb->ops->tvb_get_ptr(tvb, abs_offset, abs_length);

DISSECTOR_ASSERT_NOT_REACHED()(proto_report_dissector_bug("%s:%u: failed assertion \"DISSECTOR_ASSERT_NOT_REACHED\""
, "epan/tvbuff.c", 881));
return NULL((void*)0);
883}

885static inline const uint8_t*
886ensure_contiguous(tvbuff_t *tvb, const int offset, const int length)
887{
int           exception = 0;
const uint8_t *p;

p = ensure_contiguous_no_exception(tvb, offset, length, &exception);
if (p == NULL((void*)0) && length != 0) {
DISSECTOR_ASSERT(exception > 0)((void) ((exception > 0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 893, "exception > 0"
))));
THROW(exception)except_throw(1, (exception), ((void*)0));
}
return p;
897}

899static inline const uint8_t*
900fast_ensure_contiguous(tvbuff_t *tvb, const int offset, const unsigned length)
901{
unsigned end_offset;
unsigned u_offset;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 905, "tvb && tvb->initialized"
))));
/* We don't check for overflow in this fast path so we only handle simple types */
DISSECTOR_ASSERT(length <= 8)((void) ((length <= 8) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 907, "length <= 8"
))));

if (offset < 0 || !tvb->real_data) {
return ensure_contiguous(tvb, offset, length);
}

u_offset = offset;
end_offset = u_offset + length;

if (G_LIKELY(end_offset <= tvb->length)(end_offset <= tvb->length)) {
return tvb->real_data + u_offset;
} else if (end_offset <= tvb->contained_length) {
THROW(BoundsError)except_throw(1, (1), ((void*)0));
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
THROW(FragmentBoundsError)except_throw(1, (4), ((void*)0));
} else if (end_offset <= tvb->reported_length) {
THROW(ContainedBoundsError)except_throw(1, (2), ((void*)0));
} else {
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}
/* not reached */
return NULL((void*)0);
929}



933/************** ACCESSORS **************/

935void *
936tvb_memcpy(tvbuff_t *tvb, void *target, const int offset, size_t length)
937{
unsigned	abs_offset = 0, abs_length = 0;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 940, "tvb && tvb->initialized"
))));

/*
* XXX - we should eliminate the "length = -1 means 'to the end
* of the tvbuff'" convention, and use other means to achieve
* that; this would let us eliminate a bunch of checks for
* negative lengths in cases where the protocol has a 32-bit
* length field.
*
* Allowing -1 but throwing an assertion on other negative
* lengths is a bit more work with the length being a size_t;
* instead, we check for a length <= 2^31-1.
*/
DISSECTOR_ASSERT(length <= 0x7FFFFFFF)((void) ((length <= 0x7FFFFFFF) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 953, "length <= 0x7FFFFFFF"
))));
check_offset_length(tvb, offset, (int) length, &abs_offset, &abs_length);

if (target && tvb->real_data) {
return memcpy(target, tvb->real_data + abs_offset, abs_length);
}

if (target && tvb->ops->tvb_memcpy)
return tvb->ops->tvb_memcpy(tvb, target, abs_offset, abs_length);

/*
* If the length is 0, there's nothing to do.
* (tvb->real_data could be null if it's allocated with
* a size of length.)
*/
if (length != 0) {
/*
 * XXX, fallback to slower method
 */
DISSECTOR_ASSERT_NOT_REACHED()(proto_report_dissector_bug("%s:%u: failed assertion \"DISSECTOR_ASSERT_NOT_REACHED\""
, "epan/tvbuff.c", 972));
}
return NULL((void*)0);
975}


978/*
* XXX - this doesn't treat a length of -1 as an error.
* If it did, this could replace some code that calls
* "tvb_ensure_bytes_exist()" and then allocates a buffer and copies
* data to it.
*
* "composite_get_ptr()" depends on -1 not being
* an error; does anything else depend on this routine treating -1 as
* meaning "to the end of the buffer"?
*
* If scope is NULL, memory is allocated with g_malloc() and user must
* explicitly free it with g_free().
* If scope is not NULL, memory is allocated with the corresponding pool
* lifetime.
*/
993void *
994tvb_memdup(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, size_t length)
995{
unsigned  abs_offset = 0, abs_length = 0;
void  *duped;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 999, "tvb && tvb->initialized"
))));

check_offset_length(tvb, offset, (int) length, &abs_offset, &abs_length);

if (abs_length == 0)
return NULL((void*)0);

duped = wmem_alloc(scope, abs_length);
return tvb_memcpy(tvb, duped, abs_offset, abs_length);
1008}



1012const uint8_t*
1013tvb_get_ptr(tvbuff_t *tvb, const int offset, const int length)
1014{
return ensure_contiguous(tvb, offset, length);
1016}

1018/* ---------------- */
1019uint8_t
1020tvb_get_uint8(tvbuff_t *tvb, const int offset)
1021{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 1);
return *ptr;
1026}

1028int8_t
1029tvb_get_int8(tvbuff_t *tvb, const int offset)
1030{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 1);
return *ptr;
1035}

1037uint16_t
1038tvb_get_ntohs(tvbuff_t *tvb, const int offset)
1039{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 2);
return pntohu16(ptr);
1044}

1046int16_t
1047tvb_get_ntohis(tvbuff_t *tvb, const int offset)
1048{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 2);
return pntohu16(ptr);
1053}

1055uint32_t
1056tvb_get_ntoh24(tvbuff_t *tvb, const int offset)
1057{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 3);
return pntohu24(ptr);
1062}

1064int32_t
1065tvb_get_ntohi24(tvbuff_t *tvb, const int offset)
1066{
uint32_t ret;

ret = ws_sign_ext32(tvb_get_ntoh24(tvb, offset), 24);

return (int32_t)ret;
1072}

1074uint32_t
1075tvb_get_ntohl(tvbuff_t *tvb, const int offset)
1076{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 4);
return pntohu32(ptr);
1081}

1083int32_t
1084tvb_get_ntohil(tvbuff_t *tvb, const int offset)
1085{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 4);
return pntohu32(ptr);
1090}

1092uint64_t
1093tvb_get_ntoh40(tvbuff_t *tvb, const int offset)
1094{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 5);
return pntohu40(ptr);
1099}

1101int64_t
1102tvb_get_ntohi40(tvbuff_t *tvb, const int offset)
1103{
uint64_t ret;

ret = ws_sign_ext64(tvb_get_ntoh40(tvb, offset), 40);

return (int64_t)ret;
1109}

1111uint64_t
1112tvb_get_ntoh48(tvbuff_t *tvb, const int offset)
1113{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 6);
return pntohu48(ptr);
1118}

1120int64_t
1121tvb_get_ntohi48(tvbuff_t *tvb, const int offset)
1122{
uint64_t ret;

ret = ws_sign_ext64(tvb_get_ntoh48(tvb, offset), 48);

return (int64_t)ret;
1128}

1130uint64_t
1131tvb_get_ntoh56(tvbuff_t *tvb, const int offset)
1132{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 7);
return pntohu56(ptr);
1137}

1139int64_t
1140tvb_get_ntohi56(tvbuff_t *tvb, const int offset)
1141{
uint64_t ret;

ret = ws_sign_ext64(tvb_get_ntoh56(tvb, offset), 56);

return (int64_t)ret;
1147}

1149uint64_t
1150tvb_get_ntoh64(tvbuff_t *tvb, const int offset)
1151{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 8);
return pntohu64(ptr);
1156}

1158int64_t
1159tvb_get_ntohi64(tvbuff_t *tvb, const int offset)
1160{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 8);
return pntohu64(ptr);
1165}

1167uint16_t
1168tvb_get_uint16(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohs(tvb, offset);
} else {
return tvb_get_ntohs(tvb, offset);
}
1174}

1176int16_t
1177tvb_get_int16(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohis(tvb, offset);
} else {
return tvb_get_ntohis(tvb, offset);
}
1183}

1185uint32_t
1186tvb_get_uint24(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letoh24(tvb, offset);
} else {
return tvb_get_ntoh24(tvb, offset);
}
1192}

1194int32_t
1195tvb_get_int24(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohi24(tvb, offset);
} else {
return tvb_get_ntohi24(tvb, offset);
}
1201}

1203uint32_t
1204tvb_get_uint32(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohl(tvb, offset);
} else {
return tvb_get_ntohl(tvb, offset);
}
1210}

1212int32_t
1213tvb_get_int32(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohil(tvb, offset);
} else {
return tvb_get_ntohil(tvb, offset);
}
1219}

1221uint64_t
1222tvb_get_uint40(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letoh40(tvb, offset);
} else {
return tvb_get_ntoh40(tvb, offset);
}
1228}

1230int64_t
1231tvb_get_int40(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohi40(tvb, offset);
} else {
return tvb_get_ntohi40(tvb, offset);
}
1237}

1239uint64_t
1240tvb_get_uint48(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letoh48(tvb, offset);
} else {
return tvb_get_ntoh48(tvb, offset);
}
1246}

1248int64_t
1249tvb_get_int48(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohi48(tvb, offset);
} else {
return tvb_get_ntohi48(tvb, offset);
}
1255}

1257uint64_t
1258tvb_get_uint56(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letoh56(tvb, offset);
} else {
return tvb_get_ntoh56(tvb, offset);
}
1264}

1266int64_t
1267tvb_get_int56(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohi56(tvb, offset);
} else {
return tvb_get_ntohi56(tvb, offset);
}
1273}

1275uint64_t
1276tvb_get_uint64(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letoh64(tvb, offset);
} else {
return tvb_get_ntoh64(tvb, offset);
}
1282}

1284uint64_t
1285tvb_get_uint64_with_length(tvbuff_t *tvb, const int offset, unsigned length, const unsigned encoding)
1286{
uint64_t value;

switch (length) {

case 1:
value = tvb_get_uint8(tvb, offset);
break;

case 2:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letohs(tvb, offset)
				       : tvb_get_ntohs(tvb, offset);
break;

case 3:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letoh24(tvb, offset)
				       : tvb_get_ntoh24(tvb, offset);
break;

case 4:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letohl(tvb, offset)
				       : tvb_get_ntohl(tvb, offset);
break;

case 5:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letoh40(tvb, offset)
				       : tvb_get_ntoh40(tvb, offset);
break;

case 6:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letoh48(tvb, offset)
				       : tvb_get_ntoh48(tvb, offset);
break;

case 7:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letoh56(tvb, offset)
				       : tvb_get_ntoh56(tvb, offset);
break;

case 8:
value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letoh64(tvb, offset)
				       : tvb_get_ntoh64(tvb, offset);
break;

default:
if (length < 1) {
	value = 0;
} else {
	value = (encoding & ENC_LITTLE_ENDIAN0x80000000) ? tvb_get_letoh64(tvb, offset)
					       : tvb_get_ntoh64(tvb, offset);
}
break;
}
return value;
1340}

1342int64_t
1343tvb_get_int64(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohi64(tvb, offset);
} else {
return tvb_get_ntohi64(tvb, offset);
}
1349}

1351float
1352tvb_get_ieee_float(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohieee_float(tvb, offset);
} else {
return tvb_get_ntohieee_float(tvb, offset);
}
1358}

1360double
1361tvb_get_ieee_double(tvbuff_t *tvb, const int offset, const unsigned encoding) {
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return tvb_get_letohieee_double(tvb, offset);
} else {
return tvb_get_ntohieee_double(tvb, offset);
}
1367}

1369/*
* Stuff for IEEE float handling on platforms that don't have IEEE
* format as the native floating-point format.
*
* For now, we treat only the VAX as such a platform.
*
* XXX - other non-IEEE boxes that can run UN*X include some Crays,
* and possibly other machines.  However, I don't know whether there
* are any other machines that could run Wireshark and that don't use
* IEEE format.  As far as I know, all of the main current and past
* commercial microprocessor families on which OSes that support
* Wireshark can run use IEEE format (x86, ARM, 68k, SPARC, MIPS,
* PA-RISC, Alpha, IA-64, and so on), and it appears that the official
* Linux port to System/390 and zArchitecture uses IEEE format floating-
* point rather than IBM hex floating-point (not a huge surprise), so
* I'm not sure that leaves any 32-bit or larger UN*X or Windows boxes,
* other than VAXes, that don't use IEEE format.  If you're not running
* UN*X or Windows, the floating-point format is probably going to be
* the least of your problems in a port.
*/

1390#if defined(vax)

1392#include <math.h>

1394/*
* Single-precision.
*/
1397#define IEEE_SP_NUMBER_WIDTH	32	/* bits in number */
1398#define IEEE_SP_EXP_WIDTH	8	/* bits in exponent */
1399#define IEEE_SP_MANTISSA_WIDTH	23	/* IEEE_SP_NUMBER_WIDTH - 1 - IEEE_SP_EXP_WIDTH */

1401#define IEEE_SP_SIGN_MASK	0x80000000
1402#define IEEE_SP_EXPONENT_MASK	0x7F800000
1403#define IEEE_SP_MANTISSA_MASK	0x007FFFFF
1404#define IEEE_SP_INFINITY	IEEE_SP_EXPONENT_MASK

1406#define IEEE_SP_IMPLIED_BIT (1 << IEEE_SP_MANTISSA_WIDTH)
1407#define IEEE_SP_INFINITE ((1 << IEEE_SP_EXP_WIDTH) - 1)
1408#define IEEE_SP_BIAS ((1 << (IEEE_SP_EXP_WIDTH - 1)) - 1)

1410static int
1411ieee_float_is_zero(const uint32_t w)
1412{
return ((w & ~IEEE_SP_SIGN_MASK) == 0);
1414}

1416static float
1417get_ieee_float(const uint32_t w)
1418{
long sign;
long exponent;
long mantissa;

sign = w & IEEE_SP_SIGN_MASK;
exponent = w & IEEE_SP_EXPONENT_MASK;
mantissa = w & IEEE_SP_MANTISSA_MASK;

if (ieee_float_is_zero(w)) {
/* number is zero, unnormalized, or not-a-number */
return 0.0;
}
1431#if 0
/*
* XXX - how to handle this?
*/
if (IEEE_SP_INFINITY == exponent) {
/*
 * number is positive or negative infinity, or a special value
 */
return (sign? MINUS_INFINITY: PLUS_INFINITY);
}
1441#endif

exponent = ((exponent >> IEEE_SP_MANTISSA_WIDTH) - IEEE_SP_BIAS) -
IEEE_SP_MANTISSA_WIDTH;
mantissa |= IEEE_SP_IMPLIED_BIT;

if (sign)
return -mantissa * pow(2, exponent);
else
return mantissa * pow(2, exponent);
1451}

1453/*
* Double-precision.
* We assume that if you don't have IEEE floating-point, you have a
* compiler that understands 64-bit integral quantities.
*/
1458#define IEEE_DP_NUMBER_WIDTH	64	/* bits in number */
1459#define IEEE_DP_EXP_WIDTH	11	/* bits in exponent */
1460#define IEEE_DP_MANTISSA_WIDTH	52	/* IEEE_DP_NUMBER_WIDTH - 1 - IEEE_DP_EXP_WIDTH */

1462#define IEEE_DP_SIGN_MASK	INT64_C(0x8000000000000000)0x8000000000000000L
1463#define IEEE_DP_EXPONENT_MASK	INT64_C(0x7FF0000000000000)0x7FF0000000000000L
1464#define IEEE_DP_MANTISSA_MASK	INT64_C(0x000FFFFFFFFFFFFF)0x000FFFFFFFFFFFFFL
1465#define IEEE_DP_INFINITY	IEEE_DP_EXPONENT_MASK

1467#define IEEE_DP_IMPLIED_BIT (INT64_C(1)1L << IEEE_DP_MANTISSA_WIDTH)
1468#define IEEE_DP_INFINITE ((1 << IEEE_DP_EXP_WIDTH) - 1)
1469#define IEEE_DP_BIAS ((1 << (IEEE_DP_EXP_WIDTH - 1)) - 1)

1471static int
1472ieee_double_is_zero(const uint64_t w)
1473{
return ((w & ~IEEE_SP_SIGN_MASK) == 0);
1475}

1477static double
1478get_ieee_double(const uint64_t w)
1479{
int64_t sign;
int64_t exponent;
int64_t mantissa;

sign = w & IEEE_DP_SIGN_MASK;
exponent = w & IEEE_DP_EXPONENT_MASK;
mantissa = w & IEEE_DP_MANTISSA_MASK;

if (ieee_double_is_zero(w)) {
/* number is zero, unnormalized, or not-a-number */
return 0.0;
}
1492#if 0
/*
* XXX - how to handle this?
*/
if (IEEE_DP_INFINITY == exponent) {
/*
 * number is positive or negative infinity, or a special value
 */
return (sign? MINUS_INFINITY: PLUS_INFINITY);
}
1502#endif

exponent = ((exponent >> IEEE_DP_MANTISSA_WIDTH) - IEEE_DP_BIAS) -
IEEE_DP_MANTISSA_WIDTH;
mantissa |= IEEE_DP_IMPLIED_BIT;

if (sign)
return -mantissa * pow(2, exponent);
else
return mantissa * pow(2, exponent);
1512}
1513#endif

1515/*
* Fetches an IEEE single-precision floating-point number, in
* big-endian form, and returns a "float".
*
* XXX - should this be "double", in case there are IEEE single-
* precision numbers that won't fit in some platform's native
* "float" format?
*/
1523float
1524tvb_get_ntohieee_float(tvbuff_t *tvb, const int offset)
1525{
1526#if defined(vax)
return get_ieee_float(tvb_get_ntohl(tvb, offset));
1528#else
union {
float	f;
uint32_t w;
} ieee_fp_union;

ieee_fp_union.w = tvb_get_ntohl(tvb, offset);
return ieee_fp_union.f;
1536#endif
1537}

1539/*
* Fetches an IEEE double-precision floating-point number, in
* big-endian form, and returns a "double".
*/
1543double
1544tvb_get_ntohieee_double(tvbuff_t *tvb, const int offset)
1545{
1546#if defined(vax)
union {
uint32_t w[2];
uint64_t dw;
} ieee_fp_union;
1551#else
union {
double d;
uint32_t w[2];
} ieee_fp_union;
1556#endif

1558#if G_BYTE_ORDER1234 == G_BIG_ENDIAN4321
ieee_fp_union.w[0] = tvb_get_ntohl(tvb, offset);
ieee_fp_union.w[1] = tvb_get_ntohl(tvb, offset+4);
1561#else
ieee_fp_union.w[0] = tvb_get_ntohl(tvb, offset+4);
ieee_fp_union.w[1] = tvb_get_ntohl(tvb, offset);
1564#endif
1565#if defined(vax)
return get_ieee_double(ieee_fp_union.dw);
1567#else
return ieee_fp_union.d;
1569#endif
1570}

1572uint16_t
1573tvb_get_letohs(tvbuff_t *tvb, const int offset)
1574{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 2);
return pletohu16(ptr);
1579}

1581int16_t
1582tvb_get_letohis(tvbuff_t *tvb, const int offset)
1583{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 2);
return pletohu16(ptr);
1588}

1590uint32_t
1591tvb_get_letoh24(tvbuff_t *tvb, const int offset)
1592{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 3);
return pletohu24(ptr);
1597}

1599int32_t
1600tvb_get_letohi24(tvbuff_t *tvb, const int offset)
1601{
uint32_t ret;

ret = ws_sign_ext32(tvb_get_letoh24(tvb, offset), 24);

return (int32_t)ret;
1607}

1609uint32_t
1610tvb_get_letohl(tvbuff_t *tvb, const int offset)
1611{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 4);
return pletohu32(ptr);
1616}

1618int32_t
1619tvb_get_letohil(tvbuff_t *tvb, const int offset)
1620{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 4);
return pletohu32(ptr);
1625}

1627uint64_t
1628tvb_get_letoh40(tvbuff_t *tvb, const int offset)
1629{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 5);
return pletohu40(ptr);
1634}

1636int64_t
1637tvb_get_letohi40(tvbuff_t *tvb, const int offset)
1638{
uint64_t ret;

ret = ws_sign_ext64(tvb_get_letoh40(tvb, offset), 40);

return (int64_t)ret;
1644}

1646uint64_t
1647tvb_get_letoh48(tvbuff_t *tvb, const int offset)
1648{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 6);
return pletohu48(ptr);
1653}

1655int64_t
1656tvb_get_letohi48(tvbuff_t *tvb, const int offset)
1657{
uint64_t ret;

ret = ws_sign_ext64(tvb_get_letoh48(tvb, offset), 48);

return (int64_t)ret;
1663}

1665uint64_t
1666tvb_get_letoh56(tvbuff_t *tvb, const int offset)
1667{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 7);
return pletohu56(ptr);
1672}

1674int64_t
1675tvb_get_letohi56(tvbuff_t *tvb, const int offset)
1676{
uint64_t ret;

ret = ws_sign_ext64(tvb_get_letoh56(tvb, offset), 56);

return (int64_t)ret;
1682}

1684uint64_t
1685tvb_get_letoh64(tvbuff_t *tvb, const int offset)
1686{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 8);
return pletohu64(ptr);
1691}

1693int64_t
1694tvb_get_letohi64(tvbuff_t *tvb, const int offset)
1695{
const uint8_t *ptr;

ptr = fast_ensure_contiguous(tvb, offset, 8);
return pletohu64(ptr);
1700}

1702/*
* Fetches an IEEE single-precision floating-point number, in
* little-endian form, and returns a "float".
*
* XXX - should this be "double", in case there are IEEE single-
* precision numbers that won't fit in some platform's native
* "float" format?
*/
1710float
1711tvb_get_letohieee_float(tvbuff_t *tvb, const int offset)
1712{
1713#if defined(vax)
return get_ieee_float(tvb_get_letohl(tvb, offset));
1715#else
union {
float f;
uint32_t w;
} ieee_fp_union;

ieee_fp_union.w = tvb_get_letohl(tvb, offset);
return ieee_fp_union.f;
1723#endif
1724}

1726/*
* Fetches an IEEE double-precision floating-point number, in
* little-endian form, and returns a "double".
*/
1730double
1731tvb_get_letohieee_double(tvbuff_t *tvb, const int offset)
1732{
1733#if defined(vax)
union {
uint32_t w[2];
uint64_t dw;
} ieee_fp_union;
1738#else
union {
double d;
uint32_t w[2];
} ieee_fp_union;
1743#endif

1745#if G_BYTE_ORDER1234 == G_BIG_ENDIAN4321
ieee_fp_union.w[0] = tvb_get_letohl(tvb, offset+4);
ieee_fp_union.w[1] = tvb_get_letohl(tvb, offset);
1748#else
ieee_fp_union.w[0] = tvb_get_letohl(tvb, offset);
ieee_fp_union.w[1] = tvb_get_letohl(tvb, offset+4);
1751#endif
1752#if defined(vax)
return get_ieee_double(ieee_fp_union.dw);
1754#else
return ieee_fp_union.d;
1756#endif
1757}

1759/* This function is a slight misnomer. It accepts all encodings that are
* ASCII "enough", which means encodings that are the same as US-ASCII
* for textual representations of dates and hex bytes; i.e., the same
* for the hex digits and Z (in practice, all alphanumerics), and the
* four separators ':' '-' '.' and ' '
* That means that any encoding that keeps the ISO/IEC 646 invariant
* characters the same (including the T.61 8 bit encoding and multibyte
* encodings like EUC-KR and GB18030) are OK, even if they replace characters
* like '$' '#' and '\' with national variants, but not encodings like UTF-16
* that include extra null bytes.
* For our current purposes, the unpacked GSM 7-bit default alphabet (but not
* all National Language Shift Tables) also satisfies this requirement, but
* note that it does *not* keep all ISO/IEC 646 invariant characters the same.
* If this internal function gets used for additional purposes than currently,
* the set of encodings that it accepts could change.
* */
1775static inline void
1776validate_single_byte_ascii_encoding(const unsigned encoding)
1777{
const unsigned enc = encoding & ~ENC_CHARENCODING_MASK0x0000FFFE;

switch (enc) {
   case ENC_UTF_160x00000004:
   case ENC_UCS_20x00000006:
   case ENC_UCS_40x00000008:
   case ENC_3GPP_TS_23_038_7BITS_PACKED0x0000002C:
   case ENC_ASCII_7BITS0x00000034:
   case ENC_EBCDIC0x0000002E:
   case ENC_EBCDIC_CP0370x00000038:
   case ENC_EBCDIC_CP5000x00000060:
   case ENC_BCD_DIGITS_0_90x00000044:
   case ENC_KEYPAD_ABC_TBCD0x00000046:
   case ENC_KEYPAD_BC_TBCD0x00000048:
   case ENC_ETSI_TS_102_221_ANNEX_A0x0000004E:
   case ENC_APN_STR0x00000054:
   case ENC_DECT_STANDARD_4BITS_TBCD0x00000058:
   REPORT_DISSECTOR_BUG("Invalid string encoding type passed to tvb_get_string_XXX")proto_report_dissector_bug("Invalid string encoding type passed to tvb_get_string_XXX"
);
   break;
   default:
   break;
}
/* make sure something valid was set */
if (enc == 0)
   REPORT_DISSECTOR_BUG("No string encoding type passed to tvb_get_string_XXX")proto_report_dissector_bug("No string encoding type passed to tvb_get_string_XXX"
);
1803}

1805GByteArray*
1806tvb_get_string_bytes(tvbuff_t *tvb, const int offset, const int length,
     const unsigned encoding, GByteArray *bytes, int *endoff)
1808{
char *ptr;
const char *begin;
const char *end    = NULL((void*)0);
GByteArray  *retval = NULL((void*)0);

validate_single_byte_ascii_encoding(encoding);

ptr = (char*) tvb_get_raw_string(NULL((void*)0), tvb, offset, length);
begin = ptr;

if (endoff) *endoff = offset;

while (*begin == ' ') begin++;

if (*begin && bytes) {
if (hex_str_to_bytes_encoding(begin, bytes, &end, encoding, false0)) {
	if (bytes->len > 0) {
		if (endoff) *endoff = offset + (int)(end - ptr);
		retval = bytes;
	}
}
}

wmem_free(NULL((void*)0), ptr);

return retval;
1835}

1837static bool_Bool
1838parse_month_name(const char *name, int *tm_mon)
1839{
static const char months[][4] = { "Jan", "Feb", "Mar", "Apr", "May",
"Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" };
for (int i = 0; i < 12; i++) {
if (memcmp(months[i], name, 4) == 0) {
	*tm_mon = i;
	return true1;
}
}
return false0;
1849}

1851/*
* Is the character a WSP character, as per RFC 5234?  (space or tab).
*/
1854#define IS_WSP(c)((c) == ' ' || (c) == '\t')	((c) == ' ' || (c) == '\t')

1856/* support hex-encoded time values? */
1857nstime_t*
1858tvb_get_string_time(tvbuff_t *tvb, const int offset, const int length,
    const unsigned encoding, nstime_t *ns, int *endoff)
1860{
char *begin;
const char *ptr;
const char *end       = NULL((void*)0);
int	     num_chars = 0;
int	     utc_offset = 0;

validate_single_byte_ascii_encoding(encoding);

DISSECTOR_ASSERT(ns)((void) ((ns) ? (void)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 1869, "ns"))));

begin = (char*) tvb_get_raw_string(NULL((void*)0), tvb, offset, length);
ptr = begin;

while (IS_WSP(*ptr)((*ptr) == ' ' || (*ptr) == '\t'))
ptr++;

if (*ptr) {
if ((encoding & ENC_ISO_8601_DATE_TIME0x00030000) == ENC_ISO_8601_DATE_TIME0x00030000) {
	if (!(end = iso8601_to_nstime(ns, ptr, ISO8601_DATETIME))) {


		goto fail;
	}
} else if ((encoding & ENC_ISO_8601_DATE_TIME_BASIC0x00100000) == ENC_ISO_8601_DATE_TIME_BASIC0x00100000) {
	if (!(end = iso8601_to_nstime(ns, ptr, ISO8601_DATETIME_BASIC))) {


		goto fail;
	}
} else {
	struct tm    tm;

	memset(&tm, 0, sizeof(tm));
	tm.tm_isdst = -1;
	ns->secs    = 0;
	ns->nsecs   = 0;

	/* note: sscanf is known to be inconsistent across platforms with respect
	   to whether a %n is counted as a return value or not, so we have to use
	   '>=' a lot */
	if (encoding & ENC_ISO_8601_DATE0x00010000) {
		/* 2014-04-07 */
		if (sscanf(ptr, "%d-%d-%d%n",
		    &tm.tm_year,
		    &tm.tm_mon,
		    &tm.tm_mday,
		    &num_chars) >= 3)
		{
			end = ptr + num_chars;
			tm.tm_mon--;
			if (tm.tm_year > 1900) tm.tm_year -= 1900;
		} else {
			goto fail;
		}
	}
	else if (encoding & ENC_ISO_8601_TIME0x00020000) {
		/* 2014-04-07 */
		if (sscanf(ptr, "%d:%d:%d%n",
		    &tm.tm_hour,
		    &tm.tm_min,
		    &tm.tm_sec,
		    &num_chars) >= 2)
		{
			/* what should we do about day/month/year? */
			/* setting it to "now" for now */
			time_t time_now = time(NULL((void*)0));
			struct tm *tm_now = gmtime(&time_now);
			if (tm_now != NULL((void*)0)) {
				tm.tm_year = tm_now->tm_year;
				tm.tm_mon  = tm_now->tm_mon;
				tm.tm_mday = tm_now->tm_mday;
			} else {
				/* The second before the Epoch */
				tm.tm_year = 69;
				tm.tm_mon = 12;
				tm.tm_mday = 31;
			}
			end = ptr + num_chars;
		} else {
			goto fail;
		}
	}
	else if (encoding & ENC_IMF_DATE_TIME0x00040000) {
		/*
		 * Match [dow,] day month year hh:mm[:ss] with
		 * two-digit years (RFC 822) or four-digit
		 * years (RFCs 1123, 2822, 5822). Skip
		 * the day of week since it is locale
		 * dependent and does not affect the resulting
		 * date anyway.
		 */
		if (g_ascii_isalpha(ptr[0])((g_ascii_table[(guchar) (ptr[0])] & G_ASCII_ALPHA) != 0) && g_ascii_isalpha(ptr[1])((g_ascii_table[(guchar) (ptr[1])] & G_ASCII_ALPHA) != 0) && g_ascii_isalpha(ptr[2])((g_ascii_table[(guchar) (ptr[2])] & G_ASCII_ALPHA) != 0) && ptr[3] == ',')
			ptr += 4;   /* Skip day of week. */

		/*
		 * Parse the day-of-month and month
		 * name.
		 */
		char month_name[4] = { 0 };

		if (sscanf(ptr, "%d %3s%n",
		    &tm.tm_mday,
		    month_name,
		    &num_chars) < 2)
		{
			/* Not matched. */
			goto fail;
		}
		if (!parse_month_name(month_name, &tm.tm_mon)) {
			goto fail;
		}
		ptr += num_chars;
		while (IS_WSP(*ptr)((*ptr) == ' ' || (*ptr) == '\t'))
			ptr++;

		/*
		 * Scan the year.  Treat 2-digit years
		 * differently from 4-digit years.
		 */
		uint32_t year;
		const char *yearendp;

		if (!ws_strtou32(ptr, &yearendp, &year)) {
			goto fail;
		}
		if (!IS_WSP(*yearendp)((*yearendp) == ' ' || (*yearendp) == '\t')) {
			/* Not followed by WSP. */
			goto fail;
		}
		if (yearendp - ptr < 2) {
			/* 1-digit year.  Error. */
			goto fail;
		}
		if (yearendp - ptr == 2) {
			/*
			 * 2-digit year.
			 *
			 * Match RFC 2822/RFC 5322 behavior;
			 * add 2000 to years from 0 to
			 * 49 and 1900 to uears from 50
			 * to 99.
			 */
			if (year <= 49) {
				year += 2000;
			} else {
				year += 1900;
			}
		} else if (yearendp - ptr == 3) {
			/*
			 * 3-digit year.
			 *
			 * Match RFC 2822/RFC 5322 behavior;
			 * add 1900 to the year.
			 */
			year += 1900;
		}
		tm.tm_year = year - 1900;
		ptr = yearendp;
		while (IS_WSP(*ptr)((*ptr) == ' ' || (*ptr) == '\t'))
			ptr++;

		/* Parse the time. */
		if (sscanf(ptr, "%d:%d%n:%d%n",
		    &tm.tm_hour,
		    &tm.tm_min,
		    &num_chars,
		    &tm.tm_sec,
		    &num_chars) < 2)
		{
			goto fail;
		}
		ptr += num_chars;
		while (IS_WSP(*ptr)((*ptr) == ' ' || (*ptr) == '\t'))
			ptr++;

		/*
		 * Parse the time zone.
		 * Check for obs-zone values first.
		 */
		if (g_ascii_strncasecmp(ptr, "UT", 2) == 0)
		{
			ptr += 2;
		}
		else if (g_ascii_strncasecmp(ptr, "GMT", 3) == 0)
		{
			ptr += 3;
		}
		else
		{
			char sign;
			int off_hr;
			int off_min;

			if (sscanf(ptr, "%c%2d%2d%n",
			    &sign,
			    &off_hr,
			    &off_min,
			    &num_chars) < 3)
			{
				goto fail;
			}

			/*
			 * If sign is '+', there's a positive
			 * UTC offset.
			 *
			 * If sign is '-', there's a negative
			 * UTC offset.
			 *
			 * Otherwise, that's an invalid UTC
			 * offset string.
			 */
			if (sign == '+')
				utc_offset += (off_hr * 3600) + (off_min * 60);
			else if (sign == '-')
				utc_offset -= (off_hr * 3600) + (off_min * 60);
			else {
				/* Sign must be + or - */
				goto fail;
			}
			ptr += num_chars;
		}
		end = ptr;
	}
	ns->secs = mktime_utc(&tm);
	if (ns->secs == (time_t)-1 && errno(*__errno_location ()) != 0) {
		goto fail;
	}
	ns->secs += utc_offset;
}
} else {
/* Empty string */
goto fail;
}

if (endoff)
   *endoff = (int)(offset + (end - begin));
wmem_free(NULL((void*)0), begin);
return ns;

2101fail:
wmem_free(NULL((void*)0), begin);
return NULL((void*)0);
2104}

2106/* Fetch an IPv4 address, in network byte order.
* We do *not* convert them to host byte order; we leave them in
* network byte order. */
2109uint32_t
2110tvb_get_ipv4(tvbuff_t *tvb, const int offset)
2111{
const uint8_t *ptr;
uint32_t      addr;

ptr = fast_ensure_contiguous(tvb, offset, sizeof(uint32_t));
memcpy(&addr, ptr, sizeof addr);
return addr;
2118}

2120/* Fetch an IPv6 address. */
2121void
2122tvb_get_ipv6(tvbuff_t *tvb, const int offset, ws_in6_addr *addr)
2123{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, sizeof(*addr));
memcpy(addr, ptr, sizeof *addr);
2128}

2130/*
* These routines return the length of the address in bytes on success
* and -1 if the prefix length is too long.
*/
2134int
2135tvb_get_ipv4_addr_with_prefix_len(tvbuff_t *tvb, int offset, ws_in4_addr *addr,
  uint32_t prefix_len)
2137{
uint8_t addr_len;

if (prefix_len > 32)
return -1;

addr_len = (prefix_len + 7) / 8;
*addr = 0;
tvb_memcpy(tvb, addr, offset, addr_len);
if (prefix_len % 8)
((uint8_t*)addr)[addr_len - 1] &= ((0xff00 >> (prefix_len % 8)) & 0xff);
return addr_len;
2149}

2151/*
* These routines return the length of the address in bytes on success
* and -1 if the prefix length is too long.
*/
2155int
2156tvb_get_ipv6_addr_with_prefix_len(tvbuff_t *tvb, int offset, ws_in6_addr *addr,
  uint32_t prefix_len)
2158{
uint32_t addr_len;

if (prefix_len > 128)
return -1;

addr_len = (prefix_len + 7) / 8;
memset(addr->bytes, 0, 16);
tvb_memcpy(tvb, addr->bytes, offset, addr_len);
if (prefix_len % 8) {
addr->bytes[addr_len - 1] &=
    ((0xff00 >> (prefix_len % 8)) & 0xff);
}

return addr_len;
2173}

2175/* Fetch a GUID. */
2176void
2177tvb_get_ntohguid(tvbuff_t *tvb, const int offset, e_guid_t *guid)
2178{
const uint8_t *ptr = ensure_contiguous(tvb, offset, GUID_LEN16);

guid->data1 = pntohu32(ptr + 0);
guid->data2 = pntohu16(ptr + 4);
guid->data3 = pntohu16(ptr + 6);
memcpy(guid->data4, ptr + 8, sizeof guid->data4);
2185}

2187void
2188tvb_get_letohguid(tvbuff_t *tvb, const int offset, e_guid_t *guid)
2189{
const uint8_t *ptr = ensure_contiguous(tvb, offset, GUID_LEN16);

guid->data1 = pletohu32(ptr + 0);
guid->data2 = pletohu16(ptr + 4);
guid->data3 = pletohu16(ptr + 6);
memcpy(guid->data4, ptr + 8, sizeof guid->data4);
2196}

2198void
2199tvb_get_guid(tvbuff_t *tvb, const int offset, e_guid_t *guid, const unsigned encoding)
2200{
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
tvb_get_letohguid(tvb, offset, guid);
} else {
tvb_get_ntohguid(tvb, offset, guid);
}
2206}

2208static const uint8_t bit_mask8[] = {
0x00,
0x01,
0x03,
0x07,
0x0f,
0x1f,
0x3f,
0x7f,
0xff
2218};


2221/* Get a variable amount of bits
*
* Return a byte array with bit limited data.
* When encoding is ENC_BIG_ENDIAN, the data is aligned to the left.
* When encoding is ENC_LITTLE_ENDIAN, the data is aligned to the right.
*/
2227uint8_t *
2228tvb_get_bits_array(wmem_allocator_t *scope, tvbuff_t *tvb, const int bit_offset,
   size_t no_of_bits, size_t *data_length, const unsigned encoding)
2230{
tvbuff_t *sub_tvb;
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
1
Assuming the condition is false→
2
←
Taking false branch→
sub_tvb = tvb_new_octet_right_aligned(tvb, bit_offset, (int32_t) no_of_bits);
} else {
sub_tvb = tvb_new_octet_aligned(tvb, bit_offset, (int32_t) no_of_bits);
3
←
Calling 'tvb_new_octet_aligned'→
}
*data_length = tvb_reported_length(sub_tvb);
return (uint8_t*)tvb_memdup(scope, sub_tvb, 0, *data_length);
2239}

2241/* Get 1 - 8 bits */
2242uint8_t
2243tvb_get_bits8(tvbuff_t *tvb, unsigned bit_offset, const int no_of_bits)
2244{
DISSECTOR_ASSERT_HINT(no_of_bits <= 8, "Too many bits requested for 8-bit return type")((void) ((no_of_bits <= 8) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\" (%s)", "epan/tvbuff.c", 2245
, "no_of_bits <= 8", "Too many bits requested for 8-bit return type"
))));
return (uint8_t)_tvb_get_bits64(tvb, bit_offset, no_of_bits);
2247}

2249/* Get 1 - 16 bits */
2250uint16_t
2251tvb_get_bits16(tvbuff_t *tvb, unsigned bit_offset, const int no_of_bits, const unsigned encoding)
2252{
DISSECTOR_ASSERT_HINT(no_of_bits <= 16, "Too many bits requested for 16-bit return type")((void) ((no_of_bits <= 16) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\" (%s)", "epan/tvbuff.c", 2253
, "no_of_bits <= 16", "Too many bits requested for 16-bit return type"
))));
return (uint16_t)tvb_get_bits64(tvb, bit_offset, no_of_bits, encoding);
2255}

2257/* Get 1 - 32 bits */
2258uint32_t
2259tvb_get_bits32(tvbuff_t *tvb, unsigned bit_offset, const int no_of_bits, const unsigned encoding)
2260{
DISSECTOR_ASSERT_HINT(no_of_bits <= 32, "Too many bits requested for 32-bit return type")((void) ((no_of_bits <= 32) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\" (%s)", "epan/tvbuff.c", 2261
, "no_of_bits <= 32", "Too many bits requested for 32-bit return type"
))));
return (uint32_t)tvb_get_bits64(tvb, bit_offset, no_of_bits, encoding);
2263}

2265/* Get 1 - 64 bits */
2266uint64_t
2267tvb_get_bits64(tvbuff_t *tvb, unsigned bit_offset, const int no_of_bits, const unsigned encoding)
2268{
DISSECTOR_ASSERT_HINT(no_of_bits <= 64, "Too many bits requested for 64-bit return type")((void) ((no_of_bits <= 64) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\" (%s)", "epan/tvbuff.c", 2269
, "no_of_bits <= 64", "Too many bits requested for 64-bit return type"
))));

/* encoding determines bit numbering within octet array */
if (encoding & ENC_LITTLE_ENDIAN0x80000000) {
return _tvb_get_bits64_le(tvb, bit_offset, no_of_bits);
} else {
return _tvb_get_bits64(tvb, bit_offset, no_of_bits);
}
2277}

2279/*
* This function will dissect a sequence of bits that does not need to be byte aligned; the bits
* set will be shown in the tree as ..10 10.. and the integer value returned if return_value is set.
* Offset should be given in bits from the start of the tvb.
* Bits within octet are numbered from MSB (0) to LSB (7). Bit at bit_offset is return value most significant bit.
* The function tolerates requests for more than 64 bits, but will only return the least significant 64 bits.
*/
2286static uint64_t
2287_tvb_get_bits64(tvbuff_t *tvb, unsigned bit_offset, const int total_no_of_bits)
2288{
uint64_t value;
unsigned	octet_offset = bit_offset >> 3;
uint8_t	required_bits_in_first_octet = 8 - (bit_offset % 8);

if(required_bits_in_first_octet > total_no_of_bits)
{
/* the required bits don't extend to the end of the first octet */
uint8_t right_shift = required_bits_in_first_octet - total_no_of_bits;
value = (tvb_get_uint8(tvb, octet_offset) >> right_shift) & bit_mask8[total_no_of_bits % 8];
}
else
{
uint8_t remaining_bit_length = total_no_of_bits;

/* get the bits up to the first octet boundary */
value = 0;
required_bits_in_first_octet %= 8;
if(required_bits_in_first_octet != 0)
{
	value = tvb_get_uint8(tvb, octet_offset) & bit_mask8[required_bits_in_first_octet];
	remaining_bit_length -= required_bits_in_first_octet;
	octet_offset ++;
}
/* take the biggest words, shorts or octets that we can */
while (remaining_bit_length > 7)
{
	switch (remaining_bit_length >> 4)
	{
	case 0:
		/* 8 - 15 bits. (note that 0 - 7 would have dropped out of the while() loop) */
		value <<= 8;
		value += tvb_get_uint8(tvb, octet_offset);
		remaining_bit_length -= 8;
		octet_offset ++;
		break;

	case 1:
		/* 16 - 31 bits */
		value <<= 16;
		value += tvb_get_ntohs(tvb, octet_offset);
		remaining_bit_length -= 16;
		octet_offset += 2;
		break;

	case 2:
	case 3:
		/* 32 - 63 bits */
		value <<= 32;
		value += tvb_get_ntohl(tvb, octet_offset);
		remaining_bit_length -= 32;
		octet_offset += 4;
		break;

	default:
		/* 64 bits (or more???) */
		value = tvb_get_ntoh64(tvb, octet_offset);
		remaining_bit_length -= 64;
		octet_offset += 8;
		break;
	}
}
/* get bits from any partial octet at the tail */
if(remaining_bit_length)
{
	value <<= remaining_bit_length;
	value += (tvb_get_uint8(tvb, octet_offset) >> (8 - remaining_bit_length));
}
}
return value;
2358}

2360/*
* Offset should be given in bits from the start of the tvb.
* Bits within octet are numbered from LSB (0) to MSB (7). Bit at bit_offset is return value least significant bit.
* The function tolerates requests for more than 64 bits, but will only return the least significant 64 bits.
*/
2365static uint64_t
2366_tvb_get_bits64_le(tvbuff_t *tvb, unsigned bit_offset, const int total_no_of_bits)
2367{
uint64_t value = 0;
unsigned octet_offset = bit_offset / 8;
int remaining_bits = total_no_of_bits;
int shift = 0;

if (remaining_bits > 64)
{
remaining_bits = 64;
}

if (bit_offset % 8)
{
/* not aligned, extract bits from first octet */
shift = 8 - (bit_offset % 8);
value = tvb_get_uint8(tvb, octet_offset) >> (bit_offset % 8);
if (shift > remaining_bits)
{
	/* keep only the requested bits */
	value &= (UINT64_C(1)1UL << remaining_bits) - 1;
	remaining_bits = 0;
}
else
{
	remaining_bits -= shift;
}
octet_offset++;
}

while (remaining_bits > 0)
{
/* take the biggest words, shorts or octets that we can */
if (remaining_bits >= 32)
{
	value |= ((uint64_t)tvb_get_letohl(tvb, octet_offset) << shift);
	shift += 32;
	remaining_bits -= 32;
	octet_offset += 4;
}
else if (remaining_bits >= 16)
{
	value |= ((uint64_t)tvb_get_letohs(tvb, octet_offset) << shift);
	shift += 16;
	remaining_bits -= 16;
	octet_offset += 2;
}
else if (remaining_bits >= 8)
{
	value |= ((uint64_t)tvb_get_uint8(tvb, octet_offset) << shift);
	shift += 8;
	remaining_bits -= 8;
	octet_offset += 1;
}
else
{
	unsigned mask = (1 << remaining_bits) - 1;
	value |= (((uint64_t)tvb_get_uint8(tvb, octet_offset) & mask) << shift);
	shift += remaining_bits;
	remaining_bits = 0;
	octet_offset += 1;
}
}
return value;
2430}

2432/* Get 1 - 32 bits (should be deprecated as same as tvb_get_bits32??) */
2433uint32_t
2434tvb_get_bits(tvbuff_t *tvb, const unsigned bit_offset, const int no_of_bits, const unsigned encoding)
2435{
return (uint32_t)tvb_get_bits64(tvb, bit_offset, no_of_bits, encoding);
2437}

2439static int
2440tvb_find_uint8_generic(tvbuff_t *tvb, unsigned abs_offset, unsigned limit, uint8_t needle)
2441{
const uint8_t *ptr;
const uint8_t *result;

ptr = ensure_contiguous(tvb, abs_offset, limit); /* tvb_get_ptr() */
if (!ptr)
return -1;

result = (const uint8_t *) memchr(ptr, needle, limit);
if (!result)
return -1;

return (int) ((result - ptr) + abs_offset);
2454}

2456/* Find first occurrence of needle in tvbuff, starting at offset. Searches
* at most maxlength number of bytes; if maxlength is -1, searches to
* end of tvbuff.
* Returns the offset of the found needle, or -1 if not found.
* Will not throw an exception, even if maxlength exceeds boundary of tvbuff;
* in that case, -1 will be returned if the boundary is reached before
* finding needle. */
2463int
2464tvb_find_uint8(tvbuff_t *tvb, const int offset, const int maxlength, const uint8_t needle)
2465{
const uint8_t *result;
unsigned	      abs_offset = 0;
unsigned	      limit = 0;
int           exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2471, "tvb && tvb->initialized"
))));

exception = compute_offset_and_remaining(tvb, offset, &abs_offset, &limit);
if (exception)
THROW(exception)except_throw(1, (exception), ((void*)0));

/* Only search to end of tvbuff, w/o throwing exception. */
if (maxlength >= 0 && limit > (unsigned) maxlength) {
/* Maximum length doesn't go past end of tvbuff; search
   to that value. */
limit = (unsigned) maxlength;
}

/* If we have real data, perform our search now. */
if (tvb->real_data) {
result = (const uint8_t *)memchr(tvb->real_data + abs_offset, needle, limit);
if (result == NULL((void*)0)) {
	return -1;
}
else {
	return (int) (result - tvb->real_data);
}
}

if (tvb->ops->tvb_find_uint8)
return tvb->ops->tvb_find_uint8(tvb, abs_offset, limit, needle);

return tvb_find_uint8_generic(tvb, offset, limit, needle);
2499}

2501/* Same as tvb_find_uint8() with 16bit needle. */
2502int
2503tvb_find_uint16(tvbuff_t *tvb, const int offset, const int maxlength,
 const uint16_t needle)
2505{
unsigned	      abs_offset = 0;
unsigned	      limit = 0;
int           exception;

exception = compute_offset_and_remaining(tvb, offset, &abs_offset, &limit);
if (exception)
THROW(exception)except_throw(1, (exception), ((void*)0));

/* Only search to end of tvbuff, w/o throwing exception. */
if (maxlength >= 0 && limit > (unsigned) maxlength) {
/* Maximum length doesn't go past end of tvbuff; search
   to that value. */
limit = (unsigned) maxlength;
}

const uint8_t needle1 = ((needle & 0xFF00) >> 8);
const uint8_t needle2 = ((needle & 0x00FF) >> 0);
unsigned searched_bytes = 0;
unsigned pos = abs_offset;

do {
int offset1 =
	tvb_find_uint8(tvb, pos, limit - searched_bytes, needle1);
int offset2 = -1;

if (offset1 == -1) {
	return -1;
}

searched_bytes = (unsigned)offset1 - abs_offset + 1;

if (searched_bytes >= limit) {
	return -1;
}

offset2 = tvb_find_uint8(tvb, offset1 + 1, 1, needle2);

searched_bytes += 1;

if (offset2 != -1) {
	if (searched_bytes > limit) {
		return -1;
	}
	return offset1;
}

pos = offset1 + 1;
} while (searched_bytes < limit);

return -1;
2556}

2558static inline int
2559tvb_ws_mempbrk_uint8_generic(tvbuff_t *tvb, unsigned abs_offset, unsigned limit, const ws_mempbrk_pattern* pattern, unsigned char *found_needle)
2560{
const uint8_t *ptr;
const uint8_t *result;

ptr = ensure_contiguous(tvb, abs_offset, limit); /* tvb_get_ptr */
if (!ptr)
return -1;

result = ws_mempbrk_exec(ptr, limit, pattern, found_needle);
if (!result)
return -1;

return (int) ((result - ptr) + abs_offset);
2573}


2576/* Find first occurrence of any of the pattern chars in tvbuff, starting at offset.
* Searches at most maxlength number of bytes; if maxlength is -1, searches
* to end of tvbuff.
* Returns the offset of the found needle, or -1 if not found.
* Will not throw an exception, even if maxlength exceeds boundary of tvbuff;
* in that case, -1 will be returned if the boundary is reached before
* finding needle. */
2583int
2584tvb_ws_mempbrk_pattern_uint8(tvbuff_t *tvb, const int offset, const int maxlength,
	const ws_mempbrk_pattern* pattern, unsigned char *found_needle)
2586{
const uint8_t *result;
unsigned	      abs_offset = 0;
unsigned	      limit = 0;
int           exception;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2592, "tvb && tvb->initialized"
))));

exception = compute_offset_and_remaining(tvb, offset, &abs_offset, &limit);
if (exception)
THROW(exception)except_throw(1, (exception), ((void*)0));

/* Only search to end of tvbuff, w/o throwing exception. */
if (limit > (unsigned) maxlength) {
/* Maximum length doesn't go past end of tvbuff; search
   to that value. */
limit = maxlength;
}

/* If we have real data, perform our search now. */
if (tvb->real_data) {
result = ws_mempbrk_exec(tvb->real_data + abs_offset, limit, pattern, found_needle);
if (result == NULL((void*)0)) {
	return -1;
}
else {
	return (int) (result - tvb->real_data);
}
}

if (tvb->ops->tvb_ws_mempbrk_pattern_uint8)
return tvb->ops->tvb_ws_mempbrk_pattern_uint8(tvb, abs_offset, limit, pattern, found_needle);

return tvb_ws_mempbrk_uint8_generic(tvb, abs_offset, limit, pattern, found_needle);
2620}

2622/* Find size of stringz (NUL-terminated string) by looking for terminating
* NUL.  The size of the string includes the terminating NUL.
*
* If the NUL isn't found, it throws the appropriate exception.
*/
2627unsigned
2628tvb_strsize(tvbuff_t *tvb, const int offset)
2629{
unsigned abs_offset = 0, junk_length;
int   nul_offset;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2633, "tvb && tvb->initialized"
))));

check_offset_length(tvb, offset, 0, &abs_offset, &junk_length);
nul_offset = tvb_find_uint8(tvb, abs_offset, -1, 0);
if (nul_offset == -1) {
/*
 * OK, we hit the end of the tvbuff, so we should throw
 * an exception.
 */
if (tvb->length < tvb->contained_length) {
	THROW(BoundsError)except_throw(1, (1), ((void*)0));
} else if (tvb->flags & TVBUFF_FRAGMENT0x00000001) {
	THROW(FragmentBoundsError)except_throw(1, (4), ((void*)0));
} else if (tvb->length < tvb->reported_length) {
	THROW(ContainedBoundsError)except_throw(1, (2), ((void*)0));
} else {
	THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}
}
return (nul_offset - abs_offset) + 1;
2653}

2655/* UTF-16/UCS-2 version of tvb_strsize */
2656/* Returns number of bytes including the (two-bytes) null terminator */
2657unsigned
2658tvb_unicode_strsize(tvbuff_t *tvb, const int offset)
2659{
unsigned  i = 0;
gunichar2 uchar;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2663, "tvb && tvb->initialized"
))));

do {
/* Endianness doesn't matter when looking for null */
uchar = tvb_get_ntohs(tvb, offset + i);
i += 2;
} while(uchar != 0);

return i;
2672}

2674/* Find length of string by looking for end of string ('\0'), up to
* 'maxlength' characters'; if 'maxlength' is -1, searches to end
* of tvbuff.
* Returns -1 if 'maxlength' reached before finding EOS. */
2678int
2679tvb_strnlen(tvbuff_t *tvb, const int offset, const unsigned maxlength)
2680{
int   result_offset;
unsigned abs_offset = 0, junk_length;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2684, "tvb && tvb->initialized"
))));

check_offset_length(tvb, offset, 0, &abs_offset, &junk_length);

result_offset = tvb_find_uint8(tvb, abs_offset, maxlength, 0);

if (result_offset == -1) {
return -1;
}
else {
return result_offset - abs_offset;
}
2696}

2698/*
* Implement strneql etc
*/

2702/*
* Call strncmp after checking if enough chars left, returning 0 if
* it returns 0 (meaning "equal") and -1 otherwise, otherwise return -1.
*/
2706int
2707tvb_strneql(tvbuff_t *tvb, const int offset, const char *str, const size_t size)
2708{
const uint8_t *ptr;

ptr = ensure_contiguous_no_exception(tvb, offset, (int)size, NULL((void*)0));

if (ptr) {
int cmp = strncmp((const char *)ptr, str, size);

/*
 * Return 0 if equal, -1 otherwise.
 */
return (cmp == 0 ? 0 : -1);
} else {
/*
 * Not enough characters in the tvbuff to match the
 * string.
 */
return -1;
}
2727}

2729/*
* Call g_ascii_strncasecmp after checking if enough chars left, returning
* 0 if it returns 0 (meaning "equal") and -1 otherwise, otherwise return -1.
*/
2733int
2734tvb_strncaseeql(tvbuff_t *tvb, const int offset, const char *str, const size_t size)
2735{
const uint8_t *ptr;

ptr = ensure_contiguous_no_exception(tvb, offset, (int)size, NULL((void*)0));

if (ptr) {
int cmp = g_ascii_strncasecmp((const char *)ptr, str, size);

/*
 * Return 0 if equal, -1 otherwise.
 */
return (cmp == 0 ? 0 : -1);
} else {
/*
 * Not enough characters in the tvbuff to match the
 * string.
 */
return -1;
}
2754}

2756/*
* Check that the tvbuff contains at least size bytes, starting at
* offset, and that those bytes are equal to str. Return 0 for success
* and -1 for error. This function does not throw an exception.
*/
2761int
2762tvb_memeql(tvbuff_t *tvb, const int offset, const uint8_t *str, size_t size)
2763{
const uint8_t *ptr;

ptr = ensure_contiguous_no_exception(tvb, offset, (int) size, NULL((void*)0));

if (ptr) {
int cmp = memcmp(ptr, str, size);

/*
 * Return 0 if equal, -1 otherwise.
 */
return (cmp == 0 ? 0 : -1);
} else {
/*
 * Not enough characters in the tvbuff to match the
 * string.
 */
return -1;
}
2782}

2784/**
* Format the data in the tvb from offset for size.
*/
2787char *
2788tvb_format_text(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int size)
2789{
const uint8_t *ptr;
int           len;

len = (size > 0) ? size : 0;

ptr = ensure_contiguous(tvb, offset, size);
return format_text(scope, ptr, len);
2797}

2799/*
* Format the data in the tvb from offset for length ...
*/
2802char *
2803tvb_format_text_wsp(wmem_allocator_t* allocator, tvbuff_t *tvb, const int offset, const int size)
2804{
const uint8_t *ptr;
int           len;

len = (size > 0) ? size : 0;

ptr = ensure_contiguous(tvb, offset, size);
return format_text_wsp(allocator, ptr, len);
2812}

2814/**
* Like "tvb_format_text()", but for null-padded strings; don't show
* the null padding characters as "\000".
*/
2818char *
2819tvb_format_stringzpad(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int size)
2820{
const uint8_t *ptr, *p;
int           len;
int           stringlen;

len = (size > 0) ? size : 0;

ptr = ensure_contiguous(tvb, offset, size);
for (p = ptr, stringlen = 0; stringlen < len && *p != '\0'; p++, stringlen++)
;
return format_text(scope, ptr, stringlen);
2831}

2833/*
* Like "tvb_format_text_wsp()", but for null-padded strings; don't show
* the null padding characters as "\000".
*/
2837char *
2838tvb_format_stringzpad_wsp(wmem_allocator_t* allocator, tvbuff_t *tvb, const int offset, const int size)
2839{
const uint8_t *ptr, *p;
int           len;
int           stringlen;

len = (size > 0) ? size : 0;

ptr = ensure_contiguous(tvb, offset, size);
for (p = ptr, stringlen = 0; stringlen < len && *p != '\0'; p++, stringlen++)
;
return format_text_wsp(allocator, ptr, stringlen);
2850}

2852/*
* All string functions below take a scope as an argument.
*
*
* If scope is NULL, memory is allocated with g_malloc() and user must
* explicitly free it with g_free().
* If scope is not NULL, memory is allocated with the corresponding pool
* lifetime.
*
* All functions throw an exception if the tvbuff ends before the string
* does.
*/

2865/*
* Given a wmem scope, a tvbuff, an offset, and a length, treat the string
* of bytes referred to by the tvbuff, offset, and length as an ASCII string,
* with all bytes with the high-order bit set being invalid, and return a
* pointer to a UTF-8 string, allocated using the wmem scope.
*
* Octets with the highest bit set will be converted to the Unicode
* REPLACEMENT CHARACTER.
*/
2874static uint8_t *
2875tvb_get_ascii_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length)
2876{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_ascii_string(scope, ptr, length);
2881}

2883/*
* Given a wmem scope, a tvbuff, an offset, a length, and a translation table,
* treat the string of bytes referred to by the tvbuff, offset, and length
* as a string encoded using one octet per character, with octets with the
* high-order bit clear being mapped by the translation table to 2-byte
* Unicode Basic Multilingual Plane characters (including REPLACEMENT
* CHARACTER) and octets with the high-order bit set being mapped to
* REPLACEMENT CHARACTER, and return a pointer to a UTF-8 string,
* allocated using the wmem scope.
*
* Octets with the highest bit set will be converted to the Unicode
* REPLACEMENT CHARACTER.
*/
2896static uint8_t *
2897tvb_get_iso_646_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length, const gunichar2 table[0x80])
2898{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_iso_646_string(scope, ptr, length, table);
2903}

2905/*
* Given a wmem scope, a tvbuff, an offset, and a length, treat the string
* of bytes referred to by the tvbuff, the offset. and the length as a UTF-8
* string, and return a pointer to a UTF-8 string, allocated using the wmem
* scope, with all ill-formed sequences replaced with the Unicode REPLACEMENT
* CHARACTER according to the recommended "best practices" given in the Unicode
* Standard and specified by W3C/WHATWG.
*
* Note that in conformance with the Unicode Standard, this treats three
* byte sequences corresponding to UTF-16 surrogate halves (paired or unpaired)
* and two byte overlong encodings of 7-bit ASCII characters as invalid and
* substitutes REPLACEMENT CHARACTER for them. Explicit support for nonstandard
* derivative encoding formats (e.g. CESU-8, Java Modified UTF-8, WTF-8) could
* be added later.
*/
2920static uint8_t *
2921tvb_get_utf_8_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int length)
2922{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_utf_8_string(scope, ptr, length);
2927}

2929/*
* Given a wmem scope, a tvbuff, an offset, and a length, treat the string
* of bytes referred to by the tvbuff, the offset, and the length as a
* raw string, and return a pointer to that string, allocated using the
* wmem scope. This means a null is appended at the end, but no replacement
* checking is done otherwise, unlike tvb_get_utf_8_string().
*
* Also, this one allows a length of -1 to mean get all, but does not
* allow a negative offset.
*/
2939static inline uint8_t *
2940tvb_get_raw_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int length)
2941{
uint8_t *strbuf;
int     abs_length = length;

DISSECTOR_ASSERT(offset     >=  0)((void) ((offset >= 0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2945, "offset >= 0"
))));
DISSECTOR_ASSERT(abs_length >= -1)((void) ((abs_length >= -1) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 2946, "abs_length >= -1"
))));

if (abs_length < 0)
abs_length = tvb->length - offset;

tvb_ensure_bytes_exist(tvb, offset, abs_length);
strbuf = (uint8_t *)wmem_alloc(scope, abs_length + 1);
tvb_memcpy(tvb, strbuf, offset, abs_length);
strbuf[abs_length] = '\0';
return strbuf;
2956}

2958/*
* Given a wmem scope, a tvbuff, an offset, and a length, treat the string
* of bytes referred to by the tvbuff, the offset, and the length as an
* ISO 8859/1 string, and return a pointer to a UTF-8 string, allocated
* using the wmem scope.
*/
2964static uint8_t *
2965tvb_get_string_8859_1(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length)
2966{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_8859_1_string(scope, ptr, length);
2971}

2973/*
* Given a wmem scope, a tvbuff, an offset, a length, and a translation
* table, treat the string of bytes referred to by the tvbuff, the offset,
* and the length as a string encoded using one octet per character, with
* octets with the high-order bit clear being ASCII and octets with the
* high-order bit set being mapped by the translation table to 2-byte
* Unicode Basic Multilingual Plane characters (including REPLACEMENT
* CHARACTER), and return a pointer to a UTF-8 string, allocated with the
* wmem scope.
*/
2983static uint8_t *
2984tvb_get_string_unichar2(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length, const gunichar2 table[0x80])
2985{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_unichar2_string(scope, ptr, length, table);
2990}

2992/*
* Given a wmem scope, a tvbuff, an offset, a length, and an encoding
* giving the byte order, treat the string of bytes referred to by the
* tvbuff, the offset, and the length as a UCS-2 encoded string in
* the byte order in question, containing characters from the Basic
* Multilingual Plane (plane 0) of Unicode, and return a pointer to a
* UTF-8 string, allocated with the wmem scope.
*
* Encoding parameter should be ENC_BIG_ENDIAN or ENC_LITTLE_ENDIAN.
*
* Specify length in bytes.
*
* XXX - should map lead and trail surrogate values to REPLACEMENT
* CHARACTERs (0xFFFD)?
* XXX - if there are an odd number of bytes, should put a
* REPLACEMENT CHARACTER at the end.
*/
3009static uint8_t *
3010tvb_get_ucs_2_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int length, const unsigned encoding)
3011{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_ucs_2_string(scope, ptr, length, encoding);
3016}

3018/*
* Given a wmem scope, a tvbuff, an offset, a length, and an encoding
* giving the byte order, treat the string of bytes referred to by the
* tvbuff, the offset, and the length as a UTF-16 encoded string in
* the byte order in question, and return a pointer to a UTF-8 string,
* allocated with the wmem scope.
*
* Encoding parameter should be ENC_BIG_ENDIAN or ENC_LITTLE_ENDIAN.
*
* Specify length in bytes.
*
* XXX - should map surrogate errors to REPLACEMENT CHARACTERs (0xFFFD).
* XXX - should map code points > 10FFFF to REPLACEMENT CHARACTERs.
* XXX - if there are an odd number of bytes, should put a
* REPLACEMENT CHARACTER at the end.
*/
3034static uint8_t *
3035tvb_get_utf_16_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int length, const unsigned encoding)
3036{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_utf_16_string(scope, ptr, length, encoding);
3041}

3043/*
* Given a wmem scope, a tvbuff, an offset, a length, and an encoding
* giving the byte order, treat the string of bytes referred to by the
* tvbuff, the offset, and the length as a UCS-4 encoded string in
* the byte order in question, and return a pointer to a UTF-8 string,
* allocated with the wmem scope.
*
* Encoding parameter should be ENC_BIG_ENDIAN or ENC_LITTLE_ENDIAN
*
* Specify length in bytes
*
* XXX - should map lead and trail surrogate values to a "substitute"
* UTF-8 character?
* XXX - should map code points > 10FFFF to REPLACEMENT CHARACTERs.
* XXX - if the number of bytes isn't a multiple of 4, should put a
* REPLACEMENT CHARACTER at the end.
*/
3060static char *
3061tvb_get_ucs_4_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int length, const unsigned encoding)
3062{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_ucs_4_string(scope, ptr, length, encoding);
3067}

3069char *
3070tvb_get_ts_23_038_7bits_string_packed(wmem_allocator_t *scope, tvbuff_t *tvb,
const int bit_offset, int no_of_chars)
3072{
int            in_offset = bit_offset >> 3; /* Current pointer to the input buffer */
int            length = ((no_of_chars + 1) * 7 + (bit_offset & 0x07)) >> 3;
const uint8_t *ptr;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 3077, "tvb && tvb->initialized"
))));

ptr = ensure_contiguous(tvb, in_offset, length);
return get_ts_23_038_7bits_string_packed(scope, ptr, bit_offset, no_of_chars);
3081}

3083char *
3084tvb_get_ts_23_038_7bits_string_unpacked(wmem_allocator_t *scope, tvbuff_t *tvb,
const int offset, int length)
3086{
const uint8_t *ptr;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 3089, "tvb && tvb->initialized"
))));

ptr = ensure_contiguous(tvb, offset, length);
return get_ts_23_038_7bits_string_unpacked(scope, ptr, length);
3093}

3095char *
3096tvb_get_etsi_ts_102_221_annex_a_string(wmem_allocator_t *scope, tvbuff_t *tvb,
const int offset, int length)
3098{
const uint8_t *ptr;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 3101, "tvb && tvb->initialized"
))));

ptr = ensure_contiguous(tvb, offset, length);
return get_etsi_ts_102_221_annex_a_string(scope, ptr, length);
3105}

3107char *
3108tvb_get_ascii_7bits_string(wmem_allocator_t *scope, tvbuff_t *tvb,
const int bit_offset, int no_of_chars)
3110{
int            in_offset = bit_offset >> 3; /* Current pointer to the input buffer */
int            length = ((no_of_chars + 1) * 7 + (bit_offset & 0x07)) >> 3;
const uint8_t *ptr;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 3115, "tvb && tvb->initialized"
))));

ptr = ensure_contiguous(tvb, in_offset, length);
return get_ascii_7bits_string(scope, ptr, bit_offset, no_of_chars);
3119}

3121/*
* Given a wmem scope, a tvbuff, an offset, a length, and a translation
* table, treat the string of bytes referred to by the tvbuff, the offset,
* and the length as a string encoded using one octet per character, with
* octets being mapped by the translation table to 2-byte Unicode Basic
* Multilingual Plane characters (including REPLACEMENT CHARACTER), and
* return a pointer to a UTF-8 string, allocated with the wmem scope.
*/
3129static uint8_t *
3130tvb_get_nonascii_unichar2_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length, const gunichar2 table[256])
3131{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_nonascii_unichar2_string(scope, ptr, length, table);
3136}

3138/*
* Given a wmem scope, a tvbuff, an offset, and a length, treat the bytes
* referred to by the tvbuff, offset, and length as a GB18030 encoded string,
* and return a pointer to a UTF-8 string, allocated with the wmem scope,
* converted having substituted REPLACEMENT CHARACTER according to the
* Unicode Standard 5.22 U+FFFD Substitution for Conversion.
* ( https://www.unicode.org/versions/Unicode13.0.0/ch05.pdf )
*
* As expected, this will also decode GBK and GB2312 strings.
*/
3148static uint8_t *
3149tvb_get_gb18030_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length)
3150{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_gb18030_string(scope, ptr, length);
3155}

3157/*
* Given a wmem scope, a tvbuff, an offset, and a length, treat the bytes
* referred to by the tvbuff, offset, and length as a EUC-KR encoded string,
* and return a pointer to a UTF-8 string, allocated with the wmem scope,
* converted having substituted REPLACEMENT CHARACTER according to the
* Unicode Standard 5.22 U+FFFD Substitution for Conversion.
* ( https://www.unicode.org/versions/Unicode13.0.0/ch05.pdf )
*/
3165static uint8_t *
3166tvb_get_euc_kr_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length)
3167{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_euc_kr_string(scope, ptr, length);
3172}

3174static uint8_t *
3175tvb_get_t61_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length)
3176{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_t61_string(scope, ptr, length);
3181}

3183/*
* Encoding tables for BCD strings.
*/
3186static const dgt_set_t Dgt0_9_bcd = {
{
/*  0   1   2   3   4   5   6   7   8   9   a   b   c   d   e  f */
   '0','1','2','3','4','5','6','7','8','9','?','?','?','?','?','?'
}
3191};

3193static const dgt_set_t Dgt_keypad_abc_tbcd = {
{
/*  0   1   2   3   4   5   6   7   8   9   a   b   c   d   e  f */
   '0','1','2','3','4','5','6','7','8','9','*','#','a','b','c','?'
}
3198};

3200static const dgt_set_t Dgt_ansi_tbcd = {
{
/*  0   1   2   3   4   5   6   7   8   9   a   b   c   d   e  f */
   '0','1','2','3','4','5','6','7','8','9','?','B','C','*','#','?'
}
3205};

3207static const dgt_set_t Dgt_dect_standard_4bits_tbcd = {
{
/*  0   1   2   3   4   5   6   7   8   9   a   b   c   d   e  f */
   '0','1','2','3','4','5','6','7','8','9','?',' ','?','?','?','?'
}
3212};

3214static uint8_t *
3215tvb_get_apn_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset,
	     int length)
3217{
wmem_strbuf_t *str;

/*
* This is a domain name.
*
* 3GPP TS 23.003, section 19.4.2 "Fully Qualified Domain Names
* (FQDNs)", subsection 19.4.2.1 "General", says:
*
*    The encoding of any identifier used as part of a Fully
*    Qualifed Domain Name (FQDN) shall follow the Name Syntax
*    defined in IETF RFC 2181 [18], IETF RFC 1035 [19] and
*    IETF RFC 1123 [20].  An FQDN consists of one or more
*    labels. Each label is coded as a one octet length field
*    followed by that number of octets coded as 8 bit ASCII
*    characters.
*
* so this does not appear to use full-blown DNS compression -
* the upper 2 bits of the length don't indicate that it's a
* pointer or an extended label (RFC 2673).
*/
str = wmem_strbuf_new_sized(scope, length + 1);
if (length > 0) {
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);

for (;;) {
	unsigned label_len;

	/*
	 * Process this label.
	 */
	label_len = *ptr;
	ptr++;
	length--;

	while (label_len != 0) {
		uint8_t ch;

		if (length == 0)
			goto end;

		ch = *ptr;
		if (ch < 0x80)
			wmem_strbuf_append_c(str, ch);
		else
			wmem_strbuf_append_unichar_repl(str)wmem_strbuf_append_unichar(str, 0x00FFFD);
		ptr++;
		label_len--;
		length--;
	}

	if (length == 0)
		goto end;

	wmem_strbuf_append_c(str, '.');
}
}

3277end:
return (uint8_t *) wmem_strbuf_finalize(str);
3279}

3281static uint8_t *
3282tvb_get_dect_standard_8bits_string(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int length)
3283{
const uint8_t *ptr;

ptr = ensure_contiguous(tvb, offset, length);
return get_dect_standard_8bits_string(scope, ptr, length);
3288}

3290/*
* Given a tvbuff, an offset, a length, and an encoding, allocate a
* buffer big enough to hold a non-null-terminated string of that length
* at that offset, plus a trailing '\0', copy into the buffer the
* string as converted from the appropriate encoding to UTF-8, and
* return a pointer to the string.
*/
3297uint8_t *
3298tvb_get_string_enc(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset,
	     const int length, const unsigned encoding)
3300{
uint8_t *strptr;
bool_Bool odd, skip_first;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 3304, "tvb && tvb->initialized"
))));

/* make sure length = -1 fails */
if (length < 0) {
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}

switch (encoding & ENC_CHARENCODING_MASK0x0000FFFE) {

case ENC_ASCII0x00000000:
default:
/*
 * For now, we treat bogus values as meaning
 * "ASCII" rather than reporting an error,
 * for the benefit of old dissectors written
 * when the last argument to proto_tree_add_item()
 * was a bool for the byte order, not an
 * encoding value, and passed non-zero values
 * other than true to mean "little-endian".
 */
strptr = tvb_get_ascii_string(scope, tvb, offset, length);
break;

case ENC_UTF_80x00000002:
strptr = tvb_get_utf_8_string(scope, tvb, offset, length);
break;

case ENC_UTF_160x00000004:
strptr = tvb_get_utf_16_string(scope, tvb, offset, length,
    encoding & (ENC_LITTLE_ENDIAN0x80000000|ENC_BOM0x20000000));
break;

case ENC_UCS_20x00000006:
strptr = tvb_get_ucs_2_string(scope, tvb, offset, length,
    encoding & (ENC_LITTLE_ENDIAN0x80000000|ENC_BOM0x20000000));
break;

case ENC_UCS_40x00000008:
strptr = tvb_get_ucs_4_string(scope, tvb, offset, length,
    encoding & (ENC_LITTLE_ENDIAN0x80000000|ENC_BOM0x20000000));
break;

case ENC_ISO_8859_10x0000000A:
/*
 * ISO 8859-1 printable code point values are equal
 * to the equivalent Unicode code point value, so
 * no translation table is needed.
 */
strptr = tvb_get_string_8859_1(scope, tvb, offset, length);
break;

case ENC_ISO_8859_20x0000000C:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_2);
break;

case ENC_ISO_8859_30x0000000E:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_3);
break;

case ENC_ISO_8859_40x00000010:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_4);
break;

case ENC_ISO_8859_50x00000012:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_5);
break;

case ENC_ISO_8859_60x00000014:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_6);
break;

case ENC_ISO_8859_70x00000016:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_7);
break;

case ENC_ISO_8859_80x00000018:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_8);
break;

case ENC_ISO_8859_90x0000001A:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_9);
break;

case ENC_ISO_8859_100x0000001C:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_10);
break;

case ENC_ISO_8859_110x0000001E:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_11);
break;

case ENC_ISO_8859_130x00000022:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_13);
break;

case ENC_ISO_8859_140x00000024:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_14);
break;

case ENC_ISO_8859_150x00000026:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_15);
break;

case ENC_ISO_8859_160x00000028:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_iso_8859_16);
break;

case ENC_WINDOWS_12500x0000002A:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_cp1250);
break;

case ENC_WINDOWS_12510x0000003C:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_cp1251);
break;

case ENC_WINDOWS_12520x0000003A:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_cp1252);
break;

case ENC_MAC_ROMAN0x00000030:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_mac_roman);
break;

case ENC_CP4370x00000032:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_cp437);
break;

case ENC_CP8550x0000003E:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_cp855);
break;

case ENC_CP8660x00000040:
strptr = tvb_get_string_unichar2(scope, tvb, offset, length, charset_table_cp866);
break;

case ENC_ISO_646_BASIC0x00000042:
strptr = tvb_get_iso_646_string(scope, tvb, offset, length, charset_table_iso_646_basic);
break;

case ENC_3GPP_TS_23_038_7BITS_PACKED0x0000002C:
{
	int bit_offset  = offset << 3;
	int no_of_chars = (length << 3) / 7;
	strptr = tvb_get_ts_23_038_7bits_string_packed(scope, tvb, bit_offset, no_of_chars);
}
break;

case ENC_ASCII_7BITS0x00000034:
{
	int bit_offset  = offset << 3;
	int no_of_chars = (length << 3) / 7;
	strptr = tvb_get_ascii_7bits_string(scope, tvb, bit_offset, no_of_chars);
}
break;

case ENC_EBCDIC0x0000002E:
/*
 * "Common" EBCDIC, covering all characters with the
 * same code point in all Roman-alphabet EBCDIC code
 * pages.
 */
strptr = tvb_get_nonascii_unichar2_string(scope, tvb, offset, length, charset_table_ebcdic);
break;

case ENC_EBCDIC_CP0370x00000038:
/*
 * EBCDIC code page 037.
 */
strptr = tvb_get_nonascii_unichar2_string(scope, tvb, offset, length, charset_table_ebcdic_cp037);
break;

case ENC_EBCDIC_CP5000x00000060:
/*
 * EBCDIC code page 500.
 */
strptr = tvb_get_nonascii_unichar2_string(scope, tvb, offset, length, charset_table_ebcdic_cp500);
break;

case ENC_T610x00000036:
strptr = tvb_get_t61_string(scope, tvb, offset, length);
break;

case ENC_BCD_DIGITS_0_90x00000044:
/*
 * Packed BCD, with digits 0-9.
 */
odd = (encoding & ENC_BCD_ODD_NUM_DIG0x00010000) >> 16;
skip_first = (encoding & ENC_BCD_SKIP_FIRST0x00020000) >> 17;
strptr = tvb_get_bcd_string(scope, tvb, offset, length, &Dgt0_9_bcd, skip_first, odd, !(encoding & ENC_LITTLE_ENDIAN0x80000000));
break;

case ENC_KEYPAD_ABC_TBCD0x00000046:
/*
 * Keypad-with-a/b/c "telephony BCD" - packed BCD, with
 * digits 0-9 and symbols *, #, a, b, and c.
 */
odd = (encoding & ENC_BCD_ODD_NUM_DIG0x00010000) >> 16;
skip_first = (encoding & ENC_BCD_SKIP_FIRST0x00020000) >> 17;
strptr = tvb_get_bcd_string(scope, tvb, offset, length, &Dgt_keypad_abc_tbcd, skip_first, odd, !(encoding & ENC_LITTLE_ENDIAN0x80000000));
break;

case ENC_KEYPAD_BC_TBCD0x00000048:
/*
 * Keypad-with-B/C "telephony BCD" - packed BCD, with
 * digits 0-9 and symbols B, C, *, and #.
 */
odd = (encoding & ENC_BCD_ODD_NUM_DIG0x00010000) >> 16;
skip_first = (encoding & ENC_BCD_SKIP_FIRST0x00020000) >> 17;
strptr = tvb_get_bcd_string(scope, tvb, offset, length, &Dgt_ansi_tbcd, skip_first, odd, !(encoding & ENC_LITTLE_ENDIAN0x80000000));
break;

case ENC_3GPP_TS_23_038_7BITS_UNPACKED0x0000004C:
strptr = tvb_get_ts_23_038_7bits_string_unpacked(scope, tvb, offset, length);
break;

case ENC_ETSI_TS_102_221_ANNEX_A0x0000004E:
strptr = tvb_get_etsi_ts_102_221_annex_a_string(scope, tvb, offset, length);
break;

case ENC_GB180300x00000050:
strptr = tvb_get_gb18030_string(scope, tvb, offset, length);
break;

case ENC_EUC_KR0x00000052:
strptr = tvb_get_euc_kr_string(scope, tvb, offset, length);
break;

case ENC_APN_STR0x00000054:
strptr = tvb_get_apn_string(scope, tvb, offset, length);
break;

case ENC_DECT_STANDARD_8BITS0x00000056:
strptr = tvb_get_dect_standard_8bits_string(scope, tvb, offset, length);
break;

case ENC_DECT_STANDARD_4BITS_TBCD0x00000058:
/*
 * DECT standard 4bits "telephony BCD" - packed BCD, with
 * digits 0-9 and symbol SPACE for 0xb.
 */
odd = (encoding & ENC_BCD_ODD_NUM_DIG0x00010000) >> 16;
skip_first = (encoding & ENC_BCD_SKIP_FIRST0x00020000) >> 17;
strptr = tvb_get_bcd_string(scope, tvb, offset, length, &Dgt_dect_standard_4bits_tbcd, skip_first, odd, false0);
break;
}
return strptr;
3550}

3552/*
* This is like tvb_get_string_enc(), except that it handles null-padded
* strings.
*
* Currently, string values are stored as UTF-8 null-terminated strings,
* so nothing needs to be done differently for null-padded strings; we
* could save a little memory by not storing the null padding.
*
* If we ever store string values differently, in a fashion that doesn't
* involve null termination, that might change.
*/
3563uint8_t *
3564tvb_get_stringzpad(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset,
   const int length, const unsigned encoding)
3566{
return tvb_get_string_enc(scope, tvb, offset, length, encoding);
3568}

3570/*
* These routines are like the above routines, except that they handle
* null-terminated strings.  They find the length of that string (and
* throw an exception if the tvbuff ends before we find the null), and
* also return through a pointer the length of the string, in bytes,
* including the terminating null (the terminating null being 2 bytes
* for UCS-2 and UTF-16, 4 bytes for UCS-4, and 1 byte for other
* encodings).
*/
3579static uint8_t *
3580tvb_get_ascii_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp)
3581{
unsigned	       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_ascii_string(scope, ptr, size);
3591}

3593static uint8_t *
3594tvb_get_iso_646_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp, const gunichar2 table[0x80])
3595{
unsigned	       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_iso_646_string(scope, ptr, size, table);
3605}

3607static uint8_t *
3608tvb_get_utf_8_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int *lengthp)
3609{
unsigned   size;
const uint8_t *ptr;

size   = tvb_strsize(tvb, offset);
ptr = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_utf_8_string(scope, ptr, size);
3619}

3621static uint8_t *
3622tvb_get_stringz_8859_1(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp)
3623{
unsigned size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_8859_1_string(scope, ptr, size);
3633}

3635static uint8_t *
3636tvb_get_stringz_unichar2(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp, const gunichar2 table[0x80])
3637{
unsigned size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_unichar2_string(scope, ptr, size, table);
3647}

3649/*
* Given a tvbuff and an offset, with the offset assumed to refer to
* a null-terminated string, find the length of that string (and throw
* an exception if the tvbuff ends before we find the null), ensure that
* the TVB is flat, and return a pointer to the string (in the TVB).
* Also return the length of the string (including the terminating null)
* through a pointer.
*
* As long as we aren't using composite TVBs, this saves the cycles used
* (often unnecessariliy) in allocating a buffer and copying the string into
* it.  (If we do start using composite TVBs, we may want to replace this
* function with the _ephemeral version.)
*/
3662const uint8_t *
3663tvb_get_const_stringz(tvbuff_t *tvb, const int offset, int *lengthp)
3664{
unsigned      size;
const uint8_t *strptr;

size   = tvb_strsize(tvb, offset);
strptr = ensure_contiguous(tvb, offset, size);
if (lengthp)
*lengthp = size;
return strptr;
3673}

3675static char *
3676tvb_get_ucs_2_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int *lengthp, const unsigned encoding)
3677{
int            size;    /* Number of bytes in string */
const uint8_t *ptr;

size = tvb_unicode_strsize(tvb, offset);
ptr = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_ucs_2_string(scope, ptr, size, encoding);
3687}

3689static char *
3690tvb_get_utf_16_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int *lengthp, const unsigned encoding)
3691{
int            size;
const uint8_t *ptr;

size = tvb_unicode_strsize(tvb, offset);
ptr = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_utf_16_string(scope, ptr, size, encoding);
3701}

3703static char *
3704tvb_get_ucs_4_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int *lengthp, const unsigned encoding)
3705{
int            size;
gunichar       uchar;
const uint8_t *ptr;

size = 0;
do {
/* Endianness doesn't matter when looking for null */
uchar = tvb_get_ntohl(tvb, offset + size);
size += 4;
} while(uchar != 0);

ptr = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_ucs_4_string(scope, ptr, size, encoding);
3722}

3724static uint8_t *
3725tvb_get_nonascii_unichar2_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp, const gunichar2 table[256])
3726{
unsigned	       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_nonascii_unichar2_string(scope, ptr, size, table);
3736}

3738static uint8_t *
3739tvb_get_t61_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp)
3740{
unsigned	       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_t61_string(scope, ptr, size);
3750}

3752static uint8_t *
3753tvb_get_gb18030_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp)
3754{
unsigned       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_gb18030_string(scope, ptr, size);
3764}

3766static uint8_t *
3767tvb_get_euc_kr_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int   *lengthp)
3768{
unsigned       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_euc_kr_string(scope, ptr, size);
3778}

3780static uint8_t *
3781tvb_get_dect_standard_8bits_stringz(wmem_allocator_t *scope, tvbuff_t *tvb, int offset, int *lengthp)
3782{
unsigned	       size;
const uint8_t *ptr;

size = tvb_strsize(tvb, offset);
ptr  = ensure_contiguous(tvb, offset, size);
/* XXX, conversion between signed/unsigned integer */
if (lengthp)
*lengthp = size;
return get_dect_standard_8bits_string(scope, ptr, size);
3792}

3794uint8_t *
3795tvb_get_stringz_enc(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int *lengthp, const unsigned encoding)
3796{
uint8_t *strptr;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 3799, "tvb && tvb->initialized"
))));

switch (encoding & ENC_CHARENCODING_MASK0x0000FFFE) {

case ENC_ASCII0x00000000:
default:
/*
 * For now, we treat bogus values as meaning
 * "ASCII" rather than reporting an error,
 * for the benefit of old dissectors written
 * when the last argument to proto_tree_add_item()
 * was a bool for the byte order, not an
 * encoding value, and passed non-zero values
 * other than true to mean "little-endian".
 */
strptr = tvb_get_ascii_stringz(scope, tvb, offset, lengthp);
break;

case ENC_UTF_80x00000002:
/*
 * XXX - should map all invalid UTF-8 sequences
 * to a "substitute" UTF-8 character.
 * XXX - should map code points > 10FFFF to REPLACEMENT
 * CHARACTERs.
 */
strptr = tvb_get_utf_8_stringz(scope, tvb, offset, lengthp);
break;

case ENC_UTF_160x00000004:
strptr = tvb_get_utf_16_stringz(scope, tvb, offset, lengthp,
    encoding & (ENC_LITTLE_ENDIAN0x80000000|ENC_BOM0x20000000));
break;

case ENC_UCS_20x00000006:
strptr = tvb_get_ucs_2_stringz(scope, tvb, offset, lengthp,
    encoding & (ENC_LITTLE_ENDIAN0x80000000|ENC_BOM0x20000000));
break;

case ENC_UCS_40x00000008:
strptr = tvb_get_ucs_4_stringz(scope, tvb, offset, lengthp,
    encoding & (ENC_LITTLE_ENDIAN0x80000000|ENC_BOM0x20000000));
break;

case ENC_ISO_8859_10x0000000A:
/*
 * ISO 8859-1 printable code point values are equal
 * to the equivalent Unicode code point value, so
 * no translation table is needed.
 */
strptr = tvb_get_stringz_8859_1(scope, tvb, offset, lengthp);
break;

case ENC_ISO_8859_20x0000000C:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_2);
break;

case ENC_ISO_8859_30x0000000E:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_3);
break;

case ENC_ISO_8859_40x00000010:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_4);
break;

case ENC_ISO_8859_50x00000012:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_5);
break;

case ENC_ISO_8859_60x00000014:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_6);
break;

case ENC_ISO_8859_70x00000016:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_7);
break;

case ENC_ISO_8859_80x00000018:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_8);
break;

case ENC_ISO_8859_90x0000001A:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_9);
break;

case ENC_ISO_8859_100x0000001C:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_10);
break;

case ENC_ISO_8859_110x0000001E:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_11);
break;

case ENC_ISO_8859_130x00000022:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_13);
break;

case ENC_ISO_8859_140x00000024:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_14);
break;

case ENC_ISO_8859_150x00000026:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_15);
break;

case ENC_ISO_8859_160x00000028:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_iso_8859_16);
break;

case ENC_WINDOWS_12500x0000002A:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_cp1250);
break;

case ENC_WINDOWS_12510x0000003C:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_cp1251);
break;

case ENC_WINDOWS_12520x0000003A:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_cp1252);
break;

case ENC_MAC_ROMAN0x00000030:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_mac_roman);
break;

case ENC_CP4370x00000032:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_cp437);
break;

case ENC_CP8550x0000003E:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_cp855);
break;

case ENC_CP8660x00000040:
strptr = tvb_get_stringz_unichar2(scope, tvb, offset, lengthp, charset_table_cp866);
break;

case ENC_ISO_646_BASIC0x00000042:
strptr = tvb_get_iso_646_stringz(scope, tvb, offset, lengthp, charset_table_iso_646_basic);
break;

case ENC_3GPP_TS_23_038_7BITS_PACKED0x0000002C:
case ENC_3GPP_TS_23_038_7BITS_UNPACKED0x0000004C:
case ENC_ETSI_TS_102_221_ANNEX_A0x0000004E:
REPORT_DISSECTOR_BUG("TS 23.038 7bits has no null character and doesn't support null-terminated strings")proto_report_dissector_bug("TS 23.038 7bits has no null character and doesn't support null-terminated strings"
);
break;

case ENC_ASCII_7BITS0x00000034:
REPORT_DISSECTOR_BUG("tvb_get_stringz_enc function with ENC_ASCII_7BITS not implemented yet")proto_report_dissector_bug("tvb_get_stringz_enc function with ENC_ASCII_7BITS not implemented yet"
);
break;

case ENC_EBCDIC0x0000002E:
/*
 * "Common" EBCDIC, covering all characters with the
 * same code point in all Roman-alphabet EBCDIC code
 * pages.
 */
strptr = tvb_get_nonascii_unichar2_stringz(scope, tvb, offset, lengthp, charset_table_ebcdic);
break;

case ENC_EBCDIC_CP0370x00000038:
/*
 * EBCDIC code page 037.
 */
strptr = tvb_get_nonascii_unichar2_stringz(scope, tvb, offset, lengthp, charset_table_ebcdic_cp037);
break;

case ENC_EBCDIC_CP5000x00000060:
/*
 * EBCDIC code page 500.
 */
strptr = tvb_get_nonascii_unichar2_stringz(scope, tvb, offset, lengthp, charset_table_ebcdic_cp500);
break;

case ENC_T610x00000036:
strptr = tvb_get_t61_stringz(scope, tvb, offset, lengthp);
break;

case ENC_GB180300x00000050:
strptr = tvb_get_gb18030_stringz(scope, tvb, offset, lengthp);
break;

case ENC_EUC_KR0x00000052:
strptr = tvb_get_euc_kr_stringz(scope, tvb, offset, lengthp);
break;

case ENC_DECT_STANDARD_8BITS0x00000056:
strptr = tvb_get_dect_standard_8bits_stringz(scope, tvb, offset, lengthp);
break;
}

return strptr;
3990}

3992/* Looks for a stringz (NUL-terminated string) in tvbuff and copies
* no more than bufsize number of bytes, including terminating NUL, to buffer.
* Returns length of string (not including terminating NUL), or -1 if the string was
* truncated in the buffer due to not having reached the terminating NUL.
* In this way, it acts like snprintf().
*
* bufsize MUST be greater than 0.
*
* When processing a packet where the remaining number of bytes is less
* than bufsize, an exception is not thrown if the end of the packet
* is reached before the NUL is found. If no NUL is found before reaching
* the end of the short packet, -1 is still returned, and the string
* is truncated with a NUL, albeit not at buffer[bufsize - 1], but
* at the correct spot, terminating the string.
*
* *bytes_copied will contain the number of bytes actually copied,
* including the terminating-NUL.
*/
4010static int
4011_tvb_get_raw_bytes_as_stringz(tvbuff_t *tvb, const int offset, const unsigned bufsize, uint8_t* buffer, int *bytes_copied)
4012{
int      stringlen;
unsigned abs_offset = 0;
int      limit, len = 0;
bool_Bool     decreased_max = false0;

/* Only read to end of tvbuff, w/o throwing exception. */
check_offset_length(tvb, offset, -1, &abs_offset, &len);

/* There must at least be room for the terminating NUL. */
DISSECTOR_ASSERT(bufsize != 0)((void) ((bufsize != 0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4022, "bufsize != 0"
))));

/* If there's no room for anything else, just return the NUL. */
if (bufsize == 1) {
buffer[0] = 0;
*bytes_copied = 1;
return 0;
}

/* check_offset_length() won't throw an exception if we're
* looking at the byte immediately after the end of the tvbuff. */
if (len == 0) {
THROW(ReportedBoundsError)except_throw(1, (3), ((void*)0));
}

/* This should not happen because check_offset_length() would
* have already thrown an exception if 'offset' were out-of-bounds.
*/
DISSECTOR_ASSERT(len != -1)((void) ((len != -1) ? (void)0 : (proto_report_dissector_bug(
"%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4040, "len != -1"
))));

/*
* If we've been passed a negative number, bufsize will
* be huge.
*/
DISSECTOR_ASSERT(bufsize <= INT_MAX)((void) ((bufsize <= 2147483647) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4046, "bufsize <= 2147483647"
))));

if ((unsigned)len < bufsize) {
limit = len;
decreased_max = true1;
}
else {
limit = bufsize;
}

stringlen = tvb_strnlen(tvb, abs_offset, limit - 1);
/* If NUL wasn't found, copy the data and return -1 */
if (stringlen == -1) {
tvb_memcpy(tvb, buffer, abs_offset, limit);
if (decreased_max) {
	buffer[limit] = 0;
	/* Add 1 for the extra NUL that we set at buffer[limit],
	 * pretending that it was copied as part of the string. */
	*bytes_copied = limit + 1;
}
else {
	*bytes_copied = limit;
}
return -1;
}

/* Copy the string to buffer */
tvb_memcpy(tvb, buffer, abs_offset, stringlen + 1);
*bytes_copied = stringlen + 1;
return stringlen;
4076}

4078int
4079tvb_get_raw_bytes_as_stringz(tvbuff_t *tvb, const int offset, const unsigned bufsize, uint8_t* buffer)
4080{
int	len, bytes_copied;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4083, "tvb && tvb->initialized"
))));

len = _tvb_get_raw_bytes_as_stringz(tvb, offset, bufsize, buffer, &bytes_copied);

if (len == -1) {
buffer[bufsize - 1] = 0;
return bytes_copied - 1;
}
else {
return len;
}
4094}

4096/*
* Given a tvbuff, an offset into the tvbuff, a buffer, and a buffer size,
* extract as many raw bytes from the tvbuff, starting at the offset,
* as 1) are available in the tvbuff and 2) will fit in the buffer, leaving
* room for a terminating NUL.
*/
4102int
4103tvb_get_raw_bytes_as_string(tvbuff_t *tvb, const int offset, char *buffer, size_t bufsize)
4104{
int      len = 0;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4107, "tvb && tvb->initialized"
))));

/* There must be room for the string and the terminating NUL. */
DISSECTOR_ASSERT(bufsize > 0)((void) ((bufsize > 0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4110, "bufsize > 0"
))));

DISSECTOR_ASSERT(bufsize - 1 < INT_MAX)((void) ((bufsize - 1 < 2147483647) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4112, "bufsize - 1 < 2147483647"
))));

len = tvb_captured_length_remaining(tvb, offset);
if (len <= 0) {
buffer[0] = '\0';
return 0;
}
if (len > (int)(bufsize - 1))
len = (int)(bufsize - 1);

/* Copy the string to buffer */
tvb_memcpy(tvb, buffer, offset, len);
buffer[len] = '\0';
return len;
4126}

4128bool_Bool
4129tvb_ascii_isprint(tvbuff_t *tvb, const int offset, const int length)
4130{
const uint8_t* buf = tvb_get_ptr(tvb, offset, length);
unsigned abs_offset, abs_length = length;

if (length == -1) {
/* tvb_get_ptr has already checked for exceptions. */
compute_offset_and_remaining(tvb, offset, &abs_offset, &abs_length);
}
for (unsigned i = 0; i < abs_length; i++, buf++)
if (!g_ascii_isprint(*buf)((g_ascii_table[(guchar) (*buf)] & G_ASCII_PRINT) != 0))
	return false0;

return true1;
4143}

4145bool_Bool
4146tvb_utf_8_isprint(tvbuff_t *tvb, const int offset, const int length)
4147{
const uint8_t* buf = tvb_get_ptr(tvb, offset, length);
unsigned abs_offset, abs_length = length;

if (length == -1) {
/* tvb_get_ptr has already checked for exceptions. */
compute_offset_and_remaining(tvb, offset, &abs_offset, &abs_length);
}

return isprint_utf8_string(buf, abs_length);
4157}

4159bool_Bool
4160tvb_ascii_isdigit(tvbuff_t *tvb, const int offset, const int length)
4161{
const uint8_t* buf = tvb_get_ptr(tvb, offset, length);
unsigned abs_offset, abs_length = length;

if (length == -1) {
/* tvb_get_ptr has already checked for exceptions. */
compute_offset_and_remaining(tvb, offset, &abs_offset, &abs_length);
}
for (unsigned i = 0; i < abs_length; i++, buf++)
if (!g_ascii_isdigit(*buf)((g_ascii_table[(guchar) (*buf)] & G_ASCII_DIGIT) != 0))
	return false0;

return true1;
4174}

4176static ws_mempbrk_pattern pbrk_crlf;
4177/*
* Given a tvbuff, an offset into the tvbuff, and a length that starts
* at that offset (which may be -1 for "all the way to the end of the
* tvbuff"), find the end of the (putative) line that starts at the
* specified offset in the tvbuff, going no further than the specified
* length.
*
* Return the length of the line (not counting the line terminator at
* the end), or, if we don't find a line terminator:
*
* if "desegment" is true, return -1;
*
* if "desegment" is false, return the amount of data remaining in
* the buffer.
*
* If "next_offset" is not NULL, set "*next_offset" to the offset of the
* character past the line terminator, or past the end of the buffer if
* we don't find a line terminator.  (It's not set if we return -1.)
*/
4196int
4197tvb_find_line_end(tvbuff_t *tvb, const int offset, int len, int *next_offset, const bool_Bool desegment)
4198{
int    eob_offset;
int    eol_offset;
int    linelen;
unsigned char found_needle = 0;
static bool_Bool compiled = false0;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4205, "tvb && tvb->initialized"
))));

if (len == -1) {
len = _tvb_captured_length_remaining(tvb, offset);
/* if offset is past the end of the tvbuff, len is now 0 */
}

eob_offset = offset + len;

if (!compiled) {
ws_mempbrk_compile(&pbrk_crlf, "\r\n");
compiled = true1;
}

/*
* Look either for a CR or an LF.
*/
eol_offset = tvb_ws_mempbrk_pattern_uint8(tvb, offset, len, &pbrk_crlf, &found_needle);
if (eol_offset == -1) {
/*
 * No CR or LF - line is presumably continued in next packet.
 */
if (desegment) {
	/*
	 * Tell our caller we saw no EOL, so they can
	 * try to desegment and get the entire line
	 * into one tvbuff.
	 */
	return -1;
} else {
	/*
	 * Pretend the line runs to the end of the tvbuff.
	 */
	linelen = eob_offset - offset;
	if (next_offset)
		*next_offset = eob_offset;
}
} else {
/*
 * Find the number of bytes between the starting offset
 * and the CR or LF.
 */
linelen = eol_offset - offset;

/*
 * Is it a CR?
 */
if (found_needle == '\r') {
	/*
	 * Yes - is it followed by an LF?
	 */
	if (eol_offset + 1 >= eob_offset) {
		/*
		 * Dunno - the next byte isn't in this
		 * tvbuff.
		 */
		if (desegment) {
			/*
			 * We'll return -1, although that
			 * runs the risk that if the line
			 * really *is* terminated with a CR,
			 * we won't properly dissect this
			 * tvbuff.
			 *
			 * It's probably more likely that
			 * the line ends with CR-LF than
			 * that it ends with CR by itself.
			 */
			return -1;
		}
	} else {
		/*
		 * Well, we can at least look at the next
		 * byte.
		 */
		if (tvb_get_uint8(tvb, eol_offset + 1) == '\n') {
			/*
			 * It's an LF; skip over the CR.
			 */
			eol_offset++;
		}
	}
}

/*
 * Return the offset of the character after the last
 * character in the line, skipping over the last character
 * in the line terminator.
 */
if (next_offset)
	*next_offset = eol_offset + 1;
}
return linelen;
4298}

4300static ws_mempbrk_pattern pbrk_crlf_dquote;
4301/*
* Given a tvbuff, an offset into the tvbuff, and a length that starts
* at that offset (which may be -1 for "all the way to the end of the
* tvbuff"), find the end of the (putative) line that starts at the
* specified offset in the tvbuff, going no further than the specified
* length.
*
* However, treat quoted strings inside the buffer specially - don't
* treat newlines in quoted strings as line terminators.
*
* Return the length of the line (not counting the line terminator at
* the end), or the amount of data remaining in the buffer if we don't
* find a line terminator.
*
* If "next_offset" is not NULL, set "*next_offset" to the offset of the
* character past the line terminator, or past the end of the buffer if
* we don't find a line terminator.
*/
4319int
4320tvb_find_line_end_unquoted(tvbuff_t *tvb, const int offset, int len, int *next_offset)
4321{
int      cur_offset, char_offset;
bool_Bool     is_quoted;
unsigned char   c = 0;
int      eob_offset;
int      linelen;
static bool_Bool compiled = false0;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4329, "tvb && tvb->initialized"
))));

if (len == -1)
len = _tvb_captured_length_remaining(tvb, offset);

if (!compiled) {
ws_mempbrk_compile(&pbrk_crlf_dquote, "\r\n\"");
compiled = true1;
}

/*
* XXX - what if "len" is still -1, meaning "offset is past the
* end of the tvbuff"?
*/
eob_offset = offset + len;

cur_offset = offset;
is_quoted  = false0;
for (;;) {
	/*
 * Is this part of the string quoted?
 */
if (is_quoted) {
	/*
	 * Yes - look only for the terminating quote.
	 */
	char_offset = tvb_find_uint8(tvb, cur_offset, len,
		'"');
} else {
	/*
	 * Look either for a CR, an LF, or a '"'.
	 */
	char_offset = tvb_ws_mempbrk_pattern_uint8(tvb, cur_offset, len, &pbrk_crlf_dquote, &c);
}
if (char_offset == -1) {
	/*
	 * Not found - line is presumably continued in
	 * next packet.
	 * We pretend the line runs to the end of the tvbuff.
	 */
	linelen = eob_offset - offset;
	if (next_offset)
		*next_offset = eob_offset;
	break;
}

if (is_quoted) {
	/*
	 * We're processing a quoted string.
	 * We only looked for ", so we know it's a ";
	 * as we're processing a quoted string, it's a
	 * closing quote.
	 */
	is_quoted = false0;
} else {
	/*
	 * OK, what is it?
	 */
	if (c == '"') {
		/*
		 * Un-quoted "; it begins a quoted
		 * string.
		 */
		is_quoted = true1;
	} else {
		/*
		 * It's a CR or LF; we've found a line
		 * terminator.
		 *
		 * Find the number of bytes between the
		 * starting offset and the CR or LF.
		 */
		linelen = char_offset - offset;

		/*
		 * Is it a CR?
		 */
		if (c == '\r') {
			/*
			 * Yes; is it followed by an LF?
			 */
			if (char_offset + 1 < eob_offset &&
				tvb_get_uint8(tvb, char_offset + 1)
				  == '\n') {
				/*
				 * Yes; skip over the CR.
				 */
				char_offset++;
			}
		}

		/*
		 * Return the offset of the character after
		 * the last character in the line, skipping
		 * over the last character in the line
		 * terminator, and quit.
		 */
		if (next_offset)
			*next_offset = char_offset + 1;
		break;
	}
}

/*
 * Step past the character we found.
 */
cur_offset = char_offset + 1;
if (cur_offset >= eob_offset) {
	/*
	 * The character we found was the last character
	 * in the tvbuff - line is presumably continued in
	 * next packet.
	 * We pretend the line runs to the end of the tvbuff.
	 */
	linelen = eob_offset - offset;
	if (next_offset)
		*next_offset = eob_offset;
	break;
}
}
return linelen;
4450}

4452/*
* Copied from the mgcp dissector. (This function should be moved to /epan )
* tvb_skip_wsp - Returns the position in tvb of the first non-whitespace
*				  character following offset or offset + maxlength -1 whichever
*				  is smaller.
*
* Parameters:
* tvb - The tvbuff in which we are skipping whitespace.
* offset - The offset in tvb from which we begin trying to skip whitespace.
* maxlength - The maximum distance from offset that we may try to skip
* whitespace.
*
* Returns: The position in tvb of the first non-whitespace
*			character following offset or offset + maxlength -1 whichever
*			is smaller.
*/
4468int
4469tvb_skip_wsp(tvbuff_t *tvb, const int offset, const int maxlength)
4470{
int    counter;
int    end, tvb_len;
uint8_t tempchar;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4475, "tvb && tvb->initialized"
))));

/* Get the length remaining */
/*tvb_len = tvb_captured_length(tvb);*/
tvb_len = tvb->length;

end     = offset + maxlength;
if (end >= tvb_len)
{
end = tvb_len;
}

/* Skip past spaces, tabs, CRs and LFs until run out or meet something else */
for (counter = offset;
 counter < end &&
  ((tempchar = tvb_get_uint8(tvb,counter)) == ' ' ||
  tempchar == '\t' || tempchar == '\r' || tempchar == '\n');
 counter++);

return (counter);
4495}

4497int
4498tvb_skip_wsp_return(tvbuff_t *tvb, const int offset)
4499{
int    counter;
uint8_t tempchar;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4503, "tvb && tvb->initialized"
))));

for (counter = offset; counter > 0 &&
((tempchar = tvb_get_uint8(tvb,counter)) == ' ' ||
tempchar == '\t' || tempchar == '\n' || tempchar == '\r'); counter--);
counter++;

return (counter);
4511}

4513int
4514tvb_skip_uint8(tvbuff_t *tvb, int offset, const int maxlength, const uint8_t ch)
4515{
int end, tvb_len;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4518, "tvb && tvb->initialized"
))));

/* Get the length remaining */
/*tvb_len = tvb_captured_length(tvb);*/
tvb_len = tvb->length;

end     = offset + maxlength;
if (end >= tvb_len)
end = tvb_len;

while (offset < end) {
uint8_t tempch = tvb_get_uint8(tvb, offset);

if (tempch != ch)
	break;
offset++;
}

return offset;
4537}

4539static ws_mempbrk_pattern pbrk_whitespace;

4541int tvb_get_token_len(tvbuff_t *tvb, const int offset, int len, int *next_offset, const bool_Bool desegment)
4542{
int    eob_offset;
int    eot_offset;
int    tokenlen;
unsigned char found_needle = 0;
static bool_Bool compiled = false0;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4549, "tvb && tvb->initialized"
))));

if (len == -1) {
len = _tvb_captured_length_remaining(tvb, offset);
/* if offset is past the end of the tvbuff, len is now 0 */
}

eob_offset = offset + len;

if (!compiled) {
ws_mempbrk_compile(&pbrk_whitespace, " \r\n");
compiled = true1;
}

/*
* Look either for a space, CR, or LF.
*/
eot_offset = tvb_ws_mempbrk_pattern_uint8(tvb, offset, len, &pbrk_whitespace, &found_needle);
if (eot_offset == -1) {
/*
* No space, CR or LF - token is presumably continued in next packet.
*/
if (desegment) {
	/*
	* Tell our caller we saw no whitespace, so they can
	* try to desegment and get the entire line
	* into one tvbuff.
	*/
	return -1;
}
else {
	/*
	* Pretend the token runs to the end of the tvbuff.
	*/
	tokenlen = eob_offset - offset;
	if (next_offset)
		*next_offset = eob_offset;
}
}
else {
/*
* Find the number of bytes between the starting offset
* and the space, CR or LF.
*/
tokenlen = eot_offset - offset;

/*
* Return the offset of the character after the last
* character in the line, skipping over the last character
* in the line terminator.
*/
if (next_offset)
	*next_offset = eot_offset + 1;
}
return tokenlen;
4604}

4606/*
* Format a bunch of data from a tvbuff as bytes, returning a pointer
* to the string with the formatted data, with "punct" as a byte
* separator.
*/
4611char *
4612tvb_bytes_to_str_punct(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int len, const char punct)
4613{
DISSECTOR_ASSERT(len >= 0)((void) ((len >= 0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4614, "len >= 0"
))));
return bytes_to_str_punct(scope, ensure_contiguous(tvb, offset, len), len, punct)bytes_to_str_punct_maxlen(scope, ensure_contiguous(tvb, offset
, len), len, punct, 24);
4616}

4618/*
* Given a wmem scope, a tvbuff, an offset, a length, an input digit
* set, and a boolean indicator, fetch BCD-encoded digits from a
* tvbuff starting from either the low or high half byte of the
* first byte depending on the boolean indicator (true means "start
* with the high half byte, ignoring the low half byte", and false
* means "start with the low half byte and proceed to the high half
* byte), formating the digits into characters according to the
* input digit set, and return a pointer to a UTF-8 string, allocated
* using the wmem scope.  A nibble of 0xf is considered a 'filler'
* and will end the conversion. Similarly if odd is set the last
* high nibble will be omitted. (Note that if both skip_first and
* odd are true, then both the first and last semi-octet are skipped,
* i.e. an even number of nibbles are considered.)
*/
4633char *
4634tvb_get_bcd_string(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, int len, const dgt_set_t *dgt, bool_Bool skip_first, bool_Bool odd, bool_Bool bigendian)
4635{
const uint8_t *ptr;
int           i = 0;
char         *digit_str;
uint8_t       octet, nibble;

DISSECTOR_ASSERT(tvb && tvb->initialized)((void) ((tvb && tvb->initialized) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4641, "tvb && tvb->initialized"
))));

if (len == -1) {
/*
 * Run to the end of the captured data.
 *
 * XXX - captured, or total?
 */
/*length = tvb_captured_length(tvb);*/
len = tvb->length;
if (len < offset) {
	return (char *)"";
}
len -= offset;
}

ptr = ensure_contiguous(tvb, offset, len);

/*
* XXX - map illegal digits (digits that map to 0) to REPLACEMENT
* CHARACTER, and have all the tables in epan/tvbuff.c use 0 rather
* than '?'?
*/
digit_str = (char *)wmem_alloc(scope, len*2 + 1);

while (len > 0) {
octet = *ptr;
if (!skip_first) {
	if (bigendian) {
		nibble = (octet >> 4) & 0x0f;
	} else {
		nibble = octet & 0x0f;
	}
	if (nibble == 0x0f) {
		/*
		 * Stop digit.
		 */
		break;
	}
	digit_str[i] = dgt->out[nibble];
	i++;
}
skip_first = false0;

/*
 * unpack second value in byte
 */
if (bigendian) {
	nibble = octet & 0x0f;
} else {
	nibble = octet >> 4;
}

if (nibble == 0x0f) {
	/*
	 * This is the stop digit or a filler digit.  Ignore
	 * it.
	 */
	break;
}
if ((len == 1) && (odd == true1 )){
	/* Last octet, skip last high nibble in case of odd number of digits */
	break;
}
digit_str[i] = dgt->out[nibble];
i++;

ptr++;
len--;
}
digit_str[i] = '\0';
return digit_str;
4713}

4715/* XXXX Fix me - needs odd indicator added */
4716const char *
4717tvb_bcd_dig_to_str(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int len, const dgt_set_t *dgt, bool_Bool skip_first)
4718{
if (!dgt)
dgt = &Dgt0_9_bcd;

return tvb_get_bcd_string(scope, tvb, offset, len, dgt, skip_first, false0, false0);
4723}

4725const char *
4726tvb_bcd_dig_to_str_be(wmem_allocator_t *scope, tvbuff_t *tvb, const int offset, const int len, const dgt_set_t *dgt, bool_Bool skip_first)
4727{
if (!dgt)
dgt = &Dgt0_9_bcd;

return tvb_get_bcd_string(scope, tvb, offset, len, dgt, skip_first, false0, true1);
4732}

4734/*
* Format a bunch of data from a tvbuff as bytes, returning a pointer
* to the string with the formatted data.
*/
4738char *tvb_bytes_to_str(wmem_allocator_t *allocator, tvbuff_t *tvb,
  const int offset, const int len)
4740{
DISSECTOR_ASSERT(len >= 0)((void) ((len >= 0) ? (void)0 : (proto_report_dissector_bug
("%s:%u: failed assertion \"%s\"", "epan/tvbuff.c", 4741, "len >= 0"
))));
return bytes_to_str(allocator, ensure_contiguous(tvb, offset, len), len)bytes_to_str_maxlen(allocator, ensure_contiguous(tvb, offset,
 len), len, 36);
4743}

4745/* Find a needle tvbuff within a haystack tvbuff. */
4746int
4747tvb_find_tvb(tvbuff_t *haystack_tvb, tvbuff_t *needle_tvb, const int haystack_offset)
4748{
unsigned	      haystack_abs_offset = 0, haystack_abs_length = 0;
const uint8_t *haystack_data;
const uint8_t *needle_data;
const unsigned   needle_len = needle_tvb->length;
const uint8_t *location;

DISSECTOR_ASSERT(haystack_tvb && haystack_tvb->initialized)((void) ((haystack_tvb && haystack_tvb->initialized
) ? (void)0 : (proto_report_dissector_bug("%s:%u: failed assertion \"%s\""
, "epan/tvbuff.c", 4755, "haystack_tvb && haystack_tvb->initialized"
))));

if (haystack_tvb->length < 1 || needle_tvb->length < 1) {
return -1;
}

/* Get pointers to the tvbuffs' data. */
haystack_data = ensure_contiguous(haystack_tvb, 0, -1);
needle_data   = ensure_contiguous(needle_tvb, 0, -1);

check_offset_length(haystack_tvb, haystack_offset, -1,
	&haystack_abs_offset, &haystack_abs_length);

location = ws_memmem(haystack_data + haystack_abs_offset, haystack_abs_length,
	needle_data, needle_len);

if (location) {
return (int) (location - haystack_data);
}

return -1;
4776}

4778int
4779tvb_raw_offset(tvbuff_t *tvb)
4780{
return ((tvb->raw_offset==-1) ? (tvb->raw_offset = tvb_offset_from_real_beginning(tvb)) : tvb->raw_offset);
4782}

4784void
4785tvb_set_fragment(tvbuff_t *tvb)
4786{
tvb->flags |= TVBUFF_FRAGMENT0x00000001;
4788}

4790struct tvbuff *
4791tvb_get_ds_tvb(tvbuff_t *tvb)
4792{
return(tvb->ds_tvb);
4794}

4796unsigned
4797tvb_get_varint(tvbuff_t *tvb, unsigned offset, unsigned maxlen, uint64_t *value, const unsigned encoding)
4798{
*value = 0;

switch (encoding & ENC_VARINT_MASK(0x00000002|0x00000004|0x00000008|0x00000010)) {
case ENC_VARINT_PROTOBUF0x00000002:
{
unsigned i;
uint64_t b; /* current byte */

for (i = 0; ((i < FT_VARINT_MAX_LEN10) && (i < maxlen)); ++i) {
	b = tvb_get_uint8(tvb, offset++);
	*value |= ((b & 0x7F) << (i * 7)); /* add lower 7 bits to val */

	if (b < 0x80) {
		/* end successfully because of last byte's msb(most significant bit) is zero */
		return i + 1;
	}
}
break;
}

case ENC_VARINT_ZIGZAG0x00000008:
{
unsigned i;
uint64_t b; /* current byte */

for (i = 0; ((i < FT_VARINT_MAX_LEN10) && (i < maxlen)); ++i) {
	b = tvb_get_uint8(tvb, offset++);
	*value |= ((b & 0x7F) << (i * 7)); /* add lower 7 bits to val */

	if (b < 0x80) {
		/* end successfully because of last byte's msb(most significant bit) is zero */
		*value = (*value >> 1) ^ ((*value & 1) ? -1 : 0);
		return i + 1;
	}
}
break;
}

case ENC_VARINT_SDNV0x00000010:
{
/* Decodes similar to protobuf but in MSByte order */
unsigned i;
uint64_t b; /* current byte */

for (i = 0; ((i < FT_VARINT_MAX_LEN10) && (i < maxlen)); ++i) {
	b = tvb_get_uint8(tvb, offset++);
	if ((i == 9) && (*value >= UINT64_C(1)1UL<<(64-7))) {
		// guaranteed overflow, not valid SDNV
		return 0;
	}
	*value <<= 7;
	*value |= (b & 0x7F); /* add lower 7 bits to val */

	if (b < 0x80) {
		/* end successfully because of last byte's msb(most significant bit) is zero */
		return i + 1;
	}
}
break;
}

case ENC_VARINT_QUIC0x00000004:
{
/* calculate variable length */
*value = tvb_get_uint8(tvb, offset);
switch((*value) >> 6) {
case 0: /* 0b00 => 1 byte length (6 bits Usable) */
	(*value) &= 0x3F;
	return 1;
case 1: /* 0b01 => 2 bytes length (14 bits Usable) */
	*value = tvb_get_ntohs(tvb, offset) & 0x3FFF;
	return 2;
case 2: /* 0b10 => 4 bytes length (30 bits Usable) */
	*value = tvb_get_ntohl(tvb, offset) & 0x3FFFFFFF;
	return 4;
case 3: /* 0b11 => 8 bytes length (62 bits Usable) */
	*value = tvb_get_ntoh64(tvb, offset) & UINT64_C(0x3FFFFFFFFFFFFFFF)0x3FFFFFFFFFFFFFFFUL;
	return 8;
default: /* No Possible */
	ws_assert_not_reached()ws_log_fatal_full("", LOG_LEVEL_ERROR, "epan/tvbuff.c", 4878,
 __func__, "assertion \"not reached\" failed");
	break;
}
break;
}

default:
DISSECTOR_ASSERT_NOT_REACHED()(proto_report_dissector_bug("%s:%u: failed assertion \"DISSECTOR_ASSERT_NOT_REACHED\""
, "epan/tvbuff.c", 4885));
}

return 0; /* 10 bytes scanned, but no bytes' msb is zero */
4889}

4891/*
* Editor modelines  -  https://www.wireshark.org/tools/modelines.html
*
* Local variables:
* c-basic-offset: 8
* tab-width: 8
* indent-tabs-mode: t
* End:
*
* vi: set shiftwidth=8 tabstop=8 noexpandtab:
* :indentSize=8:tabSize=8:noTabs=false:
*/