sodium-sys 0.0.4

FFI binding to libsodium
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

use sodium_sys::crypto::utils::secmem;

#[test]
fn memzero() {
    let v = [0, 1, 2, 3, 4, 5, 6, 7];
    secmem::memzero(&v);
    assert!(v == [0; 8]);
}

#[test]
fn memcmp() {
    let v0 = [0, 1, 2, 3, 4, 5, 6, 7];
    let v1 = [0, 1, 2, 3, 4, 5, 6, 7];
    let v2 = [7, 6, 5, 4, 3, 2, 1, 0];
    assert!(secmem::memcmp(&v0,&v1) == 0);
    assert!(secmem::memcmp(&v0,&v2) == -1);
    assert!(secmem::memcmp(&v1,&v2) == -1);
}

#[test]
fn bin2hex() {
    let v = [0, 1, 254, 255];
    assert!(secmem::bin2hex(&v).unwrap() == "0001feff");
}

#[test]
fn hex2bin() {
    let hex = String::from("0001feff");
    let mut output = Vec::new();
    assert!(secmem::hex2bin(hex, &mut output, None) == 0);
    assert!(output == [0, 1, 254, 255]);
    let hex = String::from("00:01:fe:ff");
    let ignore = Some(String::from(":"));
    let mut output = Vec::new();
    assert!(secmem::hex2bin(hex, &mut output, ignore) == 0);
    assert!(output == [0, 1, 254, 255]);
    let hex = String::from("00 01 fe ff");
    let ignore = Some(String::from(" "));
    let mut output = Vec::new();
    assert!(secmem::hex2bin(hex, &mut output, ignore) == 0);
    assert!(output == [0, 1, 254, 255]);
    let hex = String::from("00 01:fe ff");
    let ignore = Some(String::from(": "));
    let mut output = Vec::new();
    assert!(secmem::hex2bin(hex, &mut output, ignore) == 0);
    assert!(output == [0, 1, 254, 255]);
}

#[cfg(feature = "mlock_tests")]
#[test]
fn mlock_munlock() {
    ::test_init();
    let v = [0, 1, 2, 3, 4, 5, 6, 7];
    assert!(secmem::mlock(&v) == 0);
    assert!(secmem::munlock(&v) == 0);
    assert!(v == [0; 8]);
}

#[test]
fn malloc_free() {
    ::test_init();
    let mut v = secmem::malloc(64);
    v[0] = 1;
    assert!(v.len() == 64);
    assert!(v[0] == 1);
    secmem::free(&mut v);
}

#[test]
fn allocarray_free() {
    ::test_init();
    let count = 2;
    let size = 16;
    let mut v = secmem::allocarray(count, size);
    v[0] = 1;
    v[31] = 255;
    assert!(v.len() == (count * size) as usize);
    assert!(v[0] == 1);
    assert!(v[31] == 255);
    secmem::free(&mut v);
}

#[test]
fn malloc_noaccess_free() {
    ::test_init();
    let mut v = secmem::malloc(64);
    v[0] = 1;
    assert!(v.len() == 64);
    assert!(v[0] == 1);
    secmem::mprotect_noaccess(&mut v);
    // assert!(v[0] == 1);  // If you uncomment this line the program will fail (no read).
    // v[1] = 1;            // If you uncomment this line the program will fail (no write).
    secmem::free(&mut v);
}

#[test]
fn malloc_readonly_free() {
    ::test_init();
    let mut v = secmem::malloc(64);
    v[0] = 1;
    assert!(v.len() == 64);
    assert!(v[0] == 1);
    secmem::mprotect_readonly(&mut v);
    assert!(v[0] == 1);
    // v[1] = 1;  // If you uncomment this line the program will fail (no write).
    secmem::free(&mut v);
}

#[test]
fn malloc_noaccess_readwrite_free() {
    ::test_init();
    let mut v = secmem::malloc(64);
    v[0] = 1;
    assert!(v.len() == 64);
    assert!(v[0] == 1);
    secmem::mprotect_noaccess(&mut v);
    // assert!(v[0] == 1);  // If you uncomment this line the program will fail (no read).
    // v[1] = 1;            // If you uncomment this line the program will fail (no write).
    secmem::mprotect_readwrite(&mut v);
    assert!(v[0] == 1);
    v[1] = 1;
    assert!(v[1] == 1);
    secmem::free(&mut v);
}

#[cfg(feature = "latest")]
#[test]
fn increment() {
    let mut nonce = [1];
    secmem::increment(&mut nonce);
    assert!(nonce == [2]);
}