Struct Sections 

pub struct Sections {
    pub functions: bool,
    pub data: bool,
}

Whether each function and each variable gets a section to itself.

Design: spec/11-asm-objects-debug.md section 11.3, and spec/04-driver-and-cli.md section 4.7 for the flags that ask for it.

A linker can drop a section nothing reaches and cannot drop half of one, so a file whose functions share a section keeps every function that file defines in the output as soon as any one of them is called. Splitting them is what makes --gc-sections do anything, which is how an embedded image or a kernel gets small, and it is the whole of what these two flags are for. The cost is a section header per name, which is why it is asked for rather than always done.

Not one flag, because gcc has two and a build that wants one of them and not the other is a build that measured something. Splitting the code is nearly free at link time; splitting the data can defeat the linker’s ordering of what is next to what.

Fields

functions: bool

-ffunction-sections. Each function in .text.<name> rather than all of them in .text.

data: bool

-fdata-sections. Each variable in a section named after it rather than in the one its contents would otherwise have chosen.

Implementations

impl Sections

pub const fn any(self) -> bool

Whether either of them was asked for.

Trait Implementations

impl Clone for Sections

fn clone(&self) -> Sections

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Sections

impl Debug for Sections

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

Formats the value using the given formatter.

impl Default for Sections

fn default() -> Sections

Returns the “default value” for a type.

impl Eq for Sections

impl PartialEq for Sections

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Sections