Struct SystemdService 

pub struct SystemdService { /* private fields */ }

Manages a systemd service based on a ServiceConfig.

This struct provides methods to generate the service file content, write it to disk, and interact with systemctl to manage the service.

Implementations

impl SystemdService

pub fn new(config: ServiceConfig) -> Self

Creates a new SystemdService from a given configuration.

pub fn generate(&self) -> String

Generates the content of the .service unit file as a string.

pub fn write(&self, path: &Path) -> Result<(), Error>

Writes the generated service file content to the specified path.

Errors

• Error::Permission if not run with root privileges.
• Error::Io on file creation or write failures.

pub fn install_and_enable(&self) -> Result<(), Error>

Installs, enables, and reloads the systemd daemon.

This is the primary method for setting up a new service. It performs:

1. Writes the service file to /etc/systemd/system/.
2. Reloads the systemd daemon (systemctl daemon-reload).
3. Enables the service (systemctl enable).

Errors

• Error::Permission if not run with root privileges.
• Error::Io if the service file already exists or on write failures.
• Error::Command if systemctl commands fail.

pub fn enable(&self) -> Result<(), Error>

Enables the service using systemctl enable.

Assumes the service file already exists and systemd has been reloaded. Requires root privileges.

pub fn start(&self) -> Result<(), Error>

Starts the service using systemctl start.

Errors

• Error::Permission if not run with root privileges.
• Error::Command if the systemctl start command fails.

pub fn get_service_file_path(&self) -> Result<String, Error>

Gets the conventional path for the service file (e.g., /etc/systemd/system/myapp.service).

Errors

• Error::Io if the service file already exists at this path.

pub fn reload_systemd() -> Result<(), Error>

Reloads the systemd daemon (systemctl daemon-reload).

Requires root privileges.

pub fn stop(&self) -> Result<(), Error>

Stop the service using systemctl start.

Errors

• Error::Permission if not run with root privileges.
• Error::Command if the systemctl stop command fails.

pub fn restart(&self) -> Result<(), Error>

Restarts the service using systemctl restart.

Errors

• Error::Permission if not run with root privileges.
• Error::Command if the systemctl restart command fails.