gdbstub 0.7.10

An implementation of the GDB Remote Serial Protocol in Rust
Documentation 
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//! Report information about the loaded shared libraries for targets where there
//! are possibly multiple files to be debugged mapped into the same address
//! space.

use crate::target::Target;
use crate::target::TargetResult;

/// Target Extension - List an SVR4 (System-V/Unix) target's libraries.
pub trait LibrariesSvr4: Target {
    /// Get library list XML for this target.
    ///
    /// See the [GDB Documentation] for a description of the format.
    ///
    /// [GDB Documentation]: https://sourceware.org/gdb/current/onlinedocs/gdb.html/Library-List-Format-for-SVR4-Targets.html
    ///
    /// Return the number of bytes written into `buf` (which may be less than
    /// `length`).
    ///
    /// If `offset` is greater than the length of the underlying data, return
    /// `Ok(0)`.
    fn get_libraries_svr4(
        &self,
        offset: u64,
        length: usize,
        buf: &mut [u8],
    ) -> TargetResult<usize, Self>;
}

define_ext!(LibrariesSvr4Ops, LibrariesSvr4);

/// Target Extension - List a target's libraries (Windows/generic format).
///
/// This is used for targets where library offsets are maintained externally
/// (e.g., Windows PE targets). Unlike SVR4 format, this uses a simpler XML
/// structure with segment addresses.
pub trait Libraries: Target {
    /// Get library list XML for this target.
    ///
    /// The expected XML format is:
    /// ```xml
    /// <library-list version="1.0">
    /// <library name="C:\Windows\notepad.exe"><segment address="0x00401000"/></library>
    /// <library name="C:\Windows\SYSTEM32\ntdll.dll"><segment address="0x774d1000"/></library>
    /// <library name="C:\Windows\system32\kernel32.dll"><segment address="0x772b1000"/></library>
    /// <library name="C:\Windows\system32\KernelBase.dll"><segment address="0x7fefd701000"/></library>
    /// </library-list>
    /// ```
    ///
    /// Note that on Windows, the `address` is not the image base, but the
    /// address of the first section. See the [GDB Documentation] for more
    /// details.
    ///
    /// [GDB Documentation]: https://sourceware.org/gdb/current/onlinedocs/gdb.html/Library-List-Format.html
    ///
    /// Return the number of bytes written into `buf` (which may be less than
    /// `length`).
    ///
    /// If `offset` is greater than the length of the underlying data, return
    /// `Ok(0)`.
    fn get_libraries(
        &self,
        offset: u64,
        length: usize,
        buf: &mut [u8],
    ) -> TargetResult<usize, Self>;
}

define_ext!(LibrariesOps, Libraries);