cfi-types 0.0.6

CFI types for cross-language LLVM CFI support
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! CFI types for cross-language LLVM CFI support.
//!
//! The cfi_types crate provides a new set of C types as user-defined types
//! using the cfi_encoding attribute and repr(transparent) to be used for
//! cross-language LLVM CFI support. This new set of C types allows the Rust
//! compiler to identify and correctly encode C types in extern "C" function
//! types indirectly called across the FFI boundary when CFI is enabled.
//!
//! The use of these types are optional and are recommended for when enforcement
//! and explicitness of types used across the FFI boundary and no loss of
//! granularity for cross-language LLVM CFI are preferred.
//!
//! Alternatively, the `-Zsanitizer-cfi-normalize-integers` option may be used
//! with the Clang `-fsanitize-cfi-icall-experimental-normalize-integers` option
//! for cross-language LLVM CFI support.

#![feature(cfg_sanitizer_cfi)]
#![feature(cfi_encoding)]
#![allow(non_camel_case_types)]

/// CFI type equivalent to Rust's core::ffi::c_char type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "c")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_char(pub core::ffi::c_char);

/// CFI type equivalent to Rust's core::ffi::c_int type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "i")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_int(pub core::ffi::c_int);

/// CFI type equivalent to Rust's core::ffi::c_long type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "l")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_long(pub core::ffi::c_long);

/// CFI type equivalent to Rust's core::ffi::c_longlong type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "x")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_longlong(pub core::ffi::c_longlong);

/// CFI type equivalent to Rust's core::ffi::c_schar type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "a")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_schar(pub core::ffi::c_schar);

/// CFI type equivalent to Rust's core::ffi::c_short type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "s")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_short(pub core::ffi::c_short);

/// CFI type equivalent to Rust's core::ffi::c_uchar type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "h")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_uchar(pub core::ffi::c_uchar);

/// CFI type equivalent to Rust's core::ffi::c_uint type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "j")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_uint(pub core::ffi::c_uint);

/// CFI type equivalent to Rust's core::ffi::c_ulong type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "m")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_ulong(pub core::ffi::c_ulong);

/// CFI type equivalent to Rust's core::ffi::c_ulonglong type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "y")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_ulonglong(pub core::ffi::c_ulonglong);

/// CFI type equivalent to Rust's core::ffi::c_ushort type alias.
#[allow(dead_code)]
#[cfg_attr(not(sanitizer_cfi_normalize_integers), cfi_encoding = "t")]
#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Debug)]
#[repr(transparent)]
pub struct c_ushort(pub core::ffi::c_ushort);