rootless-run 0.1.0

Rootless execution of commands that require root
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

//! Error handling for rootless backends.

use std::process::ExitStatus;

#[cfg(doc)]
use crate::RootlessBackend;
use crate::utils::SystemdDetectVirtOutput;

/// An error that can occur when using a rootless backend.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// An executable that is supposed to be called, is not found.
    #[error("Unable to to find executable: \"{executable}\"")]
    ExecutableNotFound {
        /// The executable that could not be found.
        executable: String,
        /// The source error.
        source: which::Error,
    },

    /// A command could not be executed.
    #[error("The command \"{command}\" could not be executed:\n{source}")]
    CommandExec {
        /// The command that could not be executed.
        command: String,
        /// The source error.
        source: std::io::Error,
    },

    /// A command exited unsuccessfully.
    #[error(
        "The command \"{command}\" exited with non-zero status code \"{exit_status}\":\nstderr:\n{stderr}"
    )]
    CommandNonZero {
        /// The command that exited with a non-zero exit code.
        command: String,
        /// The exit status of `command`.
        exit_status: ExitStatus,
        /// The stderr of `command`.
        stderr: String,
    },

    /// Unknown output of [systemd-detect-virt] detected.
    ///
    /// [systemd-detect-virt]: https://man.archlinux.org/man/systemd-detect-virt.1
    #[error("Unknown output of \"systemd-detect-virt\": \"{output}\"")]
    UnknownSystemdDetectVirtOutput {
        /// The unknown output for [systemd-detect-virt].
        output: String,
    },

    /// A [`RootlessBackend`] based on kernel namespaces is used in a container runtime.
    #[error(
        "Rootless backends based on kernel namespaces are not supported in the \"{runtime}\" containerization runtime."
    )]
    NamespacesInContainer {
        /// The container runtime in which the [`RootlessBackend`] based on kernel namespaces is
        /// used.
        runtime: SystemdDetectVirtOutput,
    },
}