backtrace 0.3.76

A library to acquire a stack trace (backtrace) at runtime in a Rust program.
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

use super::super::super::windows_sys::*;

use super::mystd::fs::File;
use super::mystd::os::windows::prelude::*;
use core::ffi::c_void;
use core::ops::Deref;
use core::ptr;
use core::slice;

pub struct Mmap {
    // keep the file alive to prevent it from being deleted which would cause
    // us to read bad data.
    _file: File,
    ptr: *mut c_void,
    len: usize,
}

impl Mmap {
    pub unsafe fn map(file: &File, len: usize, offset: u64) -> Option<Mmap> {
        unsafe {
            let file = file.try_clone().ok()?;
            let mapping = CreateFileMappingA(
                file.as_raw_handle(),
                ptr::null_mut(),
                PAGE_READONLY,
                0,
                0,
                ptr::null(),
            );
            if mapping.is_null() {
                return None;
            }
            let ptr = MapViewOfFile(
                mapping,
                FILE_MAP_READ,
                (offset >> 32) as u32,
                offset as u32,
                len,
            );
            CloseHandle(mapping);
            if ptr.Value.is_null() {
                return None;
            }
            Some(Mmap {
                _file: file,
                ptr: ptr.Value,
                len,
            })
        }
    }
}
impl Deref for Mmap {
    type Target = [u8];

    fn deref(&self) -> &[u8] {
        unsafe { slice::from_raw_parts(self.ptr.cast_const().cast::<u8>(), self.len) }
    }
}

impl Drop for Mmap {
    fn drop(&mut self) {
        unsafe {
            let r = UnmapViewOfFile(MEMORY_MAPPED_VIEW_ADDRESS { Value: self.ptr });
            debug_assert!(r != 0);
        }
    }
}