Struct Handle

pub struct Handle { /* private fields */ }

handle returned from daemonize to the daemon process the daemon should use this handle to detach itself from the parent process, In cases where your program needs to run set up before starting this can be useful, as the daemon will pipe it’s stdout/stderr to the parent process to communicate if start up was successful

Implementations

impl Handle

pub fn detach(&mut self)

detach the daemon from the parent process this will write “Daemon started successfully” to stdout before detaching

panics

if detach is called more than once

pub fn detach_with_msg<T: AsRef<[u8]>>(&mut self, msg: T)

detach the daemon from the parent process with a custom message to be printed to stdout before detaching

panics

if detach_with_msg is called more than once

Examples found in repository

examples/simple.rs (line 14)

fn main() {
	match daemonize("pid_file") {
		// we are now in the daemon, use this handle to detach from the parent process
		Ok(mut handle) => {
			let mut count = 0;
			loop {
				// the daemon's output is piped to the parent process' stdout
				println!("Count: {}", count);
				if count == 5 {
					handle.detach_with_msg("count has reached 5, continuing in background");
				}
				thread::sleep(time::Duration::from_secs(1));
				count += 1;
			}
		}
		// the daemon or the parent process may receive this error,
		// just print it and exit
		Err(e) => {
			// if this is the daemon, this is piped to the parent's stderr
			eprintln!("{}", e);
			// don't forget to flush
			let _ = io::stderr().flush();
			process::exit(1);
		}
	}
}