Struct elf_utilities::symbol::elf64::Symbol64

#[repr(C)]pub struct Symbol64 { /* fields omitted */ }

Symbol64 is a entry of symbol table section.

Symbol64 はシンボルテーブルセクションのエントリである． ELF64で用いることを想定している．

Defaultトレイトを実装しているので， Default::default() を呼び出すことで簡単にNULLシンボルを作成できる．

Examples

use elf_utilities::symbol::Symbol64;
let null_sym : Symbol64 = Default::default();

// Symbol64::new_null_symbol() のエイリアスでも作成可能．
let null_sym2 : Symbol64 = Symbol64::new_null_symbol();

assert_eq!(null_sym, null_sym2);

ELFファイルを生成する用途でこのライブラリを使用できるように， バイト列への変換もサポートしている．

Examples

use elf_utilities::symbol::Symbol64;
let null_sym : Symbol64 = Default::default();

// to_le_bytes() を利用してバイト列に変換できる．
let sym_bytes = null_sym.to_le_bytes();
assert_eq!(sym_bytes.len() as elf_utilities::Elf64Xword, Symbol64::size())

Implementations

impl Symbol64

pub fn new_null_symbol() -> Self

pub fn size() -> Elf64Xword

size() provides Symbol64's size used by Shdr64.sh_entsize or else.

pub fn set_symbol_name(&mut self, name: String)

for comparison

pub fn compare_symbol_name(&self, other: String) -> bool

pub fn get_type(&self) -> u8

pub fn get_bind(&self) -> u8

pub fn set_name(&mut self, name: Elf64Word)

Set symbol name index to Symbol64

Examples

use elf_utilities::symbol::Symbol64;
let mut null_sym : Symbol64 = Default::default();
null_sym.set_name(1);

assert_eq!(null_sym.get_name(), 1);

pub fn set_info(&mut self, info: u8)

Set symbol's information to Symbol64 See symbol::symbol_info for constructing symbol's information.

Examples

use elf_utilities::symbol;
let mut null_sym = symbol::Symbol64::new_null_symbol();

let sym_info = symbol::symbol_info(symbol::STB_GLOBAL, symbol::STT_FUNC);
null_sym.set_info(sym_info);

assert_eq!((1 << 4) | 2, null_sym.get_info());

pub fn set_other(&mut self, other: u8)

Set symbol's other value to Symbol64 See symbol::VISIBILITY and symbol::symbol_visibility

Examples

use elf_utilities::symbol;
let mut null_sym = symbol::Symbol64::new_null_symbol();

let sym_vis = symbol::symbol_visibility(symbol::VISIBILITY::PROTECTED);
null_sym.set_other(sym_vis);
assert_eq!(0x3, null_sym.get_other());

pub fn set_shndx(&mut self, shndx: Elf64Section)

Set a section table index includes this symbol.

Examples

use elf_utilities::symbol::Symbol64;
let mut null_sym : Symbol64 = Default::default();
null_sym.set_shndx(1);

assert_eq!(null_sym.get_shndx(), 1);

pub fn set_value(&mut self, value: Elf64Addr)

Set symbol value to Symbol64

Examples

use elf_utilities::symbol::Symbol64;
let mut null_sym : Symbol64 = Default::default();
null_sym.set_value(1);

assert_eq!(null_sym.get_value(), 1);

pub fn set_size(&mut self, size: Elf64Xword)

Set symbol binary size to Symbol64

Examples

use elf_utilities::symbol::Symbol64;
let mut null_sym : Symbol64 = Default::default();
null_sym.set_size(0x40);

assert_eq!(null_sym.get_size(), 64);

pub fn get_name(&self) -> Elf64Word

Get the symbol name index.

pub fn get_info(&self) -> u8

Get this symbol's information.

pub fn get_other(&self) -> u8

Get this symbol's visibility.

pub fn get_shndx(&self) -> Elf64Section

Get a section table index that related with this symbol.

pub fn get_value(&self) -> Elf64Addr

Get this symbol's value.

pub fn get_size(&self) -> Elf64Xword

Get this symbol's size.

pub fn to_le_bytes(&self) -> Vec<u8>

Create Vec from Symbol64's each fields.

Examples

use elf_utilities::symbol::Symbol64;
let null_sym : Symbol64 = Default::default();

assert_eq!([0].repeat(Symbol64::size() as usize), null_sym.to_le_bytes());

Trait Implementations

impl Clone for Symbol64

fn clone(&self) -> Symbol64

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Symbol64

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

Formats the value using the given formatter.

impl Default for Symbol64

fn default() -> Self

Returns the "default value" for a type.

impl Eq for Symbol64

impl Ord for Symbol64

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

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialEq<Symbol64> for Symbol64

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<Symbol64> for Symbol64

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl StructuralEq for Symbol64

impl StructuralPartialEq for Symbol64