Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marcin-chwedczuk/elf-viewer
Use Elf Viewer to see structure of ELF files. This is a GUI replacement for Linux readelf command. The main audience of this program are people learning about ELF file format and university students attending compsec courses.
https://github.com/marcin-chwedczuk/elf-viewer
elf-binaries elf-parser elf-viewer
Last synced: about 2 months ago
JSON representation
Use Elf Viewer to see structure of ELF files. This is a GUI replacement for Linux readelf command. The main audience of this program are people learning about ELF file format and university students attending compsec courses.
- Host: GitHub
- URL: https://github.com/marcin-chwedczuk/elf-viewer
- Owner: marcin-chwedczuk
- License: mit
- Created: 2021-11-09T07:45:52.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-06T13:14:07.000Z (over 1 year ago)
- Last Synced: 2024-05-10T22:06:32.128Z (8 months ago)
- Topics: elf-binaries, elf-parser, elf-viewer
- Language: Java
- Homepage:
- Size: 8.19 MB
- Stars: 6
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Elf Viewer
:warning: PROJECT IS USABLE, BUT STILL UNDER CONSTRUCTION :warning:
Current status:
* Covers about 80% of all ELF structures.
What is left are mostly GNU specific extensions and relocations.
* GUI still needs a bit of polishing.
Tested on `libc` for x86, x86_64 and arm64 architectures. Solaris is not supported.
Right now I am playing with the API and I try to figure out the most
intuitive and Javaish API for dealing with ELFs.
Rest of the README comes from the standard template:
---
* Created for JDK 11+, with Java 9 modules support
* Multi-module Maven project by default
* Sass used instead of CSS
* assertJ and jUnit 5 used for unit testing
* TestFX used for integration testing
* Example GitHub action that builds the project and runs integration tests in headless mode
### How to run application
```
./mvnw javafx:run -pl gui
```
### How to rebuild `.css` files from `.scss`
```
./mvnw nl.geodienstencentrum.maven:sass-maven-plugin:update-stylesheets -pl gui
```
### How to watch for SCSS changes and regenerate them when they change
```
fswatch --exclude='.*' --include='.*[.]scss$' --print0 . | while read -d "" event; do
./mvnw nl.geodienstencentrum.maven:sass-maven-plugin:update-stylesheets -pl gui
done
```
You need to install `fswatch` command for this to work.
### How to generate `jlink` image
```
./mvnw javafx:jlink -pl gui
```
You can now send `./gui/target/gui.zip` to your friends :tada:
### How to run integration tests (TestFX)
```
./mvnw verify -Dskip.integration.tests=false -Dskip.unit.tests=true
```
### How to run single integration test
```
./mvnw clean verify -Dskip.integration.tests=false -Dskip.unit.tests=true \
-pl gui -Dit.test=MainWindowIT
```
### How to run integration tests in the headless mode
```
_JAVA_OPTIONS="-Djava.awt.headless=true \
-Dtestfx.robot=glass \
-Dtestfx.headless=true \
-Dprism.order=sw \
-Dprism.verbose=true" ./mvnw verify -Dskip.integration.tests=false -pl gui
```
On macOS you must allow IntelliJ or the terminal app that you are using,
to "take over your computer":
