Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/extractors.rs
Original file line number Diff line number Diff line change
Expand Up @@ -191,3 +191,4 @@ pub mod wince;
pub mod yaffs2;
pub mod zlib;
pub mod zstd;
pub mod dex;
41 changes: 41 additions & 0 deletions src/extractors/dex.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
use crate::extractors::common::{Chroot, ExtractionResult, Extractor, ExtractorType};
use crate::structures::dex::parse_dex_header;

/// Defines the internal extractor for DEX files
pub fn dex_extractor() -> Extractor {
Extractor {
do_not_recurse: true,
utility: ExtractorType::Internal(extract_dex_file),
..Default::default()
}
}

/// Extracts a DEX file from the specified offset
pub fn extract_dex_file(
file_data: &[u8],
offset: usize,
output_directory: Option<&str>,
) -> ExtractionResult {
const OUTFILE_NAME: &str = "classes.dex";

let mut result = ExtractionResult {
..Default::default()
};
result.success = false;

// Parse the DEX header.
if let Some(data) = file_data.get(offset..) {
if let Ok(dex_header) = parse_dex_header(data) {
result.size = Some(dex_header.file_size);
result.success = true;

if output_directory.is_some() {
let chroot = Chroot::new(output_directory);
result.success =
chroot.carve_file(OUTFILE_NAME, file_data, offset, dex_header.file_size);
}
}
}

result
}
11 changes: 11 additions & 0 deletions src/magic.rs
Original file line number Diff line number Diff line change
Expand Up @@ -1229,6 +1229,17 @@ pub fn patterns() -> Vec<signatures::common::Signature> {
description: signatures::hashes::MD5_DESCRIPTION.to_string(),
extractor: None,
},
// DEX files
signatures::common::Signature {
name: "dex".to_string(),
short: false,
magic_offset: 0,
always_display: false,
magic: signatures::dex::dex_magic(),
parser: signatures::dex::dex_parser,
description: signatures::dex::DESCRIPTION.to_string(),
extractor: Some(extractors::dex::dex_extractor()),
},
];

binary_signatures
Expand Down
1 change: 1 addition & 0 deletions src/signatures.rs
Original file line number Diff line number Diff line change
Expand Up @@ -199,3 +199,4 @@ pub mod yaffs;
pub mod zip;
pub mod zlib;
pub mod zstd;
pub mod dex;
37 changes: 37 additions & 0 deletions src/signatures/dex.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
use crate::signatures::common::{
CONFIDENCE_MEDIUM, SignatureError, SignatureResult,
};

use crate::extractors::dex::extract_dex_file;

pub const DESCRIPTION: &str = "DEX file (Dalvik Executable)";

/// DEX files start with "dex\n"
pub fn dex_magic() -> Vec<Vec<u8>> {
vec![b"dex\n".to_vec()]
}

/// Validates the DEX header
pub fn dex_parser(file_data: &[u8], offset: usize) -> Result<SignatureResult, SignatureError> {

let mut result = SignatureResult {
offset,
name: "dex".to_string(),
description: DESCRIPTION.to_string(),
confidence: CONFIDENCE_MEDIUM,
..Default::default()
};

let dry_run = extract_dex_file(file_data, offset, None);

if dry_run.success {
// Retrieve total file size and report it
if let Some(total_size) = dry_run.size {
result.description = format!("DEX file, total size: {total_size}");
result.size = total_size;
return Ok(result);
}
}

Err(SignatureError)
}
1 change: 1 addition & 0 deletions src/structures.rs
Original file line number Diff line number Diff line change
Expand Up @@ -167,3 +167,4 @@ pub mod xz;
pub mod yaffs;
pub mod zip;
pub mod zstd;
pub mod dex;
54 changes: 54 additions & 0 deletions src/structures/dex.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
use crate::structures::common::{self, StructureError};

/// Standard DEX header size, in bytes
pub const DEX_HEADER_SIZE: usize = 112;

/// Standard DEX endian tag
pub const ENDIAN_CONSTANT: u32 = 0x1234_5678;

#[derive(Debug, Default, Clone)]
pub struct DexHeader {
pub file_size: usize,
}

/// Parses and validates a standard DEX header.
pub fn parse_dex_header(file_data: &[u8]) -> Result<DexHeader, StructureError> {

if file_data.len() < DEX_HEADER_SIZE {
return Err(StructureError);
}

// Validate the DEX magic: "dex\nNNN\0"
if &file_data[0..4] != b"dex\n"
|| !file_data[4..7].iter().all(u8::is_ascii_digit)
|| file_data[7] != 0
{
return Err(StructureError);
}

let dex_header_structure = vec![
("file_size", "u32"),
("header_size", "u32"),
("endian_tag", "u32"),
];

// These fields begin at offset 32 in the DEX header
if let Ok(header) = common::parse(&file_data[32..], &dex_header_structure, "little") {

// Validate the header size and endian tag
if header["header_size"] != DEX_HEADER_SIZE || header["endian_tag"] != ENDIAN_CONSTANT as usize {
return Err(StructureError);
}

// The declared file size must fit within available data
if header["file_size"] < DEX_HEADER_SIZE || header["file_size"] > file_data.len() {
return Err(StructureError);
}

return Ok(DexHeader {
file_size: header["file_size"],
});
}

Err(StructureError)
}