hdd 0.10.3

hdd: instruments for querying ATA and SCSI disks
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

pub fn bytes_to_be_words(data: &Vec<u8>) -> Vec<u16> {
	let mut output = vec![];

	// XXX what if `data` contains odd number of u8s?
	for i in 0 .. data.len()/2 {
		if cfg!(target_endian = "little") {
			output.push(
				((data[2 * i + 1] as u16) << 8)
				+ (data[2 * i] as u16)
			);
		} else {
			output.push(
				((data[2 * i] as u16) << 8)
				+ (data[2 * i + 1] as u16)
			);
		}
	}

	output
}

fn pretty_char_from_u8(x: u8) -> char {
	if x >= 0x20 && x <= 0x7f {
		// safety: we already checked whether the u8 is a valid ascii printable (and therefore is a valid unicode codepoint)
		unsafe { ::std::char::from_u32_unchecked(x as u32) }
	} else {
		// ' ' and '.' are ambiguous, and a string of '�'s is just unreadable
		'░'
	}
}

#[cfg_attr(feature = "cargo-clippy", allow(needless_range_loop))]
pub fn hexdump_8(data: &[u8]) -> String {
	// 3× (len rounded up to the multiple of 16) for ' {:02x}'
	// len/16 for \n
	// len/16 for ' ' before ascii
	// len (really rounded up len, because I'm lazy) for ascii
	// 2 to "round" (/16)s up and have lesser chance of reallocation
	let l = data.len();
	let mut dump = String::with_capacity(4*(l + 16 - l % 16) + l/8 + 2);
	let mut ascii = String::with_capacity(16);

	for i in 0..data.len() {
		if i % 16 == 0 {
			dump.push(' ');
			dump.push_str(&ascii);
			ascii.truncate(0);
			dump.push('\n');
		}
		dump.push_str(&format!(" {:02x}", data[i]));
		ascii.push(pretty_char_from_u8(data[i]));
	}
	// align trailing ascii
	if data.len() % 16 != 0 {
		for _ in 0..16 - data.len() % 16 {
			dump.push_str("   ");
		}
	}
	dump.push(' ');
	dump.push_str(&ascii);
	ascii.truncate(0);
	dump.push('\n');
	dump
}

#[cfg_attr(feature = "cargo-clippy", allow(needless_range_loop))]
pub fn hexdump_16be(data: &[u16]) -> String {
	// 5× (len rounded up to the multiple of 8) for ' {:04x}'
	// len/8 for \n
	// len/8 for ' ' before ascii
	// 2× len (really rounded up len, because I'm lazy) for ascii
	// 2 to "round" (/8)s up and have lesser chance of reallocation
	let l = data.len();
	let mut dump = String::with_capacity(7*(l + 8 - l%8) + data.len()/4 + 2);
	let mut ascii = String::with_capacity(16);

	for i in 0..data.len() {
		if i % 8 == 0 {
			dump.push(' ');
			dump.push_str(&ascii);
			ascii.truncate(0);
			dump.push('\n');
		}
		dump.push_str(&format!(" {:04x}", data[i]));
		ascii.push(pretty_char_from_u8((data[i] >> 8) as u8));
		ascii.push(pretty_char_from_u8((data[i] & 0xff) as u8));
	}
	// align trailing ascii
	if data.len() % 8 != 0 {
		for _ in 0..8 - data.len() % 8 {
			dump.push_str("     ");
		}
	}
	dump.push(' ');
	dump.push_str(&ascii);
	ascii.truncate(0);
	dump.push('\n');
	dump
}