Struct daemonizr::Daemonizr

pub struct Daemonizr { /* private fields */ }

Daemonizr holds context needed for spawning the daemon process.

It includes:

• working directory of the daemon;
• UID and GID to be set to after going daemon;
• umask which daemon uses after dropping the privileges;
• the PID file to use;
• setup for stdout/stderr files

Implementations

impl Daemonizr

Super

pub fn new() -> Self

Creates a new default Daemonizr context with following attributes:

• current directory is used as working directory;
• current user and his default group used for daemon;
• the umask() is set to 0 (means creation mode = 777);
• PID file “daemonizr.pid” in current directory is used as PID file;
• the stdout and stderr are both closed.

pub fn work_dir(self, work_dir: PathBuf) -> Result<Self, DaemonizrError>

Path to working directory for the daemon, this path must be a directory, must exist AND be an absolute path.

pub fn as_user(self, user: User) -> Self

User to be set after going daemon

pub fn as_group(self, group: Group) -> Self

Group to be set after going daemon

pub fn umask(self, umask: u16) -> Result<Self, DaemonizrError>

Umask to use for daemon

pub fn pidfile(self, pidfile: PathBuf) -> Self

Path for the pidfile. If path is a relative path, it is assumed to be relative to the working directory.

pub fn stdout(self, s: Stdout) -> Self

Set behaviour for standard output: close or redirect to the given path.

pub fn stderr(self, s: Stderr) -> Self

Set behaviour for standard error: close or redirect to the given path.

pub fn spawn(self) -> Result<(), DaemonizrError>

Perform the actual creation of a daemon process. In case of success, this function never returns - the parent process will exit with exit code 0 (success), the child (daemon) process will

pub fn search(self) -> Result<u32, DaemonizrError>

Search for PID of an already spawned daemon. If one is present, its PID is returned, otherwise an error is returned.

Hint: for search, you’ll need to set at least absolute path with Self::pidfile(), or, set absolute path using Self::work_dir() in conjuction with setting a relative path using Self::pidfile().

Trait Implementations

impl Debug for Daemonizr

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

Formats the value using the given formatter.