Merge branch 'work/whiting/cancellable' into 'master'

Add a ProcessManager so we can cancel/pause/resume.

See merge request holo/steamos-manager!16
This commit is contained in:
Jeremy Whiting 2024-05-06 21:00:51 +00:00
commit b62ae4841d
6 changed files with 317 additions and 42 deletions

5
Cargo.lock generated
View file

@ -588,9 +588,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
[[package]]
name = "libc"
version = "0.2.153"
version = "0.2.154"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9c198f91728a82281a64e1f4f9eeb25d82cb32a5de251c6bd1b5154d63a8e7bd"
checksum = "ae743338b92ff9146ce83992f766a31066a91a8c84a45e0e9f21e7cf6de6d346"
[[package]]
name = "linux-raw-sys"
@ -938,6 +938,7 @@ dependencies = [
"anyhow",
"clap",
"inotify",
"libc",
"nix",
"tempfile",
"tokio",

View file

@ -14,8 +14,9 @@ strip="symbols"
anyhow = "1"
clap = { version = "4.5", default-features = false, features = ["derive", "help", "std", "usage"] }
inotify = { version = "0.10", default-features = false, features = ["stream"] }
nix = { version = "0.28", default-features = false, features = ["fs"] }
tokio = { version = "1", default-features = false, features = ["fs", "io-util", "macros", "rt-multi-thread", "signal", "sync"] }
libc = "0.2"
nix = { version = "0.28", default-features = false, features = ["fs", "signal"] }
tokio = { version = "1", default-features = false, features = ["fs", "io-std", "io-util", "macros", "process", "rt-multi-thread", "signal", "sync"] }
tokio-stream = { version = "0.1", default-features = false }
tokio-util = { version = "0.7", default-features = false }
tracing = { version = "0.1", default-features = false }

View file

@ -104,19 +104,27 @@
UpdateBios:
Perform a BIOS update.
@objectpath: An object path that can be used to pause/resume/cancel/kill the operation
Version available: 7
Version available: 8
-->
<method name="UpdateBios" />
<method name="UpdateBios">
<arg type="o" name="objectpath" direction="out"/>
</method>
<!--
UpdateDock:
Perform a Dock Firmware update.
Version available: 7
@objectpath: An object path that can be used to pause/resume/cancel/kill the operation
Version available: 8
-->
<method name="UpdateDock" />
<method name="UpdateDock">
<arg type="o" name="objectpath" direction="out"/>
</method>
<!--
TrimDevices:
@ -125,9 +133,13 @@
is important as some devices are not safe to trim unless some kernel
quirks are available.
Version available: 7
@objectpath: An object path that can be used to pause/resume/cancel/kill the operation
Version available: 8
-->
<method name="TrimDevices" />
<method name="TrimDevices">
<arg type="o" name="objectpath" direction="out"/>
</method>
<!--
FormatDevice:
@ -135,15 +147,17 @@
@device: Which device to format, e.g. /dev/mmcblk0
@label: Filesystem label to assign to the formatted device
@validate: When set runs common checks for conterfeit flash media before formatting, e.g. f3probe
@objectpath: An object path that can be used to pause/resume/cancel/kill the operation
Format and optionally validate a storage device to a steam compatible filesystem.
Version available: 7
Version available: 8
-->
<method name="FormatDevice">
<arg type="s" name="device" direction="in"/>
<arg type="s" name="label" direction="in"/>
<arg type="b" name="validate" direction="in"/>
<arg type="o" name="objectpath" direction="out"/>
</method>
<!--
@ -265,4 +279,54 @@
</interface>
<!--
com.steampowered.SteamOSManager1.SubProcess
@short_description: Interface to control a subprocess
Version available: 8
-->
<interface name="com.steampowered.SteamOSManager1.SubProcess">
<!--
Pause the operation
-->
<method name="Pause"/>
<!--
Resume the operation
-->
<method name="Resume"/>
<!--
Cancel the operation
Note this sends a SIGTERM to the subprocess, vs Kill which sends SIGKILL.
-->
<method name="Cancel"/>
<!--
Kill the operation
Note this sends a SIGKILL, vs Cancel which sends SIGTERM.
-->
<method name="Kill"/>
<!--
Wait for process to end and get exit code, resuming if paused
@exit_code The exit code
-->
<method name="Wait">
<arg type="i" name="exit_code" direction="out"/>
</method>
<!--
Get the exit code of the process if possible.
@exit_code The exit code
-->
<method name="ExitCode">
<arg type="i" name="exit_code" direction="out"/>
</method>
</interface>
</node>

View file

@ -17,7 +17,7 @@ use crate::power::{
get_gpu_clocks, get_gpu_performance_level, get_tdp_limit, set_gpu_clocks,
set_gpu_performance_level, set_tdp_limit, GPUPerformanceLevel,
};
use crate::process::{run_script, script_output};
use crate::process::{run_script, script_output, ProcessManager};
use crate::wifi::{
get_wifi_backend, get_wifi_power_management_state, set_wifi_backend, set_wifi_debug_mode,
set_wifi_power_management_state, WifiBackend, WifiDebugMode, WifiPowerManagement,
@ -38,15 +38,17 @@ pub struct SteamOSManager {
// Whether we should use trace-cmd or not.
// True on galileo devices, false otherwise
should_trace: bool,
process_manager: ProcessManager,
}
impl SteamOSManager {
pub async fn new(connection: Connection) -> Result<Self> {
Ok(SteamOSManager {
fan_control: FanControl::new(connection.clone()),
connection,
wifi_debug_mode: WifiDebugMode::Off,
should_trace: variant().await? == HardwareVariant::Galileo,
process_manager: ProcessManager::new(connection.clone()),
connection,
})
}
}
@ -142,47 +144,52 @@ impl SteamOSManager {
}
}
async fn update_bios(&self) -> zbus::fdo::Result<()> {
async fn update_bios(&mut self) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
// Update the bios as needed
run_script("/usr/bin/jupiter-biosupdate", &["--auto"])
self.process_manager
.get_command_object_path("/usr/bin/jupiter-biosupdate", &["--auto"], "updating BIOS")
.await
.inspect_err(|message| error!("Error updating BIOS: {message}"))
.map_err(to_zbus_fdo_error)
}
async fn update_dock(&self) -> zbus::fdo::Result<()> {
async fn update_dock(&mut self) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
// Update the dock firmware as needed
run_script(
"/usr/lib/jupiter-dock-updater/jupiter-dock-updater.sh",
&[] as &[String; 0],
)
.await
.inspect_err(|message| error!("Error updating dock: {message}"))
.map_err(to_zbus_fdo_error)
self.process_manager
.get_command_object_path(
"/usr/lib/jupiter-dock-updater/jupiter-dock-updater.sh",
&[] as &[String; 0],
"updating dock",
)
.await
}
async fn trim_devices(&self) -> zbus::fdo::Result<()> {
async fn trim_devices(&mut self) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
// Run steamos-trim-devices script
run_script("/usr/lib/hwsupport/trim-devices.sh", &[] as &[String; 0])
self.process_manager
.get_command_object_path(
"/usr/lib/hwsupport/trim-devices.sh",
&[] as &[String; 0],
"trimming devices",
)
.await
.inspect_err(|message| error!("Error updating trimming devices: {message}"))
.map_err(to_zbus_fdo_error)
}
async fn format_device(
&self,
&mut self,
device: &str,
label: &str,
validate: bool,
) -> zbus::fdo::Result<()> {
) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
let mut args = vec!["--label", label, "--device", device];
if !validate {
args.push("--skip-validation");
}
run_script("/usr/lib/hwsupport/format-device.sh", args.as_ref())
self.process_manager
.get_command_object_path(
"/usr/lib/hwsupport/format-device.sh",
args.as_ref(),
format!("formatting {device}").as_str(),
)
.await
.inspect_err(|message| error!("Error formatting {device}: {message}"))
.map_err(to_zbus_fdo_error)
}
#[zbus(property(emits_changed_signal = "false"))]

