keystone

类 Keystone

java.lang.Object

keystone.Keystone

所有已实现的接口:

AutoCloseable

public class Keystone
extends Object
implements AutoCloseable

The Keystone engine.

构造器概要

构造器

构造器和说明
Keystone(KeystoneArchitecture architecture, KeystoneMode mode) Initializes a new instance of the class Keystone.

方法概要

限定符和类型	方法和说明
KeystoneEncoded	assemble(Iterable<String> assembly) Assembles a string that contains assembly code.
KeystoneEncoded	assemble(Iterable<String> assembly, int address) Assembles a string that contains assembly code, located at a given address location.
KeystoneEncoded	assemble(String assembly) Assembles a string that contains assembly code.
KeystoneEncoded	assemble(String assembly, int address) Assembles a string that contains assembly code, located at a given address location.
void	close() Closes this resource, relinquishing any underlying resources.
static boolean	isArchitectureSupported(KeystoneArchitecture architecture) Determines whether the given architecture is supported by Keystone.
void	setAssemblySyntax(KeystoneOptionValue.KeystoneOptionSyntax syntax) Sets the syntax of the assembly code used in this instance of Keystone.
void	setOption(KeystoneOptionType type, int value) Sets an option for Keystone engine at runtime using a not-strongly typed option value.
void	setSymbolResolver(SymbolResolverCallback callback) Sets a symbol resolver callback, to resolve unrecognized symbols encountered in the assembly code.
void	unsetSymbolResolver() Unsets the current symbol resolver.
Version	version() Gets the major and minor version numbers.

从类继承的方法 java.lang.Object

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

构造器详细资料

Keystone

public Keystone(KeystoneArchitecture architecture,
                KeystoneMode mode)

Initializes a new instance of the class Keystone.

Some architectures are not supported. Use the static method isArchitectureSupported(keystone.KeystoneArchitecture) to determine whether the engine support the architecture.

参数:

architecture - The architecture of the code generated by Keystone.

mode - The mode type.

抛出:

OpenFailedKeystoneException - if the Keystone library cannot be opened properly.

方法详细资料

isArchitectureSupported

public static boolean isArchitectureSupported(KeystoneArchitecture architecture)

Determines whether the given architecture is supported by Keystone.

参数:

architecture - The architecture type to check.

返回:

The return value is true if the architecture is supported, otherwise false.

assemble

public KeystoneEncoded assemble(String assembly)

Assembles a string that contains assembly code.

参数:

assembly - The assembly instructions. Use ; or \n to separate statements.

返回:

The return value is the machine code of the assembly instructions.

抛出:

AssembleFailedKeystoneException - if the assembly code cannot be assembled properly.

assemble

public KeystoneEncoded assemble(String assembly,
                                int address)

Assembles a string that contains assembly code, located at a given address location.

参数:

assembly - The assembly instructions. Use ; or \n to separate statements.

address - The address of the first assembly instruction.

返回:

The return value is the machine code of the assembly instructions.

抛出:

AssembleFailedKeystoneException - if the assembly code cannot be assembled properly.

assemble

public KeystoneEncoded assemble(Iterable<String> assembly)

Assembles a string that contains assembly code.

参数:

assembly - A collection of assembly instructions.

返回:

The return value is the machine code of the assembly instructions.

抛出:

AssembleFailedKeystoneException - if the assembly code cannot be assembled properly.

assemble

public KeystoneEncoded assemble(Iterable<String> assembly,
                                int address)

Assembles a string that contains assembly code, located at a given address location.

参数:

assembly - A collection of assembly instructions.

address - The address of the first assembly instruction.

返回:

The return value is the machine code of the assembly instructions.

抛出:

AssembleFailedKeystoneException - if the assembly code cannot be assembled properly.

version

public Version version()

Gets the major and minor version numbers.

返回:

The returned value is an instance of the class Version, containing the major and minor version numbers.

setAssemblySyntax

public void setAssemblySyntax(KeystoneOptionValue.KeystoneOptionSyntax syntax)

Sets the syntax of the assembly code used in this instance of Keystone.

参数:

syntax - The syntax of the assembly code.

抛出:

SetOptionFailedKeystoneException - if the syntax is not supported.

SetOptionFailedKeystoneException - if the pair of type and value is not valid.

setOption

public void setOption(KeystoneOptionType type,
                      int value)

Sets an option for Keystone engine at runtime using a not-strongly typed option value.

It is suggested to prefer the methods setAssemblySyntax(KeystoneOptionValue.KeystoneOptionSyntax), setSymbolResolver(SymbolResolverCallback) or unsetSymbolResolver().

参数:

type - The type of the option.

value - The value of the option.

抛出:

SetOptionFailedKeystoneException - if the pair of type and value is not valid.

setSymbolResolver

public void setSymbolResolver(SymbolResolverCallback callback)

Sets a symbol resolver callback, to resolve unrecognized symbols encountered in the assembly code.

If the method is called many times, only the last callback will be triggered.

参数:

callback - The symbol resolver callback.

抛出:

SetOptionFailedKeystoneException - if the pair of type and value is not valid.

unsetSymbolResolver

public void unsetSymbolResolver()

Unsets the current symbol resolver. The symbol resolver instance can be freely collected afterwards.

抛出:

SetOptionFailedKeystoneException - if the pair of type and value is not valid.

close

public void close()

Closes this resource, relinquishing any underlying resources. This method is invoked automatically on objects managed by the try-with-resources statement.

The call to this method is thread-safe.

指定者:

close 在接口中 AutoCloseable