https://github.com/google/command-fds

A Rust library for passing arbitrary file descriptors when spawning child processes.
https://github.com/google/command-fds

command fd process subprocess unix

Last synced: 23 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/google/command-fds
• Owner: google
• License: apache-2.0
• Created: 2021-04-29T16:53:14.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2026-03-09T10:28:02.000Z (about 1 month ago)
• Last Synced: 2026-03-22T11:44:48.605Z (28 days ago)
• Topics: command, fd, process, subprocess, unix
• Language: Rust
• Homepage:
• Size: 79.1 KB
• Stars: 45
• Watchers: 3
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# command-fds

[![crates.io page](https://img.shields.io/crates/v/command-fds.svg)](https://crates.io/crates/command-fds)

[![docs.rs page](https://docs.rs/command-fds/badge.svg)](https://docs.rs/command-fds)

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

## Example

```rust

use command_fds::{CommandFdExt, FdMapping};

use std::fs::File;

use std::io::stdin;

use std::os::fd::AsFd;

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.into(),

            child_fd: 3,

        },

        // Map this process's stdin as FD 5 in the child process.

        FdMapping {

            parent_fd: stdin().as_fd().try_clone_to_owned().unwrap(),

            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](http://www.apache.org/licenses/LICENSE-2.0).

## Contributing

If you want to contribute to the project, see details of

[how we accept contributions](CONTRIBUTING.md).