20 个稳定版本
2.0.1 | 2022年11月11日 |
---|---|
2.0.0 | 2022年10月27日 |
1.6.11 | 2021年12月5日 |
1.6.4 | 2021年7月25日 |
0.1.0 | 2020年11月4日 |
#211 在 操作系统 中
82 每月下载量
195KB
1.5K SLoC
KDump
KDump 是一个程序,允许任何有命令行的人查看 KerboScript Machine 代码 (KSM) 文件和 KerbalObject (KO) 文件的内容,以查看用于 Kerbal 操作系统的编译代码。KO 和 KSM 文件完全受支持。
KDump 是 kOS 相当于 ELF 的 objdump 或 readelf 程序。
功能
- 彩色终端输出
- 人类可读的文本
- 在反汇编旁边显示调试行号
安装
KDump 可以通过 cargo 通过 crates.io 安装,也可以作为独立的二进制文件安装。
Windows
- 从右侧的版本中下载安装程序 .msi 文件
- 运行安装程序
- kdump 现在应该添加到您的 PATH 中,并在任何 CMD 或 PowerShell 窗口中可用
Arch Linux
-
从右侧的版本中下载 PKGBUILD
-
将其复制到临时文件夹中
-
运行
makepkg -si
以安装 kdump 及其所有依赖项。 -
kdump 现在应该添加到您的 PATH 中,并在任何终端中可用
独立可执行文件
- 从右侧的版本中下载并解压缩 .zip 文件
- 将可执行文件放置在所需位置
- 通过终端、Windows 上的 PowerShell 或 Mac OS 或 Linux 的默认终端运行可执行文件。
Cargo
要使用 cargo 安装
cargo install kdump
kdump
然后应添加到您的 shell 的 PATH 中,并可以从任何终端运行
用法
安装后,可以使用 kdump
调用 KDump
可以通过运行以下命令从程序本身访问帮助
kdump --help
KDump 接受一个 .ko 或 .ksm 文件作为输入
kdump program.ksm
但是默认模式是不打印任何内容。需要指定打印选项。
大多数情况下,最有用但占用空间最大的方法是查看文件的完整内容。这可以通过使用 -x 或 --full-contents 标志来指定
kdump program.ksm --full-contents
如果只是关注函数段的反汇编,则只需使用 -D 或 --disassemble 标志
kdump lib.ko -D
当调试编译的 KerboScript 文件时,调试信息存储在 KSM 文件中,KDump 可以读取并显示这些信息。行号显示在反汇编的左侧,可以使用 -l 或 --line-numbers 标志来启用
kdump launch.ksm -Dl
如果文件是使用 Kerbal Linker 或类似程序生成的,则可能包含有关用于生成 KerbalObject 和 KSM 文件的工具的信息,这可以通过传递 -i 或 --info 标志来查看
kdump script.ksm -i
依赖关系
~1.8–9.5MB
~79K SLoC