com.oracle.objectfile.elf

Class ELFObjectFile.SectionHeaderTable

java.lang.Object

com.oracle.objectfile.ObjectFile.Element

com.oracle.objectfile.elf.ELFObjectFile.SectionHeaderTable

All Implemented Interfaces:

ElementImpl

Enclosing class:

ELFObjectFile

public class ELFObjectFile.SectionHeaderTable
extends ObjectFile.Element

ELF's section header table (SHT) is an element which indexes and summarises the contents of the file. The SHT comes with a string table of its own, which is stored in an extra section called .shstrtab in the binary. We generate .shstrtab StringTable in this implementation.

Constructor Summary

Constructors

Constructor and Description
SectionHeaderTable() Logically create an empty SectionHeaderTable.

Method Summary

Modifier and Type	Method and Description
LayoutDecisionMap	getDecisions(LayoutDecisionMap copyingIn)
Iterable<BuildDependency>	getDependencies(Map<ObjectFile.Element,LayoutDecisionMap> decisions) Implementing this method allows to declare dependencies to other Sections (i.e.
ElementImpl	getImpl()
byte[]	getOrDecideContent(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided, byte[] contentHint) Implement this method to deliver the content of the section.
int	getOrDecideOffset(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided, int offsetHint) Implement this method to provide the offset this section should be placed at.
int	getOrDecideSize(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided, int sizeHint) Implement this method to provide the size of this section.
int	getOrDecideVaddr(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided, int vaddrHint) Implement this method to provide the virtual address of this section.
boolean	isLoadable() Returns whether or not this section will be mapped into memory.
void	write(OutputAssembler out, Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided)

Methods inherited from class com.oracle.objectfile.ObjectFile.Element

getAlignment, getElement, getElementName, getMemSize, getName, getOwner, isReferenceable, setElement, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SectionHeaderTable

public SectionHeaderTable()

Logically create an empty SectionHeaderTable. This is a no-op, except to add an Element to the enclosing ObjectFile.

Method Detail

getImpl

public ElementImpl getImpl()

Specified by:

getImpl in class ObjectFile.Element

isLoadable

public boolean isLoadable()

Description copied from class: ObjectFile.Element

Returns whether or not this section will be mapped into memory. This affects how offsets and/or vaddrs are decided.

Specified by:

isLoadable in interface ElementImpl

Specified by:

isLoadable in class ObjectFile.Element

getDependencies

public Iterable<BuildDependency> getDependencies(Map<ObjectFile.Element,LayoutDecisionMap> decisions)

Description copied from interface: ElementImpl

Implementing this method allows to declare dependencies to other Sections (i.e. information about other sections needed to construct this section). The information will be used to construct the buildOrder in ObjectFile.writeInternal(). A good example can be found at: ELFObjectFile.ProgramHeaderTable.getDependencies

getOrDecideSize

public int getOrDecideSize(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided,
                           int sizeHint)

Description copied from interface: ElementImpl

Implement this method to provide the size of this section.

getOrDecideContent

public byte[] getOrDecideContent(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided,
                                 byte[] contentHint)

Description copied from interface: ElementImpl

Implement this method to deliver the content of the section.

getDecisions

public LayoutDecisionMap getDecisions(LayoutDecisionMap copyingIn)

Specified by:

getDecisions in interface ElementImpl

Specified by:

getDecisions in class ObjectFile.Element

getOrDecideOffset

public int getOrDecideOffset(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided,
                             int offsetHint)

Description copied from interface: ElementImpl

Implement this method to provide the offset this section should be placed at.

getOrDecideVaddr

public int getOrDecideVaddr(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided,
                            int vaddrHint)

Description copied from interface: ElementImpl

Implement this method to provide the virtual address of this section. For loadable sections, this is where the section is expected to be mapped to at runtime (see ElementImpl.isLoadable()).

write

public void write(OutputAssembler out,
                  Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided)