landhb/linux-keyutils

Rust interface to the Linux key-management facility. Provides a safe interface around the raw system calls allowing user-space programs to perform key manipulation.

linux-keyutils

Rust interface to the Linux key-management facility. Provides a safe interface around the raw system calls allowing user-space programs to perform key manipulation.

There is a good cloudflare blog discussing why it should be used.

Basic Usage

To use linux-keyutils, first add this to your Cargo.toml:

[dependencies]
linux-keyutils = "0.2"

For more information please view the full documentation. There is also a small example program in the examples directory.

Features

• #![no_std] by default.
• For std programs KeyError implements std::error::Error when the std feature of this crate enabled.
• Small footprint, the library only relies on the libc and bitflags crates.

License

Licensed under either of the following at your discretion:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.

linux-keyutils's Issues

Doesn't compile on some 32-bit Linux platforms

For example on i686-unknown-linux-musl

error[E0308]: mismatched types
  --> /root/.cargo/registry/src/github.com-1ecc6299db9ec823/linux-keyutils-0.2.2/src/keyring.rs:31:13
   |
31 |             u64::from(create)
   |             ^^^^^^^^^^^^^^^^^ expected `u32`, found `u64`
   |
  ::: /root/.cargo/registry/src/github.com-1ecc6299db9ec823/linux-keyutils-0.2.2/src/ffi/mod.rs:13:9
   |
13 |         $crate::ffi::keyctl_impl($op, $a2, $a3, 0, 0)
   |         ------------------------ arguments to this function are incorrect
   |
note: function defined here
  --> /root/.cargo/registry/src/github.com-1ecc6299db9ec823/linux-keyutils-0.2.2/src/ffi/functions.rs:64:15
   |
64 | pub(crate) fn keyctl_impl(
   |               ^^^^^^^^^^^
...
67 |     arg3: libc::c_ulong,
   |     -------------------


error[E0277]: the trait bound `types::KeySerialId: From<u32>` is not satisfied
  --> /root/.cargo/registry/src/github.com-1ecc6299db9ec823/linux-keyutils-0.2.2/src/keyring.rs:33:10
   |
33 |         .try_into()
   |          ^^^^^^^^ the trait `From<u32>` is not implemented for `types::KeySerialId`
   |
   = note: required for `u32` to implement `Into<types::KeySerialId>`
   = note: required for `types::KeySerialId` to implement `TryFrom<u32>`
   = note: required for `u32` to implement `TryInto<types::KeySerialId>`


error[E0277]: the trait bound `types::KeySerialId: From<u32>` is not satisfied
  --> /root/.cargo/registry/src/github.com-1ecc6299db9ec823/linux-keyutils-0.2.2/src/keyring.rs:63:10
   |
63 |         .try_into()
   |          ^^^^^^^^ the trait `From<u32>` is not implemented for `types::KeySerialId`
   |
   = note: required for `u32` to implement `Into<types::KeySerialId>`
   = note: required for `types::KeySerialId` to implement `TryFrom<u32>`
   = note: required for `u32` to implement `TryInto<types::KeySerialId>`


error[E0277]: the trait bound `types::KeySerialId: From<u32>` is not satisfied
   --> /root/.cargo/registry/src/github.com-1ecc[629](https://github.com/PyO3/maturin/actions/runs/4268683584/jobs/7431347988#step:4:630)9db9ec823/linux-keyutils-0.2.2/src/keyring.rs:121:10
    |
121 |         .try_into()
    |          ^^^^^^^^ the trait `From<u32>` is not implemented for `types::KeySerialId`
    |
    = note: required for `u32` to implement `Into<types::KeySerialId>`
    = note: required for `types::KeySerialId` to implement `TryFrom<u32>`
    = note: required for `u32` to implement `TryInto<types::KeySerialId>`


error: aborting due to 4 previous errors


Some errors have detailed explanations: E0277, E0308.

For more information about an error, try `rustc --explain E0277`.