#daemon-process #process #daemon #daemonize #setsid

fork

Library for creating a new process detached from the controlling terminal (daemon)

25 releases

0.2.0 Jul 19, 2024
0.1.23 Feb 1, 2024
0.1.22 Jun 6, 2023
0.1.21 Mar 12, 2023
0.1.9 Oct 28, 2019

#67 in Operating systems

Download history 16803/week @ 2024-07-29 18052/week @ 2024-08-05 20681/week @ 2024-08-12 19996/week @ 2024-08-19 27166/week @ 2024-08-26 23678/week @ 2024-09-02 23434/week @ 2024-09-09 20844/week @ 2024-09-16 22861/week @ 2024-09-23 29565/week @ 2024-09-30 16125/week @ 2024-10-07 26496/week @ 2024-10-14 18142/week @ 2024-10-21 23166/week @ 2024-10-28 11593/week @ 2024-11-04 35205/week @ 2024-11-11

88,890 downloads per month
Used in 29 crates (27 directly)

BSD-3-Clause

11KB
81 lines

fork

crates.io Build codecov docs

Library for creating a new process detached from the controlling terminal (daemon).

Why?

  • Minimal library to daemonize, fork, double-fork a process.
  • daemon(3) has been deprecated in MacOSX 10.5, by using fork and setsid syscalls, new methods can be created to achieve the same goal.

Example:

Create a new test project:

$ cargo new --bin myapp

To install cargo use: curl https://sh.rustup.rs -sSf | sh

Add fork as a depdendecie:

cargo add fork

or Edit myapp/Cargo.toml and add to [dependencies]:

fork = "0.1"

Add the following code to myapp/main.rs

use fork::{daemon, Fork};
use std::process::Command;

fn main() {
    if let Ok(Fork::Child) = daemon(false, false) {
        Command::new("sleep")
            .arg("300")
            .output()
            .expect("failed to execute process");
    }
}

If using daemon(false, false),it will chdir to / and close the standard input, standard output, and standard error file descriptors.

Test running:

$ cargo run

Use ps to check the process, for example:

$ ps -axo ppid,pid,pgid,sess,tty,tpgid,stat,uid,%mem,%cpu,command, | egrep "myapp|sleep|PID"

egrep is used to show the ps headers

Output should be something like:

 PPID   PID  PGID   SESS TTY      TPGID STAT   UID       %MEM  %CPU COMMAND
    1 48738 48737      0 ??           0 S      501        0.0   0.0 target/debug/myapp
48738 48753 48737      0 ??           0 S      501        0.0   0.0 sleep 300
  • PPID == 1 that's the parent process

  • TTY = ?? no controlling terminal

  • new PGID = 48737

    1 - root (init/launchd)
     \-- 48738 myapp        PGID - 48737
      \--- 48753 sleep      PGID - 48737
    

Dependencies

~44KB