Struct DaemonManager 

pub struct DaemonManager {
    PidFilePath: PathBuf,
    IsRunning: Arc<RwLock<bool>>,
    PlatformInfo: PlatformInfo,
    PidLock: Arc<Mutex<()>>,
    PidChecksum: Arc<Mutex<Option<String>>>,
    ShutdownRequested: Arc<RwLock<bool>>,
}

Daemon lifecycle manager

Fields

PidFilePath: PathBuf

PID file path

IsRunning: Arc<RwLock<bool>>

Whether daemon is running

PlatformInfo: PlatformInfo

Platform-specific daemon info

PidLock: Arc<Mutex<()>>

Lock for atomic PID file operations (prevents race conditions)

PidChecksum: Arc<Mutex<Option<String>>>

Checksum for PID file integrity verification

ShutdownRequested: Arc<RwLock<bool>>

Graceful shutdown flag

Implementations

impl DaemonManager

pub fn New(PidFilePath: Option<PathBuf>) -> Result<Self>

Create a new DaemonManager instance

fn DefaultPidFilePath() -> PathBuf

Get default PID file path based on platform

fn DetectPlatform() -> Platform

Detect current platform

fn DetectPlatformInfo() -> PlatformInfo

Detect platform-specific information

pub async fn AcquireLock(&self) -> Result<()>

Acquire daemon lock to ensure single instance This method provides comprehensive defensive coding with:

• Race condition protection through mutex locking
• PID file checksum verification
• Process validation checks
• Atomic operations with rollback on failure
• Timeout handling

pub async fn IsAlreadyRunning(&self) -> Result<bool>

Check if daemon is already running Performs comprehensive validation including:

• PID file existence check
• Checksum verification
• Process existence validation
• Stale PID file cleanup

fn ValidateProcess(pid: u32) -> bool

Validate that a process with the given PID is running Performs thorough process validation and existence checks

async fn CleanupStalePidFile(&self) -> Result<()>

Cleanup stale PID file with validation and error handling

pub async fn ReleaseLock(&self) -> Result<()>

Release daemon lock with proper cleanup and rollback Ensures all resources are properly cleaned up even on failure

pub async fn IsRunning(&self) -> bool

Check if daemon is running

pub async fn RequestShutdown(&self) -> Result<()>

Request graceful shutdown

pub async fn ClearShutdownRequest(&self) -> Result<()>

Clear shutdown request (for restart scenarios)

pub async fn IsShutdownRequested(&self) -> bool

Check if shutdown has been requested

pub async fn GetStatus(&self) -> Result<DaemonStatus>

Get daemon status with comprehensive health information

pub fn GenerateServiceFile(&self) -> Result<String>

Generate system service file for installation

fn GenerateSystemdService(&self) -> Result<String>

Generate systemd service file with comprehensive configuration

fn GenerateLaunchdService(&self) -> Result<String>

Generate launchd service file with comprehensive configuration

fn GenerateWindowsService(&self) -> Result<String>

Generate Windows service configuration file TODO: Integrate with winsvc crate for actual Windows Service registration

pub async fn InstallService(&self) -> Result<()>

Install daemon as system service with validation

async fn InstallSystemdService(&self) -> Result<()>

Install systemd service with validation

async fn InstallLaunchdService(&self) -> Result<()>

Install launchd service with validation

async fn InstallWindowsService(&self) -> Result<()>

Install Windows service TODO: Integrate with winsvc crate for actual service registration

pub async fn UninstallService(&self) -> Result<()>

Uninstall system service with proper coordination

async fn UninstallSystemdService(&self) -> Result<()>

Uninstall systemd service with proper coordination

async fn UninstallLaunchdService(&self) -> Result<()>

Uninstall launchd service with proper coordination

async fn UninstallWindowsService(&self) -> Result<()>

Uninstall Windows service

Trait Implementations

impl Debug for DaemonManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.