Function rustix::process::pidfd_getfd

source ·
pub fn pidfd_getfd<Fd: AsFd>(
    pidfd: Fd,
    targetfd: ForeignRawFd,
    flags: PidfdGetfdFlags,
) -> Result<OwnedFd>
Expand description

syscall(SYS_pidfd_getfd, pidfd, flags)—Obtain a duplicate of another process’ file descriptor.

§References

§Warning

This function is generally safe for the calling process, but it can impact the target process in unexpected ways. If you want to ensure that Rust I/O safety assumptions continue to hold in the target process, then the target process must have communicated the file description number to the calling process from a value of a type that implements AsRawFd, and the target process must not drop that value until after the calling process has returned from pidfd_getfd.

When pidfd_getfd is used to debug the target, or the target is not a Rust application, or pidfd_getfd is used in any other way, then extra care should be taken to avoid unexpected behaviour or crashes.

For further details, see the references above.