source_viewer 0.1.1

A CLI tool to inspect and analyze binary sources using DWARF debugging information.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# SourceViewer
assembly viewing tool (this was a pet project but i found myself actually reaching for it so here i am publishing)

the goal is to allow viewing dissasmblies from the perspective of the source file without taking over your compilation setup.

a typical workload would look something like 
```bash
	SourceViewer view_source sample_code/build/linux_x86_64

	Source files:
	0: "/snap/zig/11625/lib/libc/glibc/csu/elf-init-2.33.c"
	1: "/home/user/Desktop/rust_stuff/SourceViewer/sample_code/get_time.c"
	2: "/snap/zig/11625/lib/libc/glibc/sysdeps/x86_64/crtn.S"
	3: "/snap/zig/11625/lib/libc/glibc/sysdeps/x86_64/crti.S"
	4: "/snap/zig/11625/lib/libc/glibc/sysdeps/x86_64/start-2.33.S"

	SourceViewer view_source sample_code/build/linux_x86_64 -w 0

```
here we looked at the files that composed our binary and then went into the first file to view its contributions


# TODO 
1. symbol resolution: find the jump instructions and switch pointers with the names of the target
2. interactive view

# Tests
a very good test case is runing 
```bash
cargo run walk target/debug/SourceViewer
```

is a very good way to see where we are at. if you are anoyyed by the delay on the load then using release mode should solve most the issue.

# Issues
currently we cant run detail=true because that removes some instructions from the end...
however without it we cant check for whether or not an instruction is a jump.
kind of puts us in a tricky position we will see what to do here

# Platforms
its becoming ridiclously hard to get correct dwarf info on windows and mac files.
for the life of me I cant bother. so for now i am building only for linux but the parsing on other platforms is there.
if you manage to get a valid dwarf format on windows or mac the program should support it