Tracking Issue for `Metadata::from_statx` in `std::os::linux::fs::MetadataExt`

Feature gate: #![feature(metadata_statx)]

This is a tracking issue for adding a constructor that constructs a std::fs::Metadata struct from a *const c_void pointer populated by the statx syscall.

Public API

// use std::os::linux::fs::MetadataExt;

pub const STATX_MASK: c_int;

impl MetadataExt for Metadata {
    unsafe fn from_statx(statxbuf: *const c_void) -> Metadata { ... }
}

Note: definition of this function is subject to change.

Steps / History

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

• ACP: rust-lang/libs-team#761
• Implementation: #156269
• Final comment period (FCP)^1
• Stabilization PR

Unresolved Questions

• Ensure we're happy with the guarantees this asks from Linux, see https://github.com/rust-lang/rust/pull/156269#issuecomment-4781948338 and https://github.com/rust-lang/rust/pull/156269#discussion_r3368595954. We may want to get an explicit guarantee from at least the mailing list (unclear as of writing if that has been asked for yet).

Read implementation PR #156269 and the public MetadataExt::from_statx API, then review the linked discussion about Linux guarantees. Done means the implementation and its guarantees are settled and the issue can proceed through final comment period and stabilization.