Module bdrck::fs

fs provides various utilities for interacting with the filesystem.

Functions

create_file

This is a simple utility to create a new empty file. If a file at the given path already exists, it will be truncated. It’s an error if the path already exists but is, for example, a directory.

create_symlink

An implementation of a function to create symbolic links on UNIX-style OSes. This works equivalently to “ln -s target symlink”.

path_from_bytes

Construct a PathBuf from its byte representation, for example as returned by path_to_bytes.

path_to_bytes

Returns the given Path as a byte vector. This function may be useful for some kinds of serialization, or for calling C functions.

set_ownership

This function is a safe wrapper around chown(). If fail_on_access_denied is set to true, then an EACCES error is considered a failure, and we’ll return Err(…). Otherwise, this is considered a soft failure, and a warning will be logged, but Ok(()) will still be returned.

set_ownership_by_name

Set the user and group ownership of a file or directory. This is a convenience wrapper around set_ownership which allows the user and group to be specified by name instead of by ID.

set_permissions_mode

Set the permissions mode for the given file or directory. This is roughly equivalent to chmod(2) on Linux. Note that UNIX-style systems do not support changing mode for a symlink itself, so this function always follows symlinks (see man 2 fchmodat for details).