refactor + add doc + fix reload buf

This commit is contained in:
DL
2026-03-24 22:25:38 +01:00
parent 94d1973c7c
commit 5eb66dc4a6
2 changed files with 195 additions and 24 deletions

View File

@@ -37,6 +37,15 @@ impl Configuration {
/// * `Ok(Configuration)` if the configuration was successfully loaded and parsed.
/// * `Err(Box<dyn std::error::Error>)` if there was an error reading the file or
/// parsing the TOML content.
///
/// # Examples
///
/// ```
/// use dysm_rs::configuration::Configuration;
/// use std::path::PathBuf;
///
/// let _ = Configuration::from(&PathBuf::from("references/daemon.conf")).unwrap();
/// ```
pub fn from(file: &PathBuf) -> Result<Self, Box<dyn std::error::Error>> {
g_info!(
APPLICATION_NAME,

View File

@@ -1,13 +1,13 @@
//! Session management for the display manager.
//!
//! This module defines the `SessionManager` struct, which is responsible for
//! managing user sessions in the display manager. It includes functionality
//! managing user sessions. It includes functionality
//! for loading configuration, starting and stopping sessions, and
//! handling session-related events.
use crate::configuration::Configuration;
use crate::{APPLICATION_NAME, VERSION};
use gio::{self, DBusConnection, OwnerId, ResourceLookupFlags};
use glib::{g_debug, g_info, g_warning};
use gio::{self, DBusConnection, OwnerId, RegistrationId};
use glib::{g_critical, g_debug, g_info, g_warning};
use lazy_static::*;
use std::path::PathBuf;
use std::sync::{Arc, Mutex};
@@ -21,14 +21,22 @@ const G_DBUS_METHOD_LOGIN: &str = "login";
const G_PROCESSES_MON_TO: u64 = 500; // Interval for monitoring child processes in milliseconds
lazy_static! {
/// static global mutex variable that stores the current state of the session manager process, which can be either Running, End, or Reload.
/// This variable is used to control the behavior of the session manager based on signals received (e.g., SIGHUP for reload, SIGINT/SIGTERM for shutdown).
/// A global instance of the `SessionManager` wrapped in a `Mutex` for thread safety.
/// This allows the session manager to be accessed and modified from different parts of the application
/// while ensuring that only one instance is active at a time.
static ref G_SESSION_MANAGER: Arc<Mutex<SessionManagerState>> = Arc::new(Mutex::<SessionManagerState>::new(SessionManagerState::End));
}
/// SessionManagerState
///
/// An enum representing the state of the session manager. It can be in a running state with an active `SessionManager`,
/// or it can be in an end or reload state.
pub enum SessionManagerState {
/// The session manager is currently running and managing user sessions.
Running(SessionManager),
/// The session manager has been stopped and is no longer managing sessions.
End,
/// The session manager is in the process of reloading its configuration or restarting.
Reload,
}
@@ -40,20 +48,87 @@ pub struct SessionManager {
config: Configuration,
/// The main loop for handling session events.
main_loop: glib::MainLoop,
// introspection: gio::DBusNodeInfo,
/// The D-Bus owner ID for the session manager's D-Bus name.
bus_owner_id: Option<OwnerId>,
/// A list of signal handler IDs for any signals the session manager has connected to.
signals: Vec<glib::SourceId>,
/// The D-Bus connection and registration ID for the session manager's D-Bus object.
bus_registration: Option<(DBusConnection, RegistrationId)>,
}
/// Public interface for SessionManager
///
pub trait SessionManagerInterface {
/// Run the session manager with an input config file
///
/// # Arguments
///
/// - `&self` - Object that implements the Trait
/// - `config` (`&PathBuf`) - Config file.
/// - `is_dbus_session` (`bool`) - run the session manager using session DBUS or system DBUS
///
/// # Returns
///
/// - `bool` - if True service shall be restarted after finished
///
fn run(&self, config: &PathBuf, is_dbus_session: bool) -> bool;
/// Quit the current session manager service
///
/// # Arguments
///
/// - `&self` - Object that implements the Trait
/// - `reload` (`bool`) - if true the service shall be restarted after finished
///
fn quit(&self, reload: bool);
}
/// Trait that defines callbacks for SessionManager
///
trait SessionManagerCallback {
/// Handler for DBUS name acquired event
///
/// # Arguments
///
/// - `&self` - Object that implements the Trait.
/// - `connection` (`DBusConnection`) - DBUS connection.
/// - `name` (`&str`) - DBUS name.
///
fn on_name_acquired(&self, connection: DBusConnection, name: &str);
/// Handler for DBUS bus acquired event
///
/// # Arguments
///
/// - `&self` - Object that implements this Trait
/// - `connection` (`DBusConnection`) - DBUS connection
/// - `name` (`&str`) - DBUS name
///
fn on_bus_acquired(&self, connection: DBusConnection, name: &str);
/// Hander for DBUS name lost event
///
/// # Arguments
///
/// - `&self` - Object that implements this Trait
/// - `connection` (`Option<DBusConnection>`) - DBUS connection.
/// - `name` (`&str`) - DBUS name.
///
fn on_name_lost(&self, connection: Option<DBusConnection>, name: &str);
/// Handler for DBUS method call event
///
/// # Arguments
///
/// - `&self` (`undefined`) - Object that implements this Trait.
/// - `connection` (`DBusConnection`) - DBUS connection.
/// - `sender` (`Option<&str>`) - Sender name.
/// - `object_path` (`&str`) - DBUS Object path.
/// - `interface_name` (`Option<&str>`) - DBUS interface name.
/// - `method_name` (`&str`) - DBUS method name.
/// - `parameters` (`gio::glib::Variant`) - DBUS method parameters.
/// - `invocation` (`gio::DBusMethodInvocation`) - DBUS method invocation object.
///
fn on_method_call(
&self,
connection: DBusConnection,
@@ -64,7 +139,14 @@ trait SessionManagerCallback {
parameters: gio::glib::Variant,
invocation: gio::DBusMethodInvocation,
);
fn on_process_monitor(&self);
/// Hander for service processes monitor
///
/// # Arguments
///
/// - `&self` - Object that implements this Trait
///
fn on_processes_monitor(&self);
}
impl SessionManagerInterface for Arc<Mutex<SessionManagerState>> {
@@ -75,6 +157,7 @@ impl SessionManagerInterface for Arc<Mutex<SessionManagerState>> {
main_loop: glib::MainLoop::new(None, false),
bus_owner_id: None,
signals: Vec::new(),
bus_registration: None,
});
let evtloop = match self.lock().as_deref_mut().unwrap() {
SessionManagerState::Running(session) => {
@@ -84,10 +167,9 @@ impl SessionManagerInterface for Arc<Mutex<SessionManagerState>> {
_ => panic!("No SessionManager created"),
};
evtloop.run();
if let SessionManagerState::Reload = self.lock().as_deref().unwrap() {
true
} else {
false
match self.lock().as_deref().unwrap() {
SessionManagerState::Reload => true,
_ => false,
}
}
@@ -110,9 +192,21 @@ impl SessionManagerCallback for Arc<Mutex<SessionManagerState>> {
fn on_bus_acquired(&self, connection: DBusConnection, name: &str) {
g_debug!(APPLICATION_NAME, "D-BUS acquired for name {}", name);
let introspection = gio::DBusNodeInfo::for_xml(G_DBUS_INTROSPECTION).unwrap();
let introspection = match gio::DBusNodeInfo::for_xml(G_DBUS_INTROSPECTION) {
Ok(info) => info,
Err(err) => {
g_critical!(
APPLICATION_NAME,
"Failed to parse D-Bus introspection data: {}",
err
);
self.quit(false);
return;
}
};
let interface = &introspection.interfaces()[0];
let _ = connection
let registration_id = match connection
.register_object(G_DBUS_SERVER_PATH, interface)
.method_call(
|connection: DBusConnection,
@@ -134,11 +228,25 @@ impl SessionManagerCallback for Arc<Mutex<SessionManagerState>> {
},
)
.build()
.expect("Failed to register D-Bus object");
{
Err(error) => {
g_critical!(
APPLICATION_NAME,
"Failed to register D-Bus object at path {}: {}",
G_DBUS_SERVER_PATH,
error
);
self.quit(false);
return;
}
Ok(resource) => resource,
};
if let SessionManagerState::Running(session) = self.lock().as_deref_mut().unwrap() {
session.bus_registration = Some((connection, registration_id));
}
}
fn on_name_lost(&self, _connection: Option<DBusConnection>, name: &str) {
g_warning!(APPLICATION_NAME, "D-Bus name lost: {}", name);
g_critical!(APPLICATION_NAME, "D-Bus name lost: {}", name);
if let SessionManagerState::Running(session) = self.lock().as_deref_mut().unwrap() {
session.bus_owner_id = None;
}
@@ -147,9 +255,9 @@ impl SessionManagerCallback for Arc<Mutex<SessionManagerState>> {
fn on_method_call(
&self,
connection: DBusConnection,
sender: Option<&str>,
object_path: &str,
_connection: DBusConnection,
_sender: Option<&str>,
_object_path: &str,
interface_name: Option<&str>,
method_name: &str,
parameters: gio::glib::Variant,
@@ -183,17 +291,38 @@ impl SessionManagerCallback for Arc<Mutex<SessionManagerState>> {
}
}
fn on_process_monitor(&self) {}
fn on_processes_monitor(&self) {
if let SessionManagerState::Running(session) = self.lock().as_deref_mut().unwrap() {
session.monitor();
}
}
}
impl SessionManager {
/// Get a threadsafe singleton instance of the SessionManager
///
/// # Returns
///
/// - `Arc<Mutex<SessionManagerState>>` - Smart pointer to SessionManager
///
/// # Examples
///
/// ```
/// use dysm_rs::SessionManager;
///
/// let instance = SessionManager::instance();
/// ```
pub fn instance() -> Arc<Mutex<SessionManagerState>> {
G_SESSION_MANAGER.clone()
}
/// Set up the session manager.
/// Setup the session manager before running
///
/// # Arguments
///
/// - `&mut self` (`&mut SessionManager`) - Mutable reference to SessionManager.
/// - `is_dbus_session` (`bool`) - if true setup service using DBUS session, otherwise SBUS system
///
/// This method starts the main loop and begins handling session events.
/// It will block until the main loop is quit, at which point it will return.
fn setup(&mut self, is_dbus_session: bool) {
g_info!(
APPLICATION_NAME,
@@ -245,17 +374,37 @@ impl SessionManager {
// Monitor child processes here
// For example, you could check if any child processes have exited and handle that accordingly
// g_debug!(APPLICATION_NAME, "Monitoring child processes...");
SessionManager::instance().on_process_monitor();
SessionManager::instance().on_processes_monitor();
glib::ControlFlow::Continue
});
self.signals.push(processes_monitor_id);
// Implementation for running the session manager
}
/// Process DBUS login method cal
///
/// # Arguments
///
/// - `&self` (`&mut SessionManager`) - Mutable reference to current SessionManager.
/// - `parameters` (`&gio::glib::Variant`) - DBUS method parameters.
/// - `invocation` (`gio::DBusMethodInvocation`) - DBUS method invocation object.
///
fn login(&self, parameters: &gio::glib::Variant, invocation: gio::DBusMethodInvocation) {
g_debug!(APPLICATION_NAME, "Logging called");
invocation.return_dbus_error(G_DBUS_SERVER_ERROR_NAME, "Unimplemented");
}
/// Monitor session processes
///
/// # Arguments
///
/// - `&self` (`&mut SessionManager`) - Mutable reference to current SessionManager.
///
fn monitor(&self) {
// Here you would implement the logic to monitor child processes.
// For example, you could check if any child processes have exited and handle that accordingly.
g_debug!(APPLICATION_NAME, "Monitoring child processes...");
}
}
impl Drop for SessionManager {
@@ -265,6 +414,19 @@ impl Drop for SessionManager {
g_debug!(APPLICATION_NAME, "Releasing acquired D-Bus name");
gio::bus_unown_name(bus_owner_id);
}
if let Some((connection, registration_id)) = self.bus_registration.take() {
g_debug!(APPLICATION_NAME, "Unregistering D-Bus object");
connection
.unregister_object(registration_id)
.unwrap_or_else(|e| {
g_critical!(
APPLICATION_NAME,
"Unable to unregister object from D-Bus connection: {}",
e
)
});
}
g_debug!(APPLICATION_NAME, "Removing signal handlers");
for signal_id in self.signals.drain(..) {
signal_id.remove();
}