procfs 0.17.0

Interface to the linux procfs pseudo-filesystem
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

//! Functions related to the in-kernel key management and retention facility
//!
//! For more details on this facility, see the `keyrings(7)` man page.
//!
//! Additional functions can be found in the [keyring](crate::keyring) module.
use crate::{read_value, write_value, ProcResult};

/// GC Delay
///
/// The value in this file specifies the interval, in seconds,
/// after which revoked and expired keys will be garbage collected.
/// The purpose of having such an interval is so that
/// there is a window of time where user space can see an error
/// (respectively EKEYREVOKED and EKEYEXPIRED) that indicates what
/// happened to the key.
///
/// The default value in this file is 300 (i.e., 5 minutes).
///
/// (since Linux 2.6.32)
pub fn gc_delay() -> ProcResult<u32> {
    read_value("/proc/sys/kernel/keys/gc_delay")
}

/// Persistent Keyring Expiry
///
/// This file defines an interval, in seconds, to which the persistent
/// keyring's expiration timer is reset each time the
/// keyring is accessed (via keyctl_get_persistent(3) or the
/// keyctl(2) KEYCTL_GET_PERSISTENT operation.)
///
/// The default value in this file is 259200 (i.e., 3 days).
///
/// (Since Linux 3.13)
pub fn persistent_keyring_expiry() -> ProcResult<u32> {
    read_value("/proc/sys/kernel/keys/persistent_keyring_expiry")
}

/// Max bytes
///
/// This is the maximum number of bytes of data that a nonroot
/// user can hold in the payloads of the keys owned by the user.
///
/// The default value in this file is 20,000.
///
/// (since linux 2.6.26)
pub fn maxbytes() -> ProcResult<u32> {
    read_value("/proc/sys/kernel/keys/maxbytes")
}

/// Set max bytes
pub fn set_maxbytes(bytes: u32) -> ProcResult<()> {
    write_value("/proc/sys/kernel/keys/maxbytes", bytes)
}

/// Max keys
///
/// This is the maximum number of keys that a nonroot user may own.
///
/// (since linux 2.6.26)
pub fn maxkeys() -> ProcResult<u32> {
    read_value("/proc/sys/kernel/keys/maxkeys")
}

/// Set max keys
pub fn set_maxkeys(keys: u32) -> ProcResult<()> {
    write_value("/proc/sys/kernel/keys/maxkeys", keys)
}

/// Root maxbytes
///
/// This is the maximum number of bytes of data that the root user
/// (UID 0 in the root user namespace) can hold in the payloads of
/// the keys owned by root.
///
/// The default value in this file is 25,000,000 (20,000 before Linux 3.17).
///
/// (since Linux 2.6.26)
pub fn root_maxbytes() -> ProcResult<u32> {
    read_value("/proc/sys/kernel/keys/root_maxbytes")
}

/// Set root maxbytes
pub fn set_root_maxbytes(bytes: u32) -> ProcResult<()> {
    write_value("/proc/sys/kernel/keys/root_maxbytes", bytes)
}

/// Root maxkeys
///
/// This is the maximum number of keys that the root user (UID 0 in the root user namespace) may own.
///
/// The default value in this file is 1,000,000 (200 before Linux 3.17).
/// (since Linux 2.6.26)
pub fn root_maxkeys() -> ProcResult<u32> {
    read_value("/proc/sys/kernel/keys/root_maxkeys")
}

/// Set root maxkeys
pub fn set_root_maxkeys(keys: u32) -> ProcResult<()> {
    write_value("/proc/sys/kernel/keys/root_maxkeys", keys)
}

#[cfg(test)]
mod tests {
    use crate::{ProcError, ProcResult};

    fn check_unwrap<T>(val: ProcResult<T>) {
        match val {
            Ok(_) => {}
            Err(ProcError::NotFound(_)) => {
                // ok to ignore
            }
            Err(e) => {
                panic!("Unexpected proc error: {:?}", e);
            }
        }
    }

    #[test]
    fn test_keys() {
        check_unwrap(super::gc_delay());
        check_unwrap(super::persistent_keyring_expiry());
        check_unwrap(super::maxbytes());
        check_unwrap(super::maxkeys());
        check_unwrap(super::root_maxbytes());
        check_unwrap(super::root_maxkeys());
    }
}