Struct spirit_daemonize::Daemon

#[non_exhaustive]pub struct Daemon {
    pub user: SecId,
    pub group: SecId,
    pub pid_file: Option<PathBuf>,
    pub workdir: Option<PathBuf>,
    pub daemonize: bool,
}

A configuration fragment for configuration of daemonization.

This describes how to go into background with some details.

The fields can be manipulated by the user of this crate. However, it is not possible to create the struct manually. This is on purpose, some future versions might add more fields. If you want to create one, use Daemon::default and modify certain fields as needed.

Examples

let mut daemon = Daemon::default();
daemon.workdir = Some("/".into());

See also

If you want to daemonize, but not to switch users (or allow switching users), either because the daemon needs to keep root privileges or because it is expected to be already started as ordinary user, use the UserDaemon instead.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

user: SecId

The user to drop privileges to.

The user is not changed if not provided.

group: SecId

The group to drop privileges to.

The group is not changed if not provided.

pid_file: Option<PathBuf>

Where to store a PID file.

If not set, no PID file is created.

workdir: Option<PathBuf>

Switch to this working directory at startup.

If not set, working directory is not switched.

daemonize: bool

Enable the daemonization.

Even if this is false, some activity (changing users, setting PID file, etc) is still done, but it doesn't go to background.

Implementations

impl Daemon

pub fn prepare(&self) -> Result<Daemonize, AnyError>

Prepare for daemonization.

This does the fist (fallible) phase of daemonization and schedules the rest, though the Daemonize. This is mostly used through [`extension'], but can also be used manually.

pub unsafe fn daemonize(&self) -> Result<(), AnyError>

Perform the daemonization according to the setup inside.

This is the routine one would call if using the fragments manually, not through the spirit management and extension.

Safety

This is safe to call only if either the application is yet single-threaded (it's OK to start more threads afterwards) or if daemonize is false.

Trait Implementations

impl Clone for Daemon

pub fn clone(&self) -> Daemon

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Daemon

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

Formats the value using the given formatter.

impl Default for Daemon

pub fn default() -> Daemon

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for Daemon

pub fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Eq for Daemon

impl From<(Daemon, Opts)> for Daemon

pub fn from((d, o): (Daemon, Opts)) -> Self

Performs the conversion.

impl From<(UserDaemon, Opts)> for Daemon

pub fn from((d, o): (UserDaemon, Opts)) -> Self

Performs the conversion.

impl From<UserDaemon> for Daemon

pub fn from(ud: UserDaemon) -> Daemon

Performs the conversion.

impl PartialEq<Daemon> for Daemon

pub fn eq(&self, other: &Daemon) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &Daemon) -> bool

This method tests for !=.

impl Serialize for Daemon

pub fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructDoc for Daemon

pub fn document() -> Documentation

Returns the documentation for the type.

impl StructuralEq for Daemon

impl StructuralPartialEq for Daemon