aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Cargo.lock134
-rw-r--r--Cargo.toml17
-rw-r--r--LICENSE12
-rw-r--r--README.md23
-rw-r--r--src/main.rs30
5 files changed, 99 insertions, 117 deletions
diff --git a/Cargo.lock b/Cargo.lock
index 31888f2..420e2be 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -48,17 +48,6 @@ dependencies = [
]
[[package]]
-name = "derivative"
-version = "1.0.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "942ca430eef7a3806595a6737bc388bf51adb888d3fc0dd1b50f1c170167ee3a"
-dependencies = [
- "proc-macro2 0.4.30",
- "quote 0.6.13",
- "syn 0.15.44",
-]
-
-[[package]]
name = "hermit-abi"
version = "0.1.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -74,12 +63,6 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "023b39be39e3a2da62a94feb433e91e8bcd37676fbc8bea371daf52b7a769a3e"
[[package]]
-name = "itoa"
-version = "0.4.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "501266b7edd0174f8530248f87f99c88fbe60ca4ef3dd486835b8d8d53136f7f"
-
-[[package]]
name = "libc"
version = "0.2.66"
source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -96,24 +79,13 @@ dependencies = [
[[package]]
name = "num_enum"
-version = "0.4.2"
+version = "0.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be601e38e20a6f3d01049d85801cb9b7a34a8da7a0da70df507bbde7735058c8"
+checksum = "fae2a63210048cf77ceb6031b3f87ac69e4a68cfaacb17a0261e141c4bc8467b"
dependencies = [
- "derivative",
- "num_enum_derive",
-]
-
-[[package]]
-name = "num_enum_derive"
-version = "0.4.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b59f30f6a043f2606adbd0addbf1eef6f2e28e8c4968918b63b7ff97ac0db2a7"
-dependencies = [
- "proc-macro-crate",
- "proc-macro2 1.0.7",
- "quote 1.0.2",
- "syn 1.0.13",
+ "proc-macro2 0.4.30",
+ "quote 0.6.13",
+ "syn 0.15.44",
]
[[package]]
@@ -123,15 +95,6 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b8f8bdf33df195859076e54ab11ee78a1b208382d3a26ec40d142ffc1ecc49ef"
[[package]]
-name = "proc-macro-crate"
-version = "0.1.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e10d4b51f154c8a7fb96fd6dad097cb74b863943ec010ac94b9fd1be8861fe1e"
-dependencies = [
- "toml",
-]
-
-[[package]]
name = "proc-macro2"
version = "0.4.30"
source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -183,12 +146,6 @@ dependencies = [
]
[[package]]
-name = "ryu"
-version = "1.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bfa8506c1de11c9c4e4c38863ccbe02a305c8188e85a05a784c9e11e1c3910c8"
-
-[[package]]
name = "serde"
version = "1.0.104"
source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -206,17 +163,6 @@ dependencies = [
]
[[package]]
-name = "serde_json"
-version = "1.0.44"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "48c575e0cc52bdd09b47f330f646cf59afc586e9c4e3ccd6fc1f625b8ea1dad7"
-dependencies = [
- "itoa",
- "ryu",
- "serde",
-]
-
-[[package]]
name = "strsim"
version = "0.8.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -266,15 +212,6 @@ dependencies = [
]
[[package]]
-name = "toml"
-version = "0.5.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "01d1404644c8b12b16bfcffa4322403a91a451584daaaa7c28d3152e6cbc98cf"
-dependencies = [
- "serde",
-]
-
-[[package]]
name = "unicode-width"
version = "0.1.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -322,7 +259,9 @@ checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
[[package]]
name = "yaxpeax-arch"
-version = "0.0.1"
+version = "0.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab52e5031be876437d8db20de2074486ce6a49e3a0809a8e8b291a307ea808a2"
dependencies = [
"num-traits",
"serde",
@@ -331,7 +270,9 @@ dependencies = [
[[package]]
name = "yaxpeax-arm"
-version = "0.0.1"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d7b631720783f1ea2eeddf0de1643c5c90a2777921816294db8fd876ccd53dc"
dependencies = [
"serde",
"serde_derive",
@@ -347,71 +288,74 @@ dependencies = [
"num-traits",
"yaxpeax-arch",
"yaxpeax-arm",
+ "yaxpeax-m16c",
"yaxpeax-mips",
- "yaxpeax-msp430-mc",
+ "yaxpeax-msp430",
"yaxpeax-pic17",
"yaxpeax-pic18",
- "yaxpeax-pic24",
"yaxpeax-x86",
]
[[package]]
-name = "yaxpeax-mips"
-version = "0.0.1"
+name = "yaxpeax-m16c"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "00248964a847ea31080732852503377cbef24144226a42693865700312e9b0c1"
dependencies = [
- "num_enum",
+ "num-traits",
"serde",
"serde_derive",
- "termion",
"yaxpeax-arch",
]
[[package]]
-name = "yaxpeax-msp430-mc"
-version = "0.0.1"
+name = "yaxpeax-mips"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "522a0f8af9ca110ab99d29071a4f7953eb7025c3698461bd1adc36dc8a03523f"
dependencies = [
- "serde",
- "serde_derive",
+ "num_enum",
"termion",
"yaxpeax-arch",
]
[[package]]
-name = "yaxpeax-pic17"
-version = "0.0.1"
+name = "yaxpeax-msp430"
+version = "0.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8c1885d516b165a9799ff0a02af51263e2198215ea03097a582f41f3efa34259"
dependencies = [
- "serde",
- "serde_derive",
"termion",
"yaxpeax-arch",
]
[[package]]
-name = "yaxpeax-pic18"
-version = "0.0.1"
+name = "yaxpeax-pic17"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52f7c1a9869cda40d584e0b6356bc94ea7dbb8b64c5756fb268f33134fc5a75d"
dependencies = [
- "serde",
- "serde_derive",
+ "termion",
"yaxpeax-arch",
]
[[package]]
-name = "yaxpeax-pic24"
-version = "0.0.1"
+name = "yaxpeax-pic18"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a5695d4bed74eb94a8a06439ed67cb4f7b244121bf56d735e64facb7b5c698b6"
dependencies = [
- "serde",
- "serde_derive",
"yaxpeax-arch",
]
[[package]]
name = "yaxpeax-x86"
-version = "0.0.1"
+version = "0.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c99c7e696c0ef10d67492b728b588dc260d5fa2e33d1e37edcf7cd466c7946b4"
dependencies = [
"num-traits",
"serde",
"serde_derive",
- "serde_json",
- "termion",
"yaxpeax-arch",
]
diff --git a/Cargo.toml b/Cargo.toml
index 3076334..69c038a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -2,6 +2,7 @@
name = "yaxpeax-dis"
version = "0.1.0"
authors = ["iximeow <me@iximeow.net>"]
+license = "0BSD"
edition = "2018"
description = "disassembly tool using yaxpeax instruction decoders"
@@ -15,12 +16,12 @@ hex = "0.4.0"
num-traits = "0.2.10"
# common interfaces for all yaxpeax decoders
-yaxpeax-arch = { path = "../yaxpeax-arch" }
+yaxpeax-arch = { version = "0.0.3" }
-yaxpeax-arm = { path = "../arch/arm" }
-yaxpeax-mips = { path = "../arch/mips" }
-yaxpeax-msp430-mc = { path = "../arch/msp430" }
-yaxpeax-pic17 = { path = "../arch/pic17" }
-yaxpeax-pic18 = { path = "../arch/pic18" }
-yaxpeax-pic24 = { path = "../arch/pic24" }
-yaxpeax-x86 = { path = "../arch/x86" }
+yaxpeax-arm = { version = "0.0.2" }
+yaxpeax-mips = { version = "0.0.2" }
+yaxpeax-msp430 = { version = "0.0.3" }
+yaxpeax-pic17 = { version = "0.0.2" }
+yaxpeax-pic18 = { version = "0.0.2" }
+yaxpeax-x86 = { version = "0.0.4" }
+yaxpeax-m16c = { version = "0.0.2" }
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..7091f53
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,12 @@
+Copyright (c) 2020 iximeow
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ac83eac
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+## yaxpeax-dis
+
+`yaxpeax-dis` is the repo providing `yaxdis`, a small and very naive disassembler to exercise decoders in the [yaxpeax project](https://git.iximeow.net/yaxpeax-arch/). it does not (currently?) do much other than disassembling hex input, and is mostly useful as an example of how to use decoders and spot-checking a specific instruction's decoding.
+
+## usage
+
+if you just want to build and use it, `cargo install yaxpeax-dis` should get you started. otherwise, clone this repo and a `cargo build` will work as well.
+
+`yaxdis [-a arch] [hex bytes]`, such as `yaxdis -a x86_64 33c0c3` which should yield:
+```
+0x00000000: 33c0 : xor eax, eax
+0x00000002: c3 : ret
+```
+or `yaxdis -a armv7 83591764ab46cd42`, producing:
+```
+0x00000000: 83591764 : ldrvs r5, [r7], #-0x260c
+0x00000004: ab46cd42 : sbcmi sp, 0x46ab
+```
+
+`yaxdis` also takes a `-v` flag to emit more verbose information (really, a `Debug` display of decoded instructions).
+
+## supported architectures / ! user beware !
+`yaxdis` should support all architectures listed in the [yaxpeax-arch readme](https://git.iximeow.net/yaxpeax-arch/). that is currently `x86_64`, `armv7`, `armv8`, `mips`, `msp430`, `pic17`, `pic18`, and `m16c`. specific levels of support and stability vary, beware.
diff --git a/src/main.rs b/src/main.rs
index 3a9fef4..b59ebb2 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -1,36 +1,37 @@
-use yaxpeax_arch::{Address, Arch, Decoder, Instruction, LengthedInstruction};
+use yaxpeax_arch::{AddressBase, Arch, Decoder, Instruction, LengthedInstruction};
-use clap::{Arg, App};
+use clap::*;
use num_traits::identities::Zero;
use std::fmt;
fn main() {
- let matches = App::new("yaxpeax disassembler")
- .version("0.0.1")
- .author("iximeow <me@iximeow.net>")
- .about("disassembly tool using yaxpeax decoders")
+ let _ = include_str!("../Cargo.toml");
+ let app = app_from_crate!()
.arg(Arg::with_name("arch")
.short("a")
- .long("architecture")
+ .long("--architecture")
.takes_value(true)
- .help("architecture to disassemble input as"))
+ .possible_values(&["x86_64", "armv7", "armv8", "mips", "msp430", "pic17", "pic18", "m16c"])
+ .help("architecture to disassemble input as."))
+ /*
.arg(Arg::with_name("file")
.short("f")
.long("file")
.takes_value(true)
.help("file of bytes to decode"))
+ */
.arg(Arg::with_name("verbose")
.short("v")
- .long("verbose")
+ .long("--verbose")
.help("increased detail when decoding instructions"))
.arg(Arg::with_name("data")
- .index(1))
- .get_matches();
+ .required(true)
+ .help("hex bytes to decode by the selected architecture. for example, try -a x86_64 33c0c3"));
+
+ let matches = app.get_matches();
let arch_str = matches.value_of("arch").unwrap_or("x86_64");
- eprintln!("disassembling as {}", arch_str);
-// let file = matches.value_of("file").unwrap();
let buf: &str = matches.value_of("data").unwrap_or("");
let verbose = matches.occurrences_of("verbose") > 0;
@@ -39,9 +40,10 @@ fn main() {
"armv7" => decode_input::<yaxpeax_arm::armv7::ARMv7>(buf, verbose),
"armv8" => decode_input::<yaxpeax_arm::armv8::a64::ARMv8>(buf, verbose),
"mips" => decode_input::<yaxpeax_mips::MIPS>(buf, verbose),
- "msp430" => decode_input::<yaxpeax_msp430_mc::MSP430>(buf, verbose),
+ "msp430" => decode_input::<yaxpeax_msp430::MSP430>(buf, verbose),
"pic17" => decode_input::<yaxpeax_pic17::PIC17>(buf, verbose),
"pic18" => decode_input::<yaxpeax_pic18::PIC18>(buf, verbose),
+ "m16c" => decode_input::<yaxpeax_m16c::M16C>(buf, verbose),
// "pic24" => decode_input::<yaxpeax_pic24::PIC24>(buf),
other => {
println!("unsupported architecture: {}", other);