heapdump_snapshot/
lib.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Copyright 2023 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

use fidl_fuchsia_memory_heapdump_client as fheapdump_client;
use thiserror::Error;

mod snapshot;
pub use snapshot::{Allocation, ExecutableRegion, Snapshot, StackTrace, ThreadInfo};

mod streamer;
pub use streamer::Streamer;

#[derive(Debug, Error)]
pub enum Error {
    #[error("Missing expected field {} in {}", .field, .container)]
    MissingField { container: &'static str, field: &'static str },
    #[error("SnapshotReceiver stream ended unexpectedly")]
    UnexpectedEndOfStream,
    #[error("SnapshotReceiver stream contains an unknown element type")]
    UnexpectedElementType,
    #[error("SnapshotReceiver stream contains conflicting {} elements", .element_type)]
    ConflictingElement { element_type: &'static str },
    #[error("SnapshotReceiver stream contains a cross-reference to a non-existing {} element",
        .element_type)]
    InvalidCrossReference { element_type: &'static str },
    #[error("Zircon error: {}", .0)]
    ZxError(#[from] zx_status::Status),
    #[error("FIDL error: {}", .0)]
    FidlError(#[from] fidl::Error),
    #[error("Collector error: {:?}", .0)]
    CollectorError(fheapdump_client::CollectorError),
}