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

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

use crate::fs::{set_times_impl, set_times_nofollow_impl, 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`. This function
/// follows symlinks.
#[inline]
pub fn set_times(
    start: &fs::File,
    path: &Path,
    atime: Option<SystemTimeSpec>,
    mtime: Option<SystemTimeSpec>,
) -> io::Result<()> {
    set_times_impl(start, path, atime, mtime)
}

/// Like `set_times`, but never follows symlinks.
#[inline]
pub 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)
}