com.oracle.objectfile

Class BasicElementImpl

java.lang.Object

com.oracle.objectfile.BasicElementImpl

All Implemented Interfaces:

ElementImpl

Direct Known Subclasses:

BasicNobitsSectionImpl, BasicProgbitsSectionImpl, StringSectionImpl

public abstract class BasicElementImpl
extends Object
implements ElementImpl

Constructor Summary

Constructors

Constructor and Description
BasicElementImpl() Sometimes the element cannot be constructed until the Impl is available (e.g.
BasicElementImpl(ObjectFile.Element element)

Method Summary

Modifier and Type	Method and Description
int	getAlignment()
LayoutDecisionMap	getDecisions(LayoutDecisionMap copyingIn)
Iterable<BuildDependency>	getDependencies(Map<ObjectFile.Element,LayoutDecisionMap> decisions) Implementing this method allows to declare dependencies to other Sections (i.e.
ObjectFile.Element	getElement()
int	getMemSize(Map<ObjectFile.Element,LayoutDecisionMap> alreadyDecided) Implement this method to provide the section size in memory (at runtime).
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.
ObjectFile	getOwner()
boolean	isReferenceable() Locations in this section are referenceable by symbol names, section names, or by relocation, so the section needs a virtual address.
void	setElement(ObjectFile.Element element)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.objectfile.ElementImpl

getOrDecideContent, isLoadable

Constructor Detail

BasicElementImpl

public BasicElementImpl(ObjectFile.Element element)

BasicElementImpl

public BasicElementImpl()

Sometimes the element cannot be constructed until the Impl is available (e.g. when using ObjectFile.newUserDefinedSection()). If you use this constructor, you must called setElement before using any other methods.

Method Detail

setElement

public void setElement(ObjectFile.Element element)

Specified by:

setElement in interface ElementImpl

getOwner

public ObjectFile getOwner()

getElement

public ObjectFile.Element getElement()

Specified by:

getElement in interface ElementImpl

getAlignment

public int getAlignment()

Specified by:

getAlignment in interface ElementImpl

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

Specified by:

getDependencies in interface ElementImpl

getDecisions

public LayoutDecisionMap getDecisions(LayoutDecisionMap copyingIn)

Specified by:

getDecisions in interface ElementImpl

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.

Specified by:

getOrDecideOffset in interface ElementImpl

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.

Specified by:

getOrDecideSize in interface ElementImpl

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()).

Specified by:

getOrDecideVaddr in interface ElementImpl

getMemSize

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

Description copied from interface: ElementImpl

Implement this method to provide the section size in memory (at runtime).

Specified by:

getMemSize in interface ElementImpl

isReferenceable

public boolean isReferenceable()

Description copied from interface: ElementImpl

Locations in this section are referenceable by symbol names, section names, or by relocation, so the section needs a virtual address. Generally applies to loadable sections, but can also be used to enable references into sections that are not loadable, such as debug sections.

Specified by:

isReferenceable in interface ElementImpl