cap_fs_ext/
open_options_sync_ext.rs

1/// Extension trait for `cap_primitives::fs::OpenOptions` which adds
2/// `sync`, `dsync`, `rsync`, and `nonblock` functions for controlling various
3/// I/O modes for the opened file.
4pub trait OpenOptionsSyncExt {
5    /// Requests write operations complete as defined by synchronized I/O file
6    /// integrity completion.
7    fn sync(&mut self, enable: bool) -> &mut Self;
8
9    /// Requests write operations complete as defined by synchronized I/O data
10    /// integrity completion.
11    fn dsync(&mut self, enable: bool) -> &mut Self;
12
13    /// Requests read operations complete as defined by the level of integrity
14    /// specified by `sync` and `dsync`.
15    fn rsync(&mut self, enable: bool) -> &mut Self;
16
17    /// Requests that I/O operations fail with `std::io::ErrorKind::WouldBlock`
18    /// if they would otherwise block.
19    ///
20    /// This option is commonly not implemented for regular files, so blocking
21    /// may still occur.
22    fn nonblock(&mut self, enable: bool) -> &mut Self;
23}
24
25impl OpenOptionsSyncExt for cap_primitives::fs::OpenOptions {
26    #[inline]
27    fn sync(&mut self, enable: bool) -> &mut Self {
28        // `sync` functionality is implemented within `cap_primitives`;
29        // we're just exposing it here since `OpenOptions` is re-exported by
30        // `cap_std` etc. and `sync` isn't in `std`.
31        self._cap_fs_ext_sync(enable)
32    }
33
34    #[inline]
35    fn dsync(&mut self, enable: bool) -> &mut Self {
36        // `dsync` functionality is implemented within `cap_primitives`;
37        // we're just exposing it here since `OpenOptions` is re-exported by
38        // `cap_std` etc. and `dsync` isn't in `std`.
39        self._cap_fs_ext_dsync(enable)
40    }
41
42    #[inline]
43    fn rsync(&mut self, enable: bool) -> &mut Self {
44        // `rsync` functionality is implemented within `cap_primitives`;
45        // we're just exposing it here since `OpenOptions` is re-exported by
46        // `cap_std` etc. and `rsync` isn't in `std`.
47        self._cap_fs_ext_rsync(enable)
48    }
49
50    #[inline]
51    fn nonblock(&mut self, enable: bool) -> &mut Self {
52        // `nonblock` functionality is implemented within `cap_primitives`;
53        // we're just exposing it here since `OpenOptions` is re-exported by
54        // `cap_std` etc. and `nonblock` isn't in `std`.
55        self._cap_fs_ext_nonblock(enable)
56    }
57}
cap_fs_ext/open_options_sync_ext.rs

cap_fs_ext/
open_options_sync_ext.rs