View file

@ -5,10 +5,171 @@
* SPDX-License-Identifier: MIT
*/
use anyhow::{anyhow, Result};
use anyhow::{anyhow, bail, Result};
use libc::pid_t;
use nix::sys::signal;
use nix::sys::signal::Signal;
use nix::unistd::Pid;
use std::ffi::OsStr;
#[cfg(not(test))]
use tokio::process::Command;
use tokio::process::{Child, Command};
use tracing::error;
use zbus::interface;
use crate::to_zbus_fdo_error;
const PROCESS_PREFIX: &str = "/com/steampowered/SteamOSManager1/Process";
pub struct ProcessManager {
// The thing that manages subprocesses.
// Keeps a handle to the zbus connection and
// what the next process id on the bus should be
connection: zbus::Connection,
next_process: u32,
}
pub struct SubProcess {
process: Child,
paused: bool,
exit_code: Option<i32>,
}
impl ProcessManager {
pub fn new(conn: zbus::Connection) -> ProcessManager {
ProcessManager {
connection: conn,
next_process: 0,
}
}
pub async fn get_command_object_path(
&mut self,
executable: &str,
args: &[impl AsRef<OsStr>],
operation_name: &str,
) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
// Run the given executable and give back an object path
let path = format!("{}{}", PROCESS_PREFIX, self.next_process);
self.next_process += 1;
let pm = ProcessManager::run_long_command(executable, args)
.await
.inspect_err(|message| error!("Error {operation_name}: {message}"))
.map_err(to_zbus_fdo_error)?;
self.connection
.object_server()
.at(path.as_str(), pm)
.await?;
zbus::zvariant::OwnedObjectPath::try_from(path).map_err(to_zbus_fdo_error)
}
pub async fn run_long_command(
executable: &str,
args: &[impl AsRef<OsStr>],
) -> Result<SubProcess> {
// Run the given executable with the given arguments
// Return an id that can be used later to pause/cancel/resume as needed
let child = Command::new(executable).args(args).spawn()?;
Ok(SubProcess {
process: child,
paused: false,
exit_code: None,
})
}
}
impl SubProcess {
fn send_signal(&self, signal: nix::sys::signal::Signal) -> Result<()> {
let pid = match self.process.id() {
Some(id) => id,
None => {
bail!("Unable to get pid from command, it likely finished running");
}
};
let pid: pid_t = match pid.try_into() {
Ok(pid) => pid,
Err(message) => {
bail!("Unable to get pid_t from command {message}");
}
};
signal::kill(Pid::from_raw(pid), signal)?;
Ok(())
}
async fn exit_code_internal(&mut self) -> Result<i32> {
match self.exit_code {
// Just give the exit_code if we have it already.
Some(code) => Ok(code),
None => {
// Otherwise wait for the process
let status = self.process.wait().await?;
match status.code() {
Some(code) => {
self.exit_code = Some(code);
Ok(code)
}
None => bail!("Process exited without giving a code."),
}
}
}
}
}
#[interface(name = "com.steampowered.SteamOSManager1.SubProcess")]
impl SubProcess {
pub async fn pause(&mut self) -> zbus::fdo::Result<()> {
if self.paused {
return Err(zbus::fdo::Error::Failed("Already paused".to_string()));
}
// Pause the given process if possible
// Return true on success, false otherwise
let result = self.send_signal(Signal::SIGSTOP).map_err(to_zbus_fdo_error);
self.paused = true;
result
}
pub async fn resume(&mut self) -> zbus::fdo::Result<()> {
// Resume the given process if possible
if !self.paused {
return Err(zbus::fdo::Error::Failed("Not paused".to_string()));
}
let result = self.send_signal(Signal::SIGCONT).map_err(to_zbus_fdo_error);
self.paused = false;
result
}
pub async fn cancel(&self) -> zbus::fdo::Result<()> {
self.send_signal(Signal::SIGTERM).map_err(to_zbus_fdo_error)
}
pub async fn kill(&self) -> zbus::fdo::Result<()> {
self.send_signal(signal::SIGKILL).map_err(to_zbus_fdo_error)
}
pub async fn wait(&mut self) -> zbus::fdo::Result<i32> {
if self.paused {
self.resume().await?;
}
let code = match self.exit_code_internal().await.map_err(to_zbus_fdo_error) {
Ok(v) => v,
Err(_) => {
return Err(zbus::fdo::Error::Failed(
"Unable to get exit code".to_string(),
));
}
};
self.exit_code = Some(code);
Ok(code)
}
pub async fn exit_code(&mut self) -> zbus::fdo::Result<i32> {
match self.exit_code_internal().await {
Ok(i) => Ok(i),
Err(_) => Err(zbus::fdo::Error::Failed(
"Unable to get exit code.".to_string(),
)),
}
}
}
#[cfg(not(test))]
pub async fn script_exit_code(executable: &str, args: &[impl AsRef<OsStr>]) -> Result<i32> {
@ -72,6 +233,41 @@ mod test {
Err(anyhow!("oops!"))
}
#[tokio::test]
async fn test_process_manager() {
let _h = testing::start();
let mut false_process = ProcessManager::run_long_command("/bin/false", &[] as &[String; 0])
.await
.unwrap();
let mut true_process = ProcessManager::run_long_command("/bin/true", &[] as &[String; 0])
.await
.unwrap();
let mut pause_process = ProcessManager::run_long_command("/usr/bin/sleep", &["1"])
.await
.unwrap();
let _ = pause_process.pause().await;
assert_eq!(
pause_process.pause().await.unwrap_err(),
zbus::fdo::Error::Failed("Already paused".to_string())
);
let _ = pause_process.resume().await;
assert_eq!(
pause_process.resume().await.unwrap_err(),
zbus::fdo::Error::Failed("Not paused".to_string())
);
// Sleep gives 0 exit code when done, -1 when we haven't waited for it yet
assert_eq!(pause_process.wait().await.unwrap(), 0);
assert_eq!(false_process.wait().await.unwrap(), 1);
assert_eq!(true_process.wait().await.unwrap(), 0);
}
#[tokio::test]
async fn test_run_script() {
let h = testing::start();

View file

@ -144,15 +144,15 @@ impl SteamOSManagerUser {
}
}
async fn update_bios(&self) -> zbus::fdo::Result<()> {
async fn update_bios(&self) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
method!(self, "UpdateBios")
}
async fn update_dock(&self) -> zbus::fdo::Result<()> {
async fn update_dock(&self) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
method!(self, "UpdateDock")
}
async fn trim_devices(&self) -> zbus::fdo::Result<()> {
async fn trim_devices(&self) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
method!(self, "TrimDevices")
}
@ -161,7 +161,7 @@ impl SteamOSManagerUser {
device: &str,
label: &str,
validate: bool,
) -> zbus::fdo::Result<()> {
) -> zbus::fdo::Result<zbus::zvariant::OwnedObjectPath> {
method!(self, "FormatDevice", device, label, validate)
}
@ -351,7 +351,13 @@ mod test {
let remote_method = remote_methods.get(*key).expect(key);
assert_eq!(local_method.name(), remote_method.name());
assert_eq!(local_method.args().len(), remote_method.args().len());
assert_eq!(
local_method.args().len(),
remote_method.args().len(),
"Testing {:?} against {:?}",
local_method,
remote_method
);
for (local_arg, remote_arg) in
zip(local_method.args().iter(), remote_method.args().iter())
{