#![stable(feature = "metadata_ext", since = "1.1.0")] use crate::fs::{self, Metadata}; use crate::sealed::Sealed; use crate::sys_common::{AsInner, AsInnerMut, IntoInner}; use crate::time::SystemTime; #[allow(deprecated)] use crate::os::macos::raw; /// OS-specific extensions to [`fs::Metadata`]. /// /// [`fs::Metadata`]: crate::fs::Metadata #[stable(feature = "metadata_ext", since = "1.1.0")] pub trait MetadataExt { /// Gain a reference to the underlying `stat` structure which contains /// the raw information returned by the OS. /// /// The contents of the returned `stat` are **not** consistent across /// Unix platforms. The `os::unix::fs::MetadataExt` trait contains the /// cross-Unix abstractions contained within the raw stat. #[stable(feature = "metadata_ext", since = "1.1.0")] #[deprecated( since = "1.8.0", note = "deprecated in favor of the accessor \ methods of this trait" )] #[allow(deprecated)] fn as_raw_stat(&self) -> &raw::stat; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_dev(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_ino(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_mode(&self) -> u32; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_nlink(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_uid(&self) -> u32; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_gid(&self) -> u32; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_rdev(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_size(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_atime(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_atime_nsec(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_mtime(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_mtime_nsec(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_ctime(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_ctime_nsec(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_birthtime(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_birthtime_nsec(&self) -> i64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_blksize(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_blocks(&self) -> u64; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_flags(&self) -> u32; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_gen(&self) -> u32; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_lspare(&self) -> u32; #[stable(feature = "metadata_ext2", since = "1.8.0")] fn st_qspare(&self) -> [u64; 2]; } #[stable(feature = "metadata_ext", since = "1.1.0")] impl MetadataExt for Metadata { #[allow(deprecated)] fn as_raw_stat(&self) -> &raw::stat { unsafe { &*(self.as_inner().as_inner() as *const libc::stat as *const raw::stat) } } fn st_dev(&self) -> u64 { self.as_inner().as_inner().st_dev as u64 } fn st_ino(&self) -> u64 { self.as_inner().as_inner().st_ino as u64 } fn st_mode(&self) -> u32 { self.as_inner().as_inner().st_mode as u32 } fn st_nlink(&self) -> u64 { self.as_inner().as_inner().st_nlink as u64 } fn st_uid(&self) -> u32 { self.as_inner().as_inner().st_uid as u32 } fn st_gid(&self) -> u32 { self.as_inner().as_inner().st_gid as u32 } fn st_rdev(&self) -> u64 { self.as_inner().as_inner().st_rdev as u64 } fn st_size(&self) -> u64 { self.as_inner().as_inner().st_size as u64 } fn st_atime(&self) -> i64 { self.as_inner().as_inner().st_atime as i64 } fn st_atime_nsec(&self) -> i64 { self.as_inner().as_inner().st_atime_nsec as i64 } fn st_mtime(&self) -> i64 { self.as_inner().as_inner().st_mtime as i64 } fn st_mtime_nsec(&self) -> i64 { self.as_inner().as_inner().st_mtime_nsec as i64 } fn st_ctime(&self) -> i64 { self.as_inner().as_inner().st_ctime as i64 } fn st_ctime_nsec(&self) -> i64 { self.as_inner().as_inner().st_ctime_nsec as i64 } fn st_birthtime(&self) -> i64 { self.as_inner().as_inner().st_birthtime as i64 } fn st_birthtime_nsec(&self) -> i64 { self.as_inner().as_inner().st_birthtime_nsec as i64 } fn st_blksize(&self) -> u64 { self.as_inner().as_inner().st_blksize as u64 } fn st_blocks(&self) -> u64 { self.as_inner().as_inner().st_blocks as u64 } fn st_gen(&self) -> u32 { self.as_inner().as_inner().st_gen as u32 } fn st_flags(&self) -> u32 { self.as_inner().as_inner().st_flags as u32 } fn st_lspare(&self) -> u32 { self.as_inner().as_inner().st_lspare as u32 } fn st_qspare(&self) -> [u64; 2] { let qspare = self.as_inner().as_inner().st_qspare; [qspare[0] as u64, qspare[1] as u64] } } /// OS-specific extensions to [`fs::FileTimes`]. #[unstable(feature = "file_set_times", issue = "98245")] pub trait FileTimesExt: Sealed { /// Set the creation time of a file. #[unstable(feature = "file_set_times", issue = "98245")] fn set_created(self, t: SystemTime) -> Self; } #[unstable(feature = "file_set_times", issue = "98245")] impl FileTimesExt for fs::FileTimes { fn set_created(mut self, t: SystemTime) -> Self { self.as_inner_mut().set_created(t.into_inner()); self } }