Struct OpenOptionsSync 

pub struct OpenOptionsSync { /* private fields */ }

Available on crate feature std only.

Options to open a file with blocking path-traversal protection.

This is the sync counterpart to OpenOptions.

Implementations

impl OpenOptionsSync

pub fn new() -> Self

Create a new set of options with every flag disabled, matching std::fs::OpenOptions::new. Enable at least one access mode (e.g. read) before calling open.

pub fn read(&mut self, read: bool) -> &mut Self

Set the option for read access.

pub fn write(&mut self, write: bool) -> &mut Self

Set the option for write access.

pub fn append(&mut self, append: bool) -> &mut Self

Set the option for append mode.

pub fn truncate(&mut self, truncate: bool) -> &mut Self

Set the option for truncating a previous file.

pub fn create(&mut self, create: bool) -> &mut Self

Set the option to create a new file, or open it if it already exists.

pub fn create_new(&mut self, create_new: bool) -> &mut Self

Set the option to create a new file, failing if it already exists.

pub fn jail(&mut self, root: impl Into<PathBuf>) -> &mut Self

Confine every opened path to within root.

pub fn symlinks(&mut self, policy: SymlinkPolicy) -> &mut Self

Set how symbolic links are treated within the jail root.

Defaults to SymlinkPolicy::RestrictToRoot. Has no effect unless a jail root is configured.

pub fn created_file_permissions( &mut self, permissions: CreatedFilePermissions, ) -> &mut Self

Set permissions used when this open operation creates a new file.

pub fn open(&self, path: impl AsRef<Path>) -> Result<File>

Open the file at path with the configured options, after validating it against path-traversal attacks.

Trait Implementations

impl Clone for OpenOptionsSync

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OpenOptionsSync

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OpenOptionsSync

fn default() -> Self

Returns the “default value” for a type.