// Copyright (c) 2019 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_GWP_ASAN_COMMON_PACK_STACK_TRACE_H_
#define COMPONENTS_GWP_ASAN_COMMON_PACK_STACK_TRACE_H_

#include <stddef.h>
#include <stdint.h>

// These routines 'compress' a stack trace by storing a stack trace as a
// starting address, followed by offsets from the previous pointer. All values
// are stored using variable-length integers to reduce space. Furthermore, they
// are zigzag encoded, like in protobuf encoding, to store negative offsets
// efficiently. On 64-bit platforms this packing can reduce space required to
// store a stack trace by over 50%.

namespace gwp_asan {
namespace internal {

// From the stack trace in |unpacked| of length |unpacked_size|, pack it into
// the buffer |packed| with maximum length |packed_max_size|. The return value
// is the number of bytes that were written to the output buffer.
size_t Pack(const uintptr_t* unpacked,
            size_t unpacked_size,
            uint8_t* packed,
            size_t packed_max_size);

// From the packed stack trace in |packed| of length |packed_size|, write the
// unpacked stack trace of maximum length |unpacked_max_size| into |unpacked|.
// Returns the number of entries un packed, or 0 on error.
size_t Unpack(const uint8_t* packed,
              size_t packed_size,
              uintptr_t* unpacked,
              size_t unpacked_max_size);

}  // namespace internal
}  // namespace gwp_asan

#endif  // COMPONENTS_GWP_ASAN_COMMON_PACK_STACK_TRACE_H_
