Tracking Issue for StdioExt

[the8472]

Feature gate: #![feature(stdio_swap)]

This is a tracking issue for the std::os::{unix, windows}::io::StdioExt extension traits
that provide ways to redirect stdio to new file handles.

Public API

// unix
pub trait StdioExt {
    fn set_fd<T: Into<OwnedFd>>(&mut self, fd: T) -> io::Result<()>;

    fn replace_fd<T: Into<OwnedFd>>(&mut self, replace_with: T) -> io::Result<OwnedFd>;

    fn take_fd(&mut self) -> io::Result<OwnedFd>;
}

// windows
pub trait StdioExt {
    fn set_handle<T: Into<OwnedHandle>>(&mut self, handle: Option<T>) -> io::Result<()>;

    fn replace_handle<T: Into<OwnedHandle>>(&mut self, replace_with: T) -> io::Result<Option<BorrowedHandle<'static>>>;

    fn take_handle(&mut self) -> io::Result<Option<BorrowedHandle<'static>>>;
}

Steps / History

(Remember to update the S-tracking-* label when checking boxes.)

• ACP: stdio set, close and take methods libs-team#500
• Unix implementation for stdio set/take/replace #150668
• Final comment period (FCP)¹
• Stabilization PR

Unresolved Questions

• The windows API leaks the old handles handles because they're
  essentially BorrowedHandle<'static> and might be in use by other threads.
  This can lead to pipes not getting closed, which may be unexpected.
  #t-libs > take, close and replace for stdio

Footnotes

1. https://std-dev-guide.rust-lang.org/feature-lifecycle/stabilization.html ↩