API 的核心非常简单，由两个主要类型和三个主要特质组成

pub struct BorrowedFd<'fd> { ... }
pub struct OwnedFd { ... }

pub trait AsFd { ... }
pub trait IntoFd { ... }
pub trait FromFd { ... }

impl AsRawFd for BorrowedFd<'_> { ... }
impl AsRawFd for OwnedFd { ... }
impl IntoRawFd for OwnedFd { ... }
impl FromRawFd for OwnedFd { ... }

impl Drop for OwnedFd { ... }

impl AsFd for BorrowedFd<'_> { ... }
impl AsFd for OwnedFd { ... }
impl IntoFd for OwnedFd { ... }
impl FromFd for OwnedFd { ... }

在Windows上，每个Fd对象都有对应的Handle和Socket版本，还有一个特殊的HandleOrInvalid类型来处理Windows API中的不一致错误报告。

透明的魔法

这里是有趣的部份。BorrowedFd和OwnedFd是repr(transparent)的，并持有RawFd值，而Option<BorrowedFd>和Option<OwnedFd>在Rust >= 1.63中是FFI安全的，因此它们都可以在FFI直接使用。

extern "C" {
    pub fn open(pathname: *const c_char, flags: c_int, ...) -> Option<OwnedFd>;
    pub fn read(fd: BorrowedFd<'_>, ptr: *mut c_void, size: size_t) -> ssize_t;
    pub fn write(fd: BorrowedFd<'_>, ptr: *const c_void, size: size_t) -> ssize_t;
    pub fn close(fd: OwnedFd) -> c_int;
}

有了这样的绑定，用户永远不需要触摸RawFd值。当然，不是所有的代码都会这样做，但这对能够这样做的代码来说是一个有趣的功能。这就是为什么要使用BorrowedFd而不是仅仅使用&OwnedFd的原因。

注意open函数使用Option<OwnedFd>作为返回值，表示它可能成功或失败。

Rust中的I/O安全性

I/O安全性特性在Rust 1.63中得到稳定。从这个版本开始或更高版本，io-lifetimes将使用并重新导出标准库中的类型和特性。在较旧版本中，io-lifetimes定义了自己的这些类型和特性的副本。

io-lifetimes还包括一些不在std中的特性，包括可移植特性AsFilelike/AsSocketlike等，From特性中的from_into_函数，以及视图。