#command #process #child #subprocess #fd

command-fds

A library for passing arbitrary file descriptors when spawning child processes

4 releases

0.2.2 Apr 1, 2022
0.2.1 Aug 12, 2021
0.2.0 Jun 2, 2021
0.1.0 May 4, 2021

#190 in Unix APIs

Download history 1164/week @ 2022-11-26 457/week @ 2022-12-03 624/week @ 2022-12-10 647/week @ 2022-12-17 362/week @ 2022-12-24 978/week @ 2022-12-31 923/week @ 2023-01-07 1229/week @ 2023-01-14 850/week @ 2023-01-21 693/week @ 2023-01-28 1173/week @ 2023-02-04 1123/week @ 2023-02-11 1224/week @ 2023-02-18 1307/week @ 2023-02-25 1336/week @ 2023-03-04 1207/week @ 2023-03-11

5,185 downloads per month
Used in 4 crates (3 directly)

Apache-2.0

18KB
279 lines

command-fds

crates.io page docs.rs page

A library for passing arbitrary file descriptors when spawning child processes.

Example

use command_fds::{CommandFdExt, FdMapping};
use std::fs::File;
use std::os::unix::io::AsRawFd;
use std::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 = 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().unwrap();

License

Licensed under the Apache License, Version 2.0.

Contributing

If you want to contribute to the project, see details of how we accept contributions.

Dependencies

~2.5MB
~58K SLoC