Executables
0.1.12indexedLibrary for executable/object files parsing (include PE version info, virtual memory), in Kotlin multiplatform.
Library for executable/object files parsing (include PE version info, virtual memory), in Kotlin multiplatform.
An executable file parsing library, written in Kotlin Multiplatform.
Currently, this library can:
| PE | ELF | Mach-O | |
|---|---|---|---|
| Read headers | ✅ | ✅ | ✅ |
| Read import/export symbols | ✅ | ✅ | 🚧 |
| Read sections | ✅ | ✅ | ✅ |
| Read resources | ✅ | N/A | N/A |
| Reading in VA | ✅ | ✅ | ✅ |
This project is currently in the early stages of development. This means it is still evolving and may undergo frequent updates and changes.
Due to the current status of Kotlin/Multiplatform, it can be expected that for a period of time following the stable release, binary compatibility guarantees will only be provided for Kotlin/JVM.
All targets supported.
For someone who doesn't want to read the documentation
import space.iseki.executables.common.FileFormat
fun main(vararg args: String) {
FileFormat.open(args[0])?.use { file ->
println(file)
// do what you want to do
}
}
This project contains several modules on Maven Central:
dependencies {
implementation("space.iseki.executables:executables-files:0.1.12")
}
Since the project is in Kotlin Multiplatform, for Maven user you have to specify the platform explicitly.
(The -jvm suffix)
<dependency>
<groupId>space.iseki.executables</groupId>
<artifactId>executables-files-jvm</artifactId>
<version>0.1.12</version>
</dependency>
import java.nio.file.Path
import kotlinx.serialization.json.Json
import space.iseki.executables.pe.PEFile
fun main() {
val file = Path.of("C:\\System32\\notepad.exe")
PEFile.open(file).use { peFile: PEFile ->
println(peFile.coffHeader)
println(peFile.summary)
println(Json.encodeToString(peFile.summary))
println(peFile.versionInfo)
}
}
import java.nio.file.Path
import space.iseki.executables.common.FileFormat
fun main() {
val file = Path.of("C:\\System32\\notepad.exe")
println(FileFormat.detect(file))
}
This API also works for ELF files.
import java.nio.file.Path
import space.iseki.executables.pe.PEFile
fun main() {
val file = Path.of("C:\\System32\\notepad.exe")
PEFile.open(file).use { peFile ->
// Get all imported DLLs and functions
peFile.importSymbols.forEach { symbol ->
println("Imported: ${symbol.file}::${symbol.name}")
(symbol.isOrdinal) {
println()
}
}
}
}
This API also works for ELF files.
import java.nio.file.Path
import space.iseki.executables.pe.PEFile
fun main {
file = Path.of()
PEFile.(file).use { peFile ->
exportSymbols = peFile.exportSymbols
println()
exportSymbols.take().forEach { symbol ->
println()
(symbol.isForwarder) {
println()
}
}
}
}
Since PE splits the symbol table into import/export, this API is ELF specified.
import java.nio.file.Path
import space.iseki.executables.elf.ELFFile
fun main() {
val file = Path.of("/bin/ls") // ELF file on Linux system
ELFFile.open(file).use { elfFile ->
// Get all symbols
elfFile.symbols.forEach { symbol ->
val name = symbol.name ?: "<unnamed>"
println()
}
}
}
Surfaced from shared tags and platforms — no rankings paid for.