Enum Protector 

pub enum Protector {
    None,
    Buffers,
    Strong,
    All,
}

Which functions get a stack protector, which is what the -fstack-protector family asks.

A canary is a word the prologue copies into the frame above everything a local can be written through, and the epilogue compares it against the copy the runtime still holds before it returns. A write that runs off the end of a local and keeps going passes the canary on its way to the return address, so a function that returns with the word changed calls __stack_chk_fail instead of returning at all.

Which functions are worth the slot and the comparison is what the three levels disagree about, and the middle one is the one that matters: every distribution has built its packages with -fstack-protector-strong for a decade, so a compiler that cannot take the flag cannot be the CC of a package build whatever else it can do.

Variants

None

-fno-stack-protector, and what a command line that says nothing gets. gcc’s own default is the same, and it is the distributions rather than the compiler that turn it on.

Buffers

-fstack-protector. A function with a local array of at least eight bytes, or one whose stack grows while it runs.

Strong

-fstack-protector-strong. Any of those, and any function with a local array at all, a local holding one, or a local whose address is taken.

All

-fstack-protector-all. Every function that has a frame.

Implementations

impl Protector

pub const fn as_str(self) -> &'static str

The spelling this is asked for by, which is the whole flag rather than a part of one, because these are four flags and not one flag with an argument.

Trait Implementations

impl Clone for Protector

fn clone(&self) -> Protector

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Protector

impl Debug for Protector

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Protector

fn default() -> Protector

Returns the “default value” for a type.

impl Display for Protector

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Protector

impl Hash for Protector

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Protector

fn cmp(&self, other: &Protector) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Protector

fn eq(&self, other: &Protector) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Protector

fn partial_cmp(&self, other: &Protector) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Protector