Struct RootShell

pub struct RootShell { /* private fields */ }

Represents a shell with root privileges.

Implementations

impl RootShell

Implementation of RootShell

pub fn new() -> Option<Self>

Creates a new root shell. Defaults to pkexec as super user provider and sh as shell. Returns None if the root shell could not be created.

Example

use super_shell::RootShell;
let mut root_shell = RootShell::new().expect("Failed to crate root shell");
println!("{}", root_shell.execute("echo Hello $USER"));

pub fn new_custom(super_user_provider: &str, shell: &str) -> Option<Self>

Creates a new root shell with the specified super user provider and shell. Returns None if the root shell could not be created. sudo as an interactive super user provider is currently not supported.

Parameter

• super_user_provider - The command to use to get super user privileges
• shell - The shell to use

Example

use super_shell::RootShell;
let mut root_shell = RootShell::new_custom("gksu", "bash").expect("Failed to crate root shell");
println!("{}", root_shell.execute("echo Hello $USER"));

pub fn execute(&mut self, command: impl AsRef<str>) -> String

Executes a command in the root shell and returns the output trimmed. Blocks the current thread until the command is finished.

Parameter

• command - The command to execute

Example

use super_shell::RootShell;
let mut root_shell = RootShell::new().expect("Failed to crate root shell");
assert!(root_shell.execute("echo Hello $USER").trim().eq("Hello root"));

pub fn exit(&mut self)

Exits the root shell and waits for the process to finish.

Trait Implementations

impl Drop for RootShell

Drop implementation for RootShell.

fn drop(&mut self)

Exits the root shell and waits for the process to finish.