kdump 2.0.4

A small utility that disassembles and reads KSM and KO files for use with KerbalOS.
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
45
46
47
48

use std::error::Error;
use std::io::prelude::*;

use flate2::read::GzDecoder;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum FileType {
    KerbalMachineCode,
    KerbalObject,
    Unknown,
}

/// Determines the type of a file using the raw bytes
pub fn determine_file_type(contents: &[u8]) -> Result<FileType, Box<dyn Error>> {
    if contents.len() < 4 {
        return Err("Error: Provided a file that is less than 4 bytes long".into());
    }

    if is_gzip(contents) {
        let mut decoder = GzDecoder::new(contents);
        let mut decompressed = [0, 0, 0, 0];

        decoder.read_exact(&mut decompressed)?;

        if is_ksm(&decompressed) {
            return Ok(FileType::KerbalMachineCode);
        }
    } else if is_ko(contents) {
        return Ok(FileType::KerbalObject);
    }

    Ok(FileType::Unknown)
}

/// Checks if the file is in proper GZIP format
fn is_gzip(contents: &[u8]) -> bool {
    contents[0] == 0x1f && contents[1] == 0x8b && contents[2] == 0x08 && contents[3] == 0x00
}

/// Checks the first 4 bytes of the file to tell if the contents are a KSM file or someone's compressed homework
fn is_ksm(contents: &[u8]) -> bool {
    contents[0] == 0x6b && contents[1] == 0x03 && contents[2] == 0x58 && contents[3] == 0x45
}

/// Checks the first 4 bytes of the file to tell if the contents are a KO file
fn is_ko(contents: &[u8]) -> bool {
    contents[0] == 0x6b && contents[1] == 0x01 && contents[2] == 0x6f && contents[3] == 0x66
}