cap-primitives 0.9.0

Capability-oriented primitives
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! This defines `set_times`, the primary entrypoint to sandboxed
//! filesystem times modification.
//!
//! TODO: `check_set_times` etc.

#[cfg(not(windows))]
use crate::fs::set_times_nofollow_impl;
use crate::fs::{set_times_impl, FollowSymlinks, SystemTimeSpec};
use std::{fs, io, path::Path};

/// Perform a `utimensat`-like operation, ensuring that the resolution of the path
/// never escapes the directory tree rooted at `start`.
#[inline]
pub fn set_times(
    start: &fs::File,
    path: &Path,
    atime: Option<SystemTimeSpec>,
    mtime: Option<SystemTimeSpec>,
    follow: FollowSymlinks,
) -> io::Result<()> {
    set_times_impl(start, path, atime, mtime, follow)
}

/// Like `set_times`, but never follows symlinks.
#[inline]
#[cfg(not(windows))]
pub(crate) fn set_times_nofollow(
    start: &fs::File,
    path: &Path,
    atime: Option<SystemTimeSpec>,
    mtime: Option<SystemTimeSpec>,
) -> io::Result<()> {
    set_times_nofollow_impl(start, path, atime, mtime)
}