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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
use cap_primitives::fs::{reopen, OpenOptions};
#[cfg(feature = "std")]
use io_lifetimes::AsFilelike;
use std::io;
/// A trait for the `reopen` function.
pub trait Reopen {
/// Re-open a file, producing a new independent handle.
///
/// This operation isn't supported by all operating systems in all
/// circumstances, or in some operating systems in any circumstances, so it
/// may return an `io::ErrorKind::Other` error if the file cannot be
/// reopened.
///
/// For files that aren't deleted, it's supported mostly-reliably on Linux
/// and Windows and somewhat-reliably on Darwin. Beyond that, it works
/// reliably on terminal device files and (slowly) on directories. It's not
/// possible to implement this operation with POSIX APIs alone (short of
/// traversing the entire filesystem), so further support will depend on
/// operating systems providing OS-specific APIs.
///
/// This function takes an `OpenOptions`, however it does not acquire new
/// permissions that the original handle lacks.
fn reopen(&self, options: &OpenOptions) -> io::Result<Self>
where
Self: Sized;
}
impl Reopen for std::fs::File {
#[inline]
fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
reopen(self, options)
}
}
#[cfg(feature = "std")]
impl Reopen for cap_std::fs::File {
#[inline]
fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
let file = reopen(
&AsFilelike::as_filelike_view::<std::fs::File>(self),
options,
)?;
Ok(Self::from_std(file))
}
}
#[cfg(all(feature = "std", feature = "fs_utf8"))]
impl Reopen for cap_std::fs_utf8::File {
#[inline]
fn reopen(&self, options: &OpenOptions) -> io::Result<Self> {
let file = reopen(&self.as_filelike_view::<std::fs::File>(), options)?;
Ok(Self::from_std(file))
}
}