Skip to content

Commit

Permalink
command: Add process_group method to Command struct
Browse files Browse the repository at this point in the history
Rust 1.64 stabilised the `process_group` method of the
`std::os::unix::process::CommandExt` trait. This allows the
caller to set the process group that a command is spawned in.

Expose that functionality from Tokio's `Command` structure.

This fixes #4312.
  • Loading branch information
HarveyHunt committed Oct 21, 2022
1 parent a03e042 commit c52b0cc
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions tokio/src/process/mod.rs
Expand Up @@ -690,6 +690,28 @@ impl Command {
self
}

/// Sets the process group ID (PGID) of the child process. Equivalent to a
/// setpgid call in the child process, but may be more efficient.
///
/// Process groups determine which processes receive signals.
///
/// ```no_run
/// use tokio::process::Command;
///
/// Command::new("ls")
/// .process_group(0)
/// .spawn()?
/// .wait()
/// .await?;
/// ```
#[cfg(unix)]
#[cfg_attr(docsrs, doc(cfg(unix)))]
#[cfg(tokio_unstable)]
pub fn process_group(&mut self, pgroup: i32) -> &mut Command {
self.std.process_group(pgroup);
self
}

/// Executes the command as a child process, returning a handle to it.
///
/// By default, stdin, stdout and stderr are inherited from the parent.
Expand Down

0 comments on commit c52b0cc

Please sign in to comment.