com.oracle.svm.hosted.image

Class NativeImage

java.lang.Object

com.oracle.svm.hosted.image.AbstractImage

com.oracle.svm.hosted.image.NativeImage

Direct Known Subclasses:

NativeImageViaCC

public abstract class NativeImage
extends AbstractImage

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NativeImage.NativeTextSectionImpl

Nested classes/interfaces inherited from class com.oracle.svm.hosted.image.AbstractImage

AbstractImage.NativeImageKind

Field Summary

Fields

Modifier and Type	Field and Description
static long	RWDATA_CGLOBALS_PARTITION_OFFSET

Fields inherited from class com.oracle.svm.hosted.image.AbstractImage

codeCache, entryPoints, heap, imageClassLoader, imageKind, metaAccess, nativeLibs, resultingImageSize, universe

Constructor Summary

Constructors

Constructor and Description
NativeImage(AbstractImage.NativeImageKind k, HostedUniverse universe, HostedMetaAccess metaAccess, NativeLibraries nativeLibs, NativeImageHeap heap, NativeImageCodeCache codeCache, List<HostedMethod> entryPoints, ClassLoader imageClassLoader)

Method Summary

Modifier and Type	Method and Description
void	build(String imageName, org.graalvm.compiler.debug.DebugContext debug) Create the image sections for code, constants, and the heap.
com.oracle.objectfile.ObjectFile	getOrCreateDebugObjectFile()
com.oracle.objectfile.ObjectFile.Section	getTextSection() Returns the ObjectFile.Section within the image, if any, whose vaddr defines the image's base vaddr.
static String	globalSymbolNameForMethod(Method m) Given a java.lang.reflect.Method, compute the symbol name of its entry point (if any) in the image.
static String	globalSymbolNameForMethod(jdk.vm.ci.meta.ResolvedJavaMethod sm) Given a ResolvedJavaMethod, compute what symbol name of its entry point (if any) in the image.
static String	localSymbolNameForMethod(Method m) Given a java.lang.reflect.Method, compute the symbol name of its start address (if any) in the image.
static String	localSymbolNameForMethod(jdk.vm.ci.meta.ResolvedJavaMethod sm) Given a ResolvedJavaMethod, compute what symbol name of its start address (if any) in the image.
abstract String[]	makeLaunchCommand(AbstractImage.NativeImageKind k, String imageName, Path binPath, Path workPath, Method method)
protected void	write(org.graalvm.compiler.debug.DebugContext context, Path outputFile)

Methods inherited from class com.oracle.svm.hosted.image.AbstractImage

create, getCodeCache, getHeap, getImageKind, getImageSize, getNativeLibs, requiresCustomDebugRelocation, write

Methods inherited from class java.lang.Object

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

Field Detail

RWDATA_CGLOBALS_PARTITION_OFFSET

public static final long RWDATA_CGLOBALS_PARTITION_OFFSET

See Also:

Constant Field Values

Constructor Detail

NativeImage

public NativeImage(AbstractImage.NativeImageKind k,
                   HostedUniverse universe,
                   HostedMetaAccess metaAccess,
                   NativeLibraries nativeLibs,
                   NativeImageHeap heap,
                   NativeImageCodeCache codeCache,
                   List<HostedMethod> entryPoints,
                   ClassLoader imageClassLoader)

Method Detail

getTextSection

public com.oracle.objectfile.ObjectFile.Section getTextSection()

Description copied from class: AbstractImage

Returns the ObjectFile.Section within the image, if any, whose vaddr defines the image's base vaddr.

Specified by:

getTextSection in class AbstractImage

makeLaunchCommand

public abstract String[] makeLaunchCommand(AbstractImage.NativeImageKind k,
                                           String imageName,
                                           Path binPath,
                                           Path workPath,
                                           Method method)

Specified by:

makeLaunchCommand in class AbstractImage

write

protected final void write(org.graalvm.compiler.debug.DebugContext context,
                           Path outputFile)

build

public void build(String imageName,
                  org.graalvm.compiler.debug.DebugContext debug)

Create the image sections for code, constants, and the heap.

Specified by:

build in class AbstractImage

localSymbolNameForMethod

public static String localSymbolNameForMethod(Method m)

Given a java.lang.reflect.Method, compute the symbol name of its start address (if any) in the image. The symbol name returned is the one that would be used for local references (e.g. for relocation), so is guaranteed to exist if the method is in the image. However, it is not necessarily visible for linking from other objects.

Parameters:

m - a java.lang.reflect.Method

Returns:

its symbol name as it would appear in the image (regardless of whether it actually does)

localSymbolNameForMethod

public static String localSymbolNameForMethod(jdk.vm.ci.meta.ResolvedJavaMethod sm)

Given a ResolvedJavaMethod, compute what symbol name of its start address (if any) in the image. The symbol name returned is the one that would be used for local references (e.g. for relocation), so is guaranteed to exist if the method is in the image. However, it is not necessarily visible for linking from other objects.

Parameters:

sm - a SubstrateMethod

Returns:

its symbol name as it would appear in the image (regardless of whether it actually does)

globalSymbolNameForMethod

public static String globalSymbolNameForMethod(Method m)

Given a java.lang.reflect.Method, compute the symbol name of its entry point (if any) in the image. The symbol name returned is one that would be used for external references (e.g. for linking) and for method lookup by signature. If multiple methods with the same signature are present in the image, the returned symbol name is not guaranteed to resolve to the method being passed.

Parameters:

m - a java.lang.reflect.Method

Returns:

its symbol name as it would appear in the image (regardless of whether it actually does)

globalSymbolNameForMethod

public static String globalSymbolNameForMethod(jdk.vm.ci.meta.ResolvedJavaMethod sm)

Given a ResolvedJavaMethod, compute what symbol name of its entry point (if any) in the image. The symbol name returned is one that would be used for external references (e.g. for linking) and for method lookup by signature. If multiple methods with the same signature are present in the image, the returned symbol name is not guaranteed to resolve to the method being passed.

Parameters:

sm - a SubstrateMethod

Returns:

its symbol name as it would appear in the image (regardless of whether it actually does)

getOrCreateDebugObjectFile

public com.oracle.objectfile.ObjectFile getOrCreateDebugObjectFile()

Specified by:

getOrCreateDebugObjectFile in class AbstractImage