Debian Codegraph @

crypto/keystore/impl+linux.ha

raw
1 // SPDX-License-Identifier: MPL-2.0
2 // (c) Hare authors <https://harelang.org>
3
4 use errors;
5 use linux::keyctl;
6
7 export type key = keyctl::serial;
8
9 // Creates a new secure key. The caller should clear the secret buffer with
10 // [[bytes::zero]] after initialization.
11 export fn newkey(buf: []u8, name: str) (key | nomem | errors::error) = {
12 match (keyctl::add_key("user", name, buf, keyctl::PROCESS_KEYRING)) {
13 case keyctl::nokey => abort();
14 case let err: errors::error =>
15 return err;
16 case let key: keyctl::serial =>
17 return key;
18 };
19 };
20
21 // Destroys a secure key.
22 export fn destroy(key: key) void = {
23 keyctl::revoke(key)!;
24 };
25
26 // Reads secret data from a secure key. When the caller is done using the secret
27 // buffer, they should use [[bytes::zero]] to securely wipe the buffer memory.
28 export fn read(key: key, buf: []u8) size = {
29 return keyctl::read(key, buf)!;
30 };