Module common

Common functionality shared between netpulse binaries.

This module provides shared utilities used by both the netpulse reader and netpulsed daemon binaries, including:

• Privilege checks
• Logging setup
• PID file management
• Process management
• User interaction

Exits

Some functions in this module exit when a condition is not met, printing an error then.

Logging

Logging can be configured via the NETPULSE_LOG_LEVEL environment variable. Valid levels are: TRACE, DEBUG, INFO, WARN, ERROR

Examples

use netpulse::common;

// Check for root privileges
common::root_guard();

// Initialize logging
common::init_logging(tracing::Level::INFO);

// Check if daemon is running
if let Some(pid) = common::getpid_running() {
    println!("Daemon running with PID: {}", pid);
}

Constants

• ENV_LOG_LEVEL
  Environment variable name for configuring log level

Functions

• confirm
  Prompts the user for confirmation with a custom message. Returns true if the user confirms, false otherwise.
• exec_cmd_for_user
  Executes a command and handles errors and output.
• getpid
  Reads the daemon’s PID from its PID file.
• getpid_running
  Checks if the netpulse daemon is currently running.
• init_logging
  Initializes the logging system with the specified level.
• pid_runs
  Checks if a process with the given PID exists.
• print_usage
  Displays program usage information and exits.
• root_guard
  Ensures the program is running with root privileges.
• setup_panic_handler
  Sets up a custom panic handler for user-friendly error reporting.