Struct daemonize::Daemonize

pub struct Daemonize<T> { /* private fields */ }

Daemonization options.

Fork the process in the background, disassociate from its process group and the control terminal. Change umask value to 0o027, redirect all standard streams to /dev/null. Change working directory to / or provided value.

Optionally:

• maintain and lock the pid-file;
• drop user privileges;
• drop group privileges;
• change root directory;
• change the pid-file ownership to provided user (and/or) group;
• execute any provided action just before dropping privileges.

Implementations

impl Daemonize<()>

pub fn new() -> Self

impl<T> Daemonize<T>

pub fn pid_file<F: AsRef<Path>>(self, path: F) -> Self

Create pid-file at path, lock it exclusive and write daemon pid.

pub fn chown_pid_file(self, chown: bool) -> Self

If chown is true, daemonize will change the pid-file ownership, if user or group are provided

pub fn working_directory<F: AsRef<Path>>(self, path: F) -> Self

Change working directory to path or / by default.

pub fn user<U: Into<User>>(self, user: U) -> Self

Drop privileges to user.

pub fn group<G: Into<Group>>(self, group: G) -> Self

Drop privileges to group.

pub fn umask<M: Into<Mask>>(self, mask: M) -> Self

Change umask to mask or 0o027 by default.

pub fn chroot<F: AsRef<Path>>(self, path: F) -> Self

Change root to path

pub fn privileged_action<N, F: FnOnce() -> N + 'static>( self, action: F ) -> Daemonize<N>

Execute action just before dropping privileges. Most common use case is to open listening socket. Result of action execution will be returned by start method.

pub fn stdout<S: Into<Stdio>>(self, stdio: S) -> Self

Configuration for the child process’s standard output stream.

pub fn stderr<S: Into<Stdio>>(self, stdio: S) -> Self

Configuration for the child process’s standard error stream.

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

Start daemonization process, terminate parent after first fork, returns privileged action result to the child.

pub fn execute(self) -> Outcome<T>

Execute daemonization process, don’t terminate parent after first fork.

Trait Implementations

impl<T> Debug for Daemonize<T>

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

Formats the value using the given formatter.

impl Default for Daemonize<()>

fn default() -> Self

Returns the “default value” for a type.