pub enum ExternAbi {
Show 27 variants
C {
unwind: bool,
},
System {
unwind: bool,
},
Rust,
RustCall,
RustCold,
RustInvalid,
Unadjusted,
Custom,
EfiApi,
Aapcs {
unwind: bool,
},
CmseNonSecureCall,
CmseNonSecureEntry,
GpuKernel,
PtxKernel,
AvrInterrupt,
AvrNonBlockingInterrupt,
Msp430Interrupt,
RiscvInterruptM,
RiscvInterruptS,
X86Interrupt,
Cdecl {
unwind: bool,
},
Stdcall {
unwind: bool,
},
Fastcall {
unwind: bool,
},
Thiscall {
unwind: bool,
},
Vectorcall {
unwind: bool,
},
SysV64 {
unwind: bool,
},
Win64 {
unwind: bool,
},
}
Expand description
ABI we expect to see within extern "{abi}"
Variants§
C
presumed C ABI for the platform
System
ABI of the “system” interface, e.g. the Win32 API, always “aliasing”
Rust
that’s us!
RustCall
the mostly-unused unboxed_closures
ABI, effectively now an impl detail unless someone
puts in the work to make it viable again… but would we need a special ABI?
RustCold
For things unlikely to be called, where reducing register pressure in
extern "Rust"
callers is worth paying extra cost in the callee.
Stronger than just #[cold]
because fn
pointers might be incompatible.
RustInvalid
An always-invalid ABI that’s used to test “this ABI is not supported by this platform” in a platform-agnostic way.
Unadjusted
Unstable impl detail that directly uses Rust types to describe the ABI to LLVM. Even normally-compatible Rust types can become ABI-incompatible with this ABI!
Custom
An ABI that rustc does not know how to call or define. Functions with this ABI can
only be created using #[naked]
functions or extern "custom"
blocks, and can only
be called from inline assembly.
EfiApi
UEFI ABI, usually an alias of C, but sometimes an arch-specific alias and only valid on platforms that have a UEFI standard
Aapcs
Arm Architecture Procedure Call Standard, sometimes ExternAbi::C
is an alias for this
CmseNonSecureCall
extremely constrained barely-C ABI for TrustZone
CmseNonSecureEntry
extremely constrained barely-C ABI for TrustZone
GpuKernel
An entry-point function called by the GPU’s host
PtxKernel
An entry-point function called by the GPU’s host
AvrInterrupt
AvrNonBlockingInterrupt
Msp430Interrupt
RiscvInterruptM
RiscvInterruptS
X86Interrupt
Cdecl
ExternAbi::C
but spelled funny because x86
Stdcall
gnu-stdcall on “unix” and win-stdcall on “windows”
Fastcall
gnu-fastcall on “unix” and win-fastcall on “windows”
Thiscall
windows C++ ABI
Vectorcall
uses AVX and stuff
SysV64
Win64
Implementations§
Source§impl ExternAbi
impl ExternAbi
pub const ALL_VARIANTS: &[Self]
pub const fn as_str(&self) -> &'static str
Source§impl ExternAbi
impl ExternAbi
Sourcepub fn is_rustic_abi(self) -> bool
pub fn is_rustic_abi(self) -> bool
An ABI “like Rust”
These ABIs are fully controlled by the Rust compiler, which means they
- support unwinding with
-Cpanic=unwind
, unlikeextern "C"
- often diverge from the C ABI
- are subject to change between compiler versions
pub fn supports_varargs(self) -> bool
Trait Implementations§
Source§impl<__D: SpanDecoder> Decodable<__D> for ExternAbi
impl<__D: SpanDecoder> Decodable<__D> for ExternAbi
Source§impl<__E: SpanEncoder> Encodable<__E> for ExternAbi
impl<__E: SpanEncoder> Encodable<__E> for ExternAbi
Source§impl<C> HashStable<C> for ExternAbi
impl<C> HashStable<C> for ExternAbi
fn hash_stable(&self, _: &mut C, hasher: &mut StableHasher)
Source§impl Ord for ExternAbi
impl Ord for ExternAbi
Source§impl PartialOrd for ExternAbi
impl PartialOrd for ExternAbi
Source§impl StableOrd for ExternAbi
impl StableOrd for ExternAbi
const CAN_USE_UNSTABLE_SORT: bool = true
Source§const THIS_IMPLEMENTATION_HAS_BEEN_TRIPLE_CHECKED: () = ()
const THIS_IMPLEMENTATION_HAS_BEEN_TRIPLE_CHECKED: () = ()
Ord
implementation obeys this trait’s contract.impl Copy for ExternAbi
impl Eq for ExternAbi
Auto Trait Implementations§
impl DynSend for ExternAbi
impl DynSync for ExternAbi
impl Freeze for ExternAbi
impl RefUnwindSafe for ExternAbi
impl Send for ExternAbi
impl Sync for ExternAbi
impl Unpin for ExternAbi
impl UnwindSafe for ExternAbi
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<T> StableCompare for Twhere
T: StableOrd,
impl<T> StableCompare for Twhere
T: StableOrd,
const CAN_USE_UNSTABLE_SORT: bool = T::CAN_USE_UNSTABLE_SORT
fn stable_cmp(&self, other: &T) -> Ordering
Source§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
Source§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
Source§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Layout§
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...)
attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.
Size: 2 bytes
Size for each variant:
C
: 1 byteSystem
: 1 byteRust
: 0 bytesRustCall
: 0 bytesRustCold
: 0 bytesRustInvalid
: 0 bytesUnadjusted
: 0 bytesCustom
: 0 bytesEfiApi
: 0 bytesAapcs
: 1 byteCmseNonSecureCall
: 0 bytesCmseNonSecureEntry
: 0 bytesGpuKernel
: 0 bytesPtxKernel
: 0 bytesAvrInterrupt
: 0 bytesAvrNonBlockingInterrupt
: 0 bytesMsp430Interrupt
: 0 bytesRiscvInterruptM
: 0 bytesRiscvInterruptS
: 0 bytesX86Interrupt
: 0 bytesCdecl
: 1 byteStdcall
: 1 byteFastcall
: 1 byteThiscall
: 1 byteVectorcall
: 1 byteSysV64
: 1 byteWin64
: 1 byte