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

#[derive(Debug)]
pub enum FixedData<'a> {
	Valid {
		/// Used in SSC-2 READ and SPACE commands
		file_mark: bool,
		/// End of Medium; used in SSC-2 READ, SPACE, and WRITE commands
		eom: bool,
		/// Used in SBC-2 READ LONG, SBC-2 WRITE LONG, and SSC-2 READ commands
		incorrect_length: bool,
		key: u8,
		info: [u8; 4],
		/// Command-Specific Information
		cmd_info: [u8; 4],
		/// Additional Sense Code
		asc: u8,
		/// Additional Sense Code Qualifier
		ascq: u8,
		/// Field Replaceable Unit Code
		fruc: u8,
		/// Sense Key Specific (including the Sense Key Specific Valid leading bit)
		sks: [u8; 3],
		/// Additional Sense Bytes
		more: &'a [u8],
	},
	Invalid(&'a [u8]),
}

fn copy_from_slice_3(x: &[u8]) -> [u8; 3] {
	let mut y = [0; 3];
	y.copy_from_slice(x);
	y
}
fn copy_from_slice_4(x: &[u8]) -> [u8; 4] {
	let mut y = [0; 4];
	y.copy_from_slice(x);
	y
}

pub fn parse(data: &[u8]) -> Option<FixedData> {
	if data.len() < 18 {
		return None;
	}
	if data[0] & 0b1000_0000 != 0 {
		return Some(FixedData::Invalid(data));
	}

	// data[7] is Additional Sense Length, starting from data[8],
	let len = (data[7] + 8) as usize;

	Some(FixedData::Valid {
		file_mark: data[2] & 0b1000_0000 != 0,
		eom: data[2] & 0b0100_0000 != 0,
		incorrect_length: data[2] & 0b0010_0000 != 0,
		key: data[2] & 0b1111,

		info: copy_from_slice_4(&data[3..7]),
		cmd_info: copy_from_slice_4(&data[8..12]),
		asc: data[12],
		ascq: data[13],
		fruc: data[14],
		sks: copy_from_slice_3(&data[15..18]),

		more: if len > data.len() {
			// sense reports more data than `data` buffer actually fits
			return None
		} else {
			&data[18 .. len]
		}
	})
}