#child-process #process #child #fd #subprocess #command #file-descriptor

tokio-command-fds

A library for passing arbitrary file descriptors when spawning child processes

1 unstable release

0.2.1 Jun 13, 2022

#682 in Unix APIs

Download history 62/week @ 2024-03-13 80/week @ 2024-03-20 84/week @ 2024-03-27 71/week @ 2024-04-03 73/week @ 2024-04-10 19/week @ 2024-04-17 27/week @ 2024-04-24 24/week @ 2024-05-01 37/week @ 2024-05-08 26/week @ 2024-05-15 16/week @ 2024-05-22 27/week @ 2024-05-29 12/week @ 2024-06-05 12/week @ 2024-06-12 12/week @ 2024-06-19 14/week @ 2024-06-26

51 downloads per month
Used in 2 crates (via job-security-server)

Apache-2.0

19KB
301 lines

tokio-command-fds

A library for passing arbitrary file descriptors when spawning child processes. (Forked from https://github.com/google/command-fds to add support for tokio)

Example

#[tokio::main(flavor="current_thread")]
async fn main() {
    use tokio_command_fds::{CommandFdExt, FdMapping};
    use std::fs::File;
    use std::os::unix::io::AsRawFd;
    use tokio::process::Command;

    // Open a file.
    let file = File::open("Cargo.toml").unwrap();

    // Prepare to run `ls -l /proc/self/fd` with some FDs mapped.
    let mut command = tokio::process::Command::new("ls");
    command.arg("-l").arg("/proc/self/fd");
    command
        .fd_mappings(vec![
            // Map `file` as FD 3 in the child process.
            FdMapping {
                parent_fd: file.as_raw_fd(),
                child_fd: 3,
            },
            // Map this process's stdin as FD 5 in the child process.
            FdMapping {
                parent_fd: 0,
                child_fd: 5,
            },
        ])
        .unwrap();

    // Spawn the child process.
    let mut child = command.spawn().unwrap();
    child.wait().await.unwrap();
}

License

Licensed under the Apache License, Version 2.0.

Dependencies

~4–16MB
~165K SLoC