commit	937e66d2899061b5b2d34c8c98a32144ee48de47	[log] [tgz]
author	Joel Galenson <jgalenson@google.com>	Mon Aug 16 11:30:43 2021 -0700
committer	Joel Galenson <jgalenson@google.com>	Mon Aug 16 11:30:43 2021 -0700
tree	95f7f0dd3c17718f17bccd6cf62a31b5cc95fd41
parent	bd13c06228d65bfca078eacb24359c5af4b1c315 [diff]

tree: 95f7f0dd3c17718f17bccd6cf62a31b5cc95fd41

README.md

command-fds

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.