ElfSection (unidbg-android 0.9.9 API)

java.lang.Object
- net.fornwall.jelf.ElfSection

All Implemented Interfaces:

SymbolLocator
```
public final class ElfSection
extends Object
implements SymbolLocator
```
Class corresponding to the Elf32_Shdr/Elf64_Shdr struct.
An object file's section header table lets one locate all the file's sections. The section header table is an array of Elf32_Shdr or Elf64_Shdr structures. A section header table index is a subscript into this array. The ELF header's e_shoff member gives the byte offset from the beginning of the file to the section header table with each section header entry being e_shentsize bytes big.
e_shnum normally tells how many entries the section header table contains, but if the number of sections is greater than or equal to SHN_LORESERVE (0xff00), e_shnum has the value SHN_UNDEF (0) and the actual number of section header table entries is contained in the sh_size field of the section header at index 0 (otherwise, the sh_size member of the initial entry contains 0).
Some section header table indexes are reserved in contexts where index size is restricted, for example, the st_shndx member of a symbol table entry and the e_shnum and e_shstrndx members of the ELF header. In such contexts, the reserved values do not represent actual sections in the object file. Also in such contexts, an escape value indicates that the actual section index is to be found elsewhere, in a larger field.

Field Summary

Fields
Modifier and Type	Field and Description
`long`	`address` sh_addr.
`long`	`address_alignment` Address alignment constraints for the section.
`static String`	`DYNAMIC_STRING_TABLE_NAME` Section header name identifying the section as a dynamic string table.
`long`	`entry_size` Size of a fixed-size entry, 0 if none.
`static int`	`FLAG_ALLOC` Flag informing that section occupies memory during process execution.
`static int`	`FLAG_EXEC_INSTR` Flag informing that section contains executable machine instructions.
`static int`	`FLAG_MASK` Flag informing that all the bits in the mask are reserved for processor specific semantics.
`static int`	`FLAG_WRITE` Flag informing that this section contains data that should be writable during process execution.
`long`	`flags` Flags.
`int`	`info` Extra information determined by the section type.
`int`	`link` Section header table index link.
`int`	`name_ndx` Index into the section header string table which gives the name of the section.
`long`	`section_offset` Offset from beginning of file to first byte of the section.
`static int`	`SHT_DYNAMIC` Section holds information for dynamic linking.
`static int`	`SHT_DYNSYM` Section holds a minimum set of dynamic linking symbols.
`static int`	`SHT_FINI_ARRAY`
`static int`	`SHT_GNU_verdef`
`static int`	`SHT_GNU_verneed`
`static int`	`SHT_GNU_versym`
`static int`	`SHT_GROUP`
`static int`	`SHT_HASH` Section holds symbol hash table.
`static int`	`SHT_HIOS` Upper bound of the range of indexes reserved for operating system-specific semantics.
`static int`	`SHT_HIPROC` Upper bound of the range of indexes reserved for processor-specific semantics.
`static int`	`SHT_HIUSER` Upper bound of the range of indexes reserved for application programs.
`static int`	`SHT_INIT_ARRAY`
`static int`	`SHT_LOOS` Lower bound of the range of indexes reserved for operating system-specific semantics.
`static int`	`SHT_LOPROC` Lower bound of the range of indexes reserved for processor-specific semantics.
`static int`	`SHT_LOUSER` Lower bound of the range of indexes reserved for application programs.
`static int`	`SHT_NOBITS` Section occupies no space but resembles TYPE_PROGBITS.
`static int`	`SHT_NOTE` Section holds information that marks the file.
`static int`	`SHT_NULL` Marks the section header as inactive; it does not have an associated section.
`static int`	`SHT_PREINIT_ARRAY`
`static int`	`SHT_PROGBITS` Section holds information defined by the program.
`static int`	`SHT_REL` Section holds relocation entries without explicit addends.
`static int`	`SHT_RELA` Section holds relocation entries with explicit addends.
`static int`	`SHT_SHLIB` Section is reserved but has unspecified semantics.
`static int`	`SHT_STRTAB` Section holds string table information.
`static int`	`SHT_SYMTAB` Section holds symbol table information for link editing.
`static int`	`SHT_SYMTAB_SHNDX`
`long`	`size` Size in bytes of the section.
`static String`	`STRING_TABLE_NAME` Section header name identifying the section as a string table.
`int`	`type` Section content and semantics.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ElfDynamicStructure`	`getDynamicSection()`
`ElfRelocation`	`getELFRelocation(int index)` Returns the relocation at the specified index.
`ElfSymbol`	`getELFSymbol(int index)` Returns the symbol at the specified index.
`ElfSymbol`	`getELFSymbolByAddr(long addr)`
`ElfSymbol`	`getELFSymbolByName(String name)`
`net.fornwall.jelf.ElfHashTable`	`getHashTable()` Returns the hash table for this section or null if one does not exist.
`ElfInitArray`	`getInitArray()`
`String`	`getName()` Returns the name of the section or null if the section has no name.
`int`	`getNumberOfRelocations()` Returns the number of relocations in this section or 0 if none.
`int`	`getNumberOfSymbols()` Returns the number of symbols in this section or 0 if none.
`ElfInitArray`	`getPreInitArray()`
`net.fornwall.jelf.ElfStringTable`	`getStringTable()` Returns the string table for this section or null if one does not exist.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - SHT_NULL
```
public static final int SHT_NULL
```
    Marks the section header as inactive; it does not have an associated section. Other members of the section header have undefined values.
    
    See Also:
    
    Constant Field Values
  - SHT_PROGBITS
```
public static final int SHT_PROGBITS
```
    Section holds information defined by the program.
    
    See Also:
    
    Constant Field Values
  - SHT_SYMTAB
```
public static final int SHT_SYMTAB
```
    Section holds symbol table information for link editing. It may also be used to store symbols for dynamic linking. Only one per ELF file. The symtab contains everything, but it is non-allocable, can be stripped, and has no runtime cost.
    
    See Also:
    
    Constant Field Values
  - SHT_STRTAB
```
public static final int SHT_STRTAB
```
    Section holds string table information.
    
    See Also:
    
    Constant Field Values
  - SHT_RELA
```
public static final int SHT_RELA
```
    Section holds relocation entries with explicit addends.
    
    See Also:
    
    Constant Field Values
  - SHT_HASH
```
public static final int SHT_HASH
```
    Section holds symbol hash table.
    
    See Also:
    
    Constant Field Values
  - SHT_DYNAMIC
```
public static final int SHT_DYNAMIC
```
    Section holds information for dynamic linking. Only one per ELF file. The dynsym is allocable, and contains the symbols needed to support runtime operation.
    
    See Also:
    
    Constant Field Values
  - SHT_NOTE
```
public static final int SHT_NOTE
```
    Section holds information that marks the file.
    
    See Also:
    
    Constant Field Values
  - SHT_NOBITS
```
public static final int SHT_NOBITS
```
    Section occupies no space but resembles TYPE_PROGBITS.
    
    See Also:
    
    Constant Field Values
  - SHT_REL
```
public static final int SHT_REL
```
    Section holds relocation entries without explicit addends.
    
    See Also:
    
    Constant Field Values
  - SHT_SHLIB
```
public static final int SHT_SHLIB
```
    Section is reserved but has unspecified semantics.
    
    See Also:
    
    Constant Field Values
  - SHT_DYNSYM
```
public static final int SHT_DYNSYM
```
    Section holds a minimum set of dynamic linking symbols. Only one per ELF file.
    
    See Also:
    
    Constant Field Values
  - SHT_INIT_ARRAY
```
public static final int SHT_INIT_ARRAY
```
    See Also:
    
    Constant Field Values
  - SHT_FINI_ARRAY
```
public static final int SHT_FINI_ARRAY
```
    See Also:
    
    Constant Field Values
  - SHT_PREINIT_ARRAY
```
public static final int SHT_PREINIT_ARRAY
```
    See Also:
    
    Constant Field Values
  - SHT_GROUP
```
public static final int SHT_GROUP
```
    See Also:
    
    Constant Field Values
  - SHT_SYMTAB_SHNDX
```
public static final int SHT_SYMTAB_SHNDX
```
    See Also:
    
    Constant Field Values
  - SHT_GNU_verdef
```
public static final int SHT_GNU_verdef
```
    See Also:
    
    Constant Field Values
  - SHT_GNU_verneed
```
public static final int SHT_GNU_verneed
```
    See Also:
    
    Constant Field Values
  - SHT_GNU_versym
```
public static final int SHT_GNU_versym
```
    See Also:
    
    Constant Field Values
  - SHT_LOOS
```
public static final int SHT_LOOS
```
    Lower bound of the range of indexes reserved for operating system-specific semantics.
    
    See Also:
    
    Constant Field Values
  - SHT_HIOS
```
public static final int SHT_HIOS
```
    Upper bound of the range of indexes reserved for operating system-specific semantics.
    
    See Also:
    
    Constant Field Values
  - SHT_LOPROC
```
public static final int SHT_LOPROC
```
    Lower bound of the range of indexes reserved for processor-specific semantics.
    
    See Also:
    
    Constant Field Values
  - SHT_HIPROC
```
public static final int SHT_HIPROC
```
    Upper bound of the range of indexes reserved for processor-specific semantics.
    
    See Also:
    
    Constant Field Values
  - SHT_LOUSER
```
public static final int SHT_LOUSER
```
    Lower bound of the range of indexes reserved for application programs.
    
    See Also:
    
    Constant Field Values
  - SHT_HIUSER
```
public static final int SHT_HIUSER
```
    Upper bound of the range of indexes reserved for application programs.
    
    See Also:
    
    Constant Field Values
  - FLAG_WRITE
```
public static final int FLAG_WRITE
```
    Flag informing that this section contains data that should be writable during process execution.
    
    See Also:
    
    Constant Field Values
  - FLAG_ALLOC
```
public static final int FLAG_ALLOC
```
    Flag informing that section occupies memory during process execution.
    
    See Also:
    
    Constant Field Values
  - FLAG_EXEC_INSTR
```
public static final int FLAG_EXEC_INSTR
```
    Flag informing that section contains executable machine instructions.
    
    See Also:
    
    Constant Field Values
  - FLAG_MASK
```
public static final int FLAG_MASK
```
    Flag informing that all the bits in the mask are reserved for processor specific semantics.
    
    See Also:
    
    Constant Field Values
  - STRING_TABLE_NAME
```
public static final String STRING_TABLE_NAME
```
    Section header name identifying the section as a string table.
    
    See Also:
    
    Constant Field Values
  - DYNAMIC_STRING_TABLE_NAME
```
public static final String DYNAMIC_STRING_TABLE_NAME
```
    Section header name identifying the section as a dynamic string table.
    
    See Also:
    
    Constant Field Values
  - name_ndx
```
public final int name_ndx
```
    Index into the section header string table which gives the name of the section.
  - type
```
public final int type
```
    Section content and semantics.
  - flags
```
public final long flags
```
    Flags.
  - address
```
public final long address
```
    sh_addr. If the section will be in the memory image of a process this will be the address at which the first byte of section will be loaded. Otherwise, this value is 0.
  - section_offset
```
public final long section_offset
```
    Offset from beginning of file to first byte of the section.
  - size
```
public final long size
```
    Size in bytes of the section. TYPE_NOBITS is a special case.
  - link
```
public final int link
```
    Section header table index link.
  - info
```
public final int info
```
    Extra information determined by the section type.
  - address_alignment
```
public final long address_alignment
```
    Address alignment constraints for the section.
  - entry_size
```
public final long entry_size
```
    Size of a fixed-size entry, 0 if none.
- Method Detail
  - getInitArray
```
public ElfInitArray getInitArray()
                          throws IOException
```
    Throws:
    
    IOException
  - getPreInitArray
```
public ElfInitArray getPreInitArray()
                             throws IOException
```
    Throws:
    
    IOException
  - getNumberOfSymbols
```
public int getNumberOfSymbols()
```
    Returns the number of symbols in this section or 0 if none.
  - getELFSymbol
```
public ElfSymbol getELFSymbol(int index)
                       throws IOException
```
    Returns the symbol at the specified index. The ELF symbol at index 0 is the undefined symbol.
    
    Specified by:
    
    getELFSymbol in interface SymbolLocator
    
    Throws:
    
    IOException
  - getELFSymbolByName
```
public ElfSymbol getELFSymbolByName(String name)
                             throws IOException
```
    Specified by:
    
    getELFSymbolByName in interface SymbolLocator
    
    Throws:
    
    IOException
  - getELFSymbolByAddr
```
public ElfSymbol getELFSymbolByAddr(long addr)
                             throws IOException
```
    Specified by:
    
    getELFSymbolByAddr in interface SymbolLocator
    
    Throws:
    
    IOException
  - getNumberOfRelocations
```
public int getNumberOfRelocations()
```
    Returns the number of relocations in this section or 0 if none.
  - getELFRelocation
```
public ElfRelocation getELFRelocation(int index)
                               throws IOException
```
    Returns the relocation at the specified index.
    
    Throws:
    
    IOException
  - getStringTable
```
public net.fornwall.jelf.ElfStringTable getStringTable()
                                                throws IOException
```
    Returns the string table for this section or null if one does not exist.
    
    Throws:
    
    IOException
  - getDynamicSection
```
public ElfDynamicStructure getDynamicSection()
                                      throws IOException
```
    Throws:
    
    IOException
  - getHashTable
```
public net.fornwall.jelf.ElfHashTable getHashTable()
                                            throws IOException
```
    Returns the hash table for this section or null if one does not exist. NOTE: currently the ELFHashTable does not work and this method will always return null.
    
    Throws:
    
    IOException
  - getName
```
public String getName()
               throws IOException
```
    Returns the name of the section or null if the section has no name.
    
    Throws:
    
    IOException
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class ElfSection

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SHT_NULL

SHT_PROGBITS

SHT_SYMTAB

SHT_STRTAB

SHT_RELA

SHT_HASH

SHT_DYNAMIC

SHT_NOTE

SHT_NOBITS

SHT_REL

SHT_SHLIB

SHT_DYNSYM

SHT_INIT_ARRAY

SHT_FINI_ARRAY

SHT_PREINIT_ARRAY

SHT_GROUP

SHT_SYMTAB_SHNDX

SHT_GNU_verdef

SHT_GNU_verneed

SHT_GNU_versym

SHT_LOOS

SHT_HIOS

SHT_LOPROC

SHT_HIPROC

SHT_LOUSER

SHT_HIUSER

FLAG_WRITE

FLAG_ALLOC

FLAG_EXEC_INSTR

FLAG_MASK

STRING_TABLE_NAME

DYNAMIC_STRING_TABLE_NAME

name_ndx

type

flags

address

section_offset

size

link

info

address_alignment

entry_size

Method Detail

getInitArray

getPreInitArray

getNumberOfSymbols

getELFSymbol

getELFSymbolByName

getELFSymbolByAddr

getNumberOfRelocations

getELFRelocation

getStringTable

getDynamicSection

getHashTable

getName

toString