Direct-BT v3.3.0-1-gc2d430c
Direct-BT - Direct Bluetooth Programming.
Classes | Namespaces | Typedefs | Enumerations | Functions
file_util.hpp File Reference
#include <jau/fraction_type.hpp>
#include <jau/functional.hpp>
#include <memory>
#include <string>
#include <sys/types.h>
Include dependency graph for file_util.hpp:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

class  jau::fs::dir_item
 Representing a directory item split into dirname() and basename(). More...
 
class  jau::fs::file_stats
 Platform agnostic representation of POSIX ::lstat() and ::stat() for a given pathname. More...
 
struct  jau::fs::mount_ctx
 

Namespaces

namespace  jau
 __pack(...): Produces MSVC, clang and gcc compatible lead-in and -out macros.
 
namespace  jau::fs
 Author: Sven Gothel sgoth.nosp@m.el@j.nosp@m.ausof.nosp@m.t.co.nosp@m.m Copyright (c) 2022 Gothel Software e.K.
 

Typedefs

typedef jau::function< void(const dir_item &)> jau::fs::consume_dir_item
 void consume_dir_item(const dir_item& item) More...
 
typedef uint64_t jau::fs::mountflags_t
 Generic flag bit values for mount() flags. More...
 
typedef jau::function< bool(traverse_event, const file_stats &, size_t)> jau::fs::path_visitor
 path_visitor jau::FunctionDef definition More...
 
typedef int jau::fs::umountflags_t
 Generic flag bit values for umount() flags. More...
 

Enumerations

enum class  jau::fs::copy_options : uint16_t {
  jau::fs::copy_options::none = 0 , jau::fs::copy_options::recursive = 1 << 0 , jau::fs::copy_options::follow_symlinks = 1 << 1 , jau::fs::copy_options::into_existing_dir = 1 << 2 ,
  jau::fs::copy_options::ignore_symlink_errors = 1 << 8 , jau::fs::copy_options::overwrite = 1 << 9 , jau::fs::copy_options::preserve_all = 1 << 10 , jau::fs::copy_options::sync = 1 << 11 ,
  jau::fs::copy_options::verbose = 1 << 15
}
 Filesystem copy options used to copy() path elements. More...
 
enum class  jau::fs::fmode_t : uint32_t {
  jau::fs::fmode_t::none = 0 , jau::fs::fmode_t::set_uid = 04000 , jau::fs::fmode_t::set_gid = 02000 , jau::fs::fmode_t::sticky = 01000 ,
  jau::fs::fmode_t::ugs_set = 07000 , jau::fs::fmode_t::read_usr = 00400 , jau::fs::fmode_t::write_usr = 00200 , jau::fs::fmode_t::exec_usr = 00100 ,
  jau::fs::fmode_t::rwx_usr = 00700 , jau::fs::fmode_t::read_grp = 00040 , jau::fs::fmode_t::write_grp = 00020 , jau::fs::fmode_t::exec_grp = 00010 ,
  jau::fs::fmode_t::rwx_grp = 00070 , jau::fs::fmode_t::read_oth = 00004 , jau::fs::fmode_t::write_oth = 00002 , jau::fs::fmode_t::exec_oth = 00001 ,
  jau::fs::fmode_t::rwx_oth = 00007 , jau::fs::fmode_t::rwx_all = 00777 , jau::fs::fmode_t::def_dir_prot = 00750 , jau::fs::fmode_t::def_file_prot = 00640 ,
  jau::fs::fmode_t::protection_mask = 0b00000000000000000000111111111111 , jau::fs::fmode_t::sock = 0b00000000000000000001000000000000 , jau::fs::fmode_t::blk = 0b00000000000000000010000000000000 , jau::fs::fmode_t::chr = 0b00000000000000000100000000000000 ,
  jau::fs::fmode_t::fifo = 0b00000000000000001000000000000000 , jau::fs::fmode_t::dir = 0b00000000000000010000000000000000 , jau::fs::fmode_t::file = 0b00000000000000100000000000000000 , jau::fs::fmode_t::link = 0b00000000000001000000000000000000 ,
  jau::fs::fmode_t::no_access = 0b00100000000000000000000000000000 , jau::fs::fmode_t::not_existing = 0b01000000000000000000000000000000 , jau::fs::fmode_t::type_mask = 0b01100000000001111111000000000000
}
 Generic file type and POSIX protection mode bits as used in file_stats, touch(), mkdir() etc. More...
 
enum class  jau::fs::mountflags_linux : mountflags_t {
  jau::fs::mountflags_linux::none = 0 , jau::fs::mountflags_linux::rdonly = 1 , jau::fs::mountflags_linux::nosuid = 2 , jau::fs::mountflags_linux::nodev = 4 ,
  jau::fs::mountflags_linux::noexec = 8 , jau::fs::mountflags_linux::synchronous = 16 , jau::fs::mountflags_linux::remount = 32 , jau::fs::mountflags_linux::mandlock = 64 ,
  jau::fs::mountflags_linux::dirsync = 128 , jau::fs::mountflags_linux::noatime = 1024 , jau::fs::mountflags_linux::nodiratime = 2048 , jau::fs::mountflags_linux::bind = 4096 ,
  jau::fs::mountflags_linux::move = 8192 , jau::fs::mountflags_linux::rec = 16384 , jau::fs::mountflags_linux::silent = 32768 , jau::fs::mountflags_linux::posixacl = 1 << 16 ,
  jau::fs::mountflags_linux::unbindable = 1 << 17 , jau::fs::mountflags_linux::private_ = 1 << 18 , jau::fs::mountflags_linux::slave = 1 << 19 , jau::fs::mountflags_linux::shared = 1 << 20 ,
  jau::fs::mountflags_linux::relatime = 1 << 21 , jau::fs::mountflags_linux::kernmount = 1 << 22 , jau::fs::mountflags_linux::i_version = 1 << 23 , jau::fs::mountflags_linux::strictatime = 1 << 24 ,
  jau::fs::mountflags_linux::lazytime = 1 << 25 , jau::fs::mountflags_linux::active = 1 << 30 , jau::fs::mountflags_linux::nouser = 1UL << 31
}
 Flag bit values for mount() flags under GNU/Linux. More...
 
enum class  jau::fs::traverse_event : uint16_t {
  jau::fs::traverse_event::none = 0 , jau::fs::traverse_event::symlink = 1 << 0 , jau::fs::traverse_event::file = 1 << 1 , jau::fs::traverse_event::file_symlink = symlink | file ,
  jau::fs::traverse_event::dir_symlink = 1 << 2 , jau::fs::traverse_event::dir_check_entry = 1 << 7 , jau::fs::traverse_event::dir_entry = 1 << 8 , jau::fs::traverse_event::dir_exit = 1 << 9 ,
  jau::fs::traverse_event::dir_non_recursive = dir_entry | dir_exit
}
 Filesystem traverse event used to call path_visitor for path elements from visit(). More...
 
enum class  jau::fs::traverse_options : uint16_t {
  jau::fs::traverse_options::none = 0 , jau::fs::traverse_options::recursive = 1 << 0 , jau::fs::traverse_options::follow_symlinks = 1 << 1 , jau::fs::traverse_options::lexicographical_order = 1 << 2 ,
  jau::fs::traverse_options::dir_check_entry = 1 << 7 , jau::fs::traverse_options::dir_entry = 1 << 8 , jau::fs::traverse_options::dir_exit = 1 << 9 , jau::fs::traverse_options::verbose = 1 << 15
}
 Filesystem traverse options used to visit() path elements. More...
 
enum class  jau::fs::umountflags_linux : umountflags_t { jau::fs::umountflags_linux::force = 1 , jau::fs::umountflags_linux::detach = 2 , jau::fs::umountflags_linux::expire = 4 , jau::fs::umountflags_linux::nofollow = 8 }
 Flag bit values for umount() flags under GNU/Linux. More...
 

Functions

std::string jau::fs::absolute (const std::string_view &relpath) noexcept
 Returns the absolute path of given relpath if existing, otherwise an empty string. More...
 
std::string jau::fs::basename (const std::string_view &path) noexcept
 Return stripped leading directory components from given path separated by /. More...
 
bool jau::fs::chdir (const std::string &path) noexcept
 Change working directory. More...
 
bool jau::fs::compare (const file_stats &source1, const file_stats &source2, const bool verbose=false) noexcept
 Compare the bytes of both files, denoted by source1 and source2. More...
 
bool jau::fs::compare (const std::string &source1, const std::string &source2, const bool verbose=false) noexcept
 Compare the bytes of both files, denoted by source1 and source2. More...
 
bool jau::fs::copy (const std::string &source_path, const std::string &dest_path, const copy_options copts=copy_options::none) noexcept
 Copy the given source_path to dest_path using copy_options. More...
 
std::string jau::fs::dirname (const std::string_view &path) noexcept
 Return stripped last component from given path separated by /, excluding the trailing separator /. More...
 
int jau::fs::from_named_fd (const std::string &named_fd) noexcept
 Returns the file descriptor from the given named file descriptor. More...
 
std::string jau::fs::get_cwd () noexcept
 Return the current working directory or empty on failure. More...
 
bool jau::fs::get_dir_content (const int dirfd, const std::string &path, const consume_dir_item &digest) noexcept
 Returns a list of directory elements excluding . More...
 
bool jau::fs::get_dir_content (const std::string &path, const consume_dir_item &digest) noexcept
 Returns a list of directory elements excluding . More...
 
constexpr bool jau::fs::is_set (const copy_options mask, const copy_options bit) noexcept
 
constexpr bool jau::fs::is_set (const file_stats::field_t mask, const file_stats::field_t bits) noexcept
 
constexpr bool jau::fs::is_set (const fmode_t mask, const fmode_t bits) noexcept
 
constexpr bool jau::fs::is_set (const mountflags_linux mask, const mountflags_linux bit) noexcept
 
constexpr bool jau::fs::is_set (const traverse_event mask, const traverse_event bit) noexcept
 
constexpr bool jau::fs::is_set (const traverse_options mask, const traverse_options bit) noexcept
 
constexpr bool jau::fs::is_set (const umountflags_linux mask, const umountflags_linux bit) noexcept
 
bool jau::fs::isAbsolute (const std::string_view &path) noexcept
 Returns true if first character is / or - in case of Windows - \\. More...
 
bool jau::fs::mkdir (const std::string &path, const fmode_t mode=jau::fs::fmode_t::def_dir_prot, const bool verbose=false) noexcept
 Create directory. More...
 
mount_ctx jau::fs::mount (const std::string &source, const std::string &target, const std::string &fs_type, const mountflags_t flags, const std::string &fs_options="")
 Attach the filesystem named in source to target using the given filesystem source directly. More...
 
mount_ctx jau::fs::mount_image (const std::string &image_path, const std::string &target, const std::string &fs_type, const mountflags_t flags, const std::string &fs_options="")
 Attach the filesystem image named in image_path to target using an intermediate platform specific filesystem image loop-device. More...
 
constexpr uint16_t jau::fs::number (const copy_options rhs) noexcept
 
constexpr uint32_t jau::fs::number (const file_stats::field_t rhs) noexcept
 
constexpr uint32_t jau::fs::number (const fmode_t rhs) noexcept
 
constexpr mountflags_t jau::fs::number (const mountflags_linux rhs) noexcept
 
constexpr uint16_t jau::fs::number (const traverse_event rhs) noexcept
 
constexpr uint16_t jau::fs::number (const traverse_options rhs) noexcept
 
constexpr umountflags_t jau::fs::number (const umountflags_linux rhs) noexcept
 
constexpr bool jau::fs::operator!= (const copy_options lhs, const copy_options rhs) noexcept
 
constexpr bool jau::fs::operator!= (const file_stats::field_t lhs, const file_stats::field_t rhs) noexcept
 
constexpr bool jau::fs::operator!= (const fmode_t lhs, const fmode_t rhs) noexcept
 
constexpr bool jau::fs::operator!= (const mountflags_linux lhs, const mountflags_linux rhs) noexcept
 
constexpr bool jau::fs::operator!= (const traverse_event lhs, const traverse_event rhs) noexcept
 
constexpr bool jau::fs::operator!= (const traverse_options lhs, const traverse_options rhs) noexcept
 
constexpr bool jau::fs::operator!= (const umountflags_linux lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options jau::fs::operator& (const copy_options lhs, const copy_options rhs) noexcept
 
constexpr file_stats::field_t jau::fs::operator& (const file_stats::field_t lhs, const file_stats::field_t rhs) noexcept
 
constexpr fmode_t jau::fs::operator& (const fmode_t lhs, const fmode_t rhs) noexcept
 
constexpr mountflags_linux jau::fs::operator& (const mountflags_linux lhs, const mountflags_linux rhs) noexcept
 
constexpr traverse_event jau::fs::operator& (const traverse_event lhs, const traverse_event rhs) noexcept
 
constexpr traverse_options jau::fs::operator& (const traverse_options lhs, const traverse_options rhs) noexcept
 
constexpr umountflags_linux jau::fs::operator& (const umountflags_linux lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options & jau::fs::operator&= (copy_options &lhs, const copy_options rhs) noexcept
 
constexpr file_stats::field_t & jau::fs::operator&= (file_stats::field_t &lhs, const file_stats::field_t rhs) noexcept
 
constexpr fmode_t & jau::fs::operator&= (fmode_t &lhs, const fmode_t rhs) noexcept
 
constexpr mountflags_linux & jau::fs::operator&= (mountflags_linux &lhs, const mountflags_linux rhs) noexcept
 
constexpr mountflags_t & jau::fs::operator&= (mountflags_t &lhs, const mountflags_linux rhs) noexcept
 
constexpr traverse_event & jau::fs::operator&= (traverse_event &lhs, const traverse_event rhs) noexcept
 
constexpr traverse_options & jau::fs::operator&= (traverse_options &lhs, const traverse_options rhs) noexcept
 
constexpr umountflags_linux & jau::fs::operator&= (umountflags_linux &lhs, const umountflags_linux rhs) noexcept
 
constexpr umountflags_t & jau::fs::operator&= (umountflags_t &lhs, const umountflags_linux rhs) noexcept
 
constexpr bool jau::fs::operator== (const copy_options lhs, const copy_options rhs) noexcept
 
constexpr bool jau::fs::operator== (const file_stats::field_t lhs, const file_stats::field_t rhs) noexcept
 
constexpr bool jau::fs::operator== (const fmode_t lhs, const fmode_t rhs) noexcept
 
constexpr bool jau::fs::operator== (const mountflags_linux lhs, const mountflags_linux rhs) noexcept
 
constexpr bool jau::fs::operator== (const traverse_event lhs, const traverse_event rhs) noexcept
 
constexpr bool jau::fs::operator== (const traverse_options lhs, const traverse_options rhs) noexcept
 
constexpr bool jau::fs::operator== (const umountflags_linux lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options jau::fs::operator^ (const copy_options lhs, const copy_options rhs) noexcept
 
constexpr file_stats::field_t jau::fs::operator^ (const file_stats::field_t lhs, const file_stats::field_t rhs) noexcept
 
constexpr fmode_t jau::fs::operator^ (const fmode_t lhs, const fmode_t rhs) noexcept
 
constexpr mountflags_linux jau::fs::operator^ (const mountflags_linux lhs, const mountflags_linux rhs) noexcept
 
constexpr traverse_event jau::fs::operator^ (const traverse_event lhs, const traverse_event rhs) noexcept
 
constexpr traverse_options jau::fs::operator^ (const traverse_options lhs, const traverse_options rhs) noexcept
 
constexpr umountflags_linux jau::fs::operator^ (const umountflags_linux lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options & jau::fs::operator^= (copy_options &lhs, const copy_options rhs) noexcept
 
constexpr file_stats::field_t & jau::fs::operator^= (file_stats::field_t &lhs, const file_stats::field_t rhs) noexcept
 
constexpr fmode_t & jau::fs::operator^= (fmode_t &lhs, const fmode_t rhs) noexcept
 
constexpr mountflags_linux & jau::fs::operator^= (mountflags_linux &lhs, const mountflags_linux rhs) noexcept
 
constexpr mountflags_t & jau::fs::operator^= (mountflags_t &lhs, const mountflags_linux rhs) noexcept
 
constexpr traverse_event & jau::fs::operator^= (traverse_event &lhs, const traverse_event rhs) noexcept
 
constexpr traverse_options & jau::fs::operator^= (traverse_options &lhs, const traverse_options rhs) noexcept
 
constexpr umountflags_linux & jau::fs::operator^= (umountflags_linux &lhs, const umountflags_linux rhs) noexcept
 
constexpr umountflags_t & jau::fs::operator^= (umountflags_t &lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options jau::fs::operator| (const copy_options lhs, const copy_options rhs) noexcept
 
constexpr file_stats::field_t jau::fs::operator| (const file_stats::field_t lhs, const file_stats::field_t rhs) noexcept
 
constexpr fmode_t jau::fs::operator| (const fmode_t lhs, const fmode_t rhs) noexcept
 
constexpr mountflags_linux jau::fs::operator| (const mountflags_linux lhs, const mountflags_linux rhs) noexcept
 
constexpr traverse_event jau::fs::operator| (const traverse_event lhs, const traverse_event rhs) noexcept
 
constexpr traverse_options jau::fs::operator| (const traverse_options lhs, const traverse_options rhs) noexcept
 
constexpr umountflags_linux jau::fs::operator| (const umountflags_linux lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options & jau::fs::operator|= (copy_options &lhs, const copy_options rhs) noexcept
 
constexpr file_stats::field_t & jau::fs::operator|= (file_stats::field_t &lhs, const file_stats::field_t rhs) noexcept
 
constexpr fmode_t & jau::fs::operator|= (fmode_t &lhs, const fmode_t rhs) noexcept
 
constexpr mountflags_linux & jau::fs::operator|= (mountflags_linux &lhs, const mountflags_linux rhs) noexcept
 
constexpr mountflags_t & jau::fs::operator|= (mountflags_t &lhs, const mountflags_linux rhs) noexcept
 
constexpr traverse_event & jau::fs::operator|= (traverse_event &lhs, const traverse_event rhs) noexcept
 
constexpr traverse_options & jau::fs::operator|= (traverse_options &lhs, const traverse_options rhs) noexcept
 
constexpr umountflags_linux & jau::fs::operator|= (umountflags_linux &lhs, const umountflags_linux rhs) noexcept
 
constexpr umountflags_t & jau::fs::operator|= (umountflags_t &lhs, const umountflags_linux rhs) noexcept
 
constexpr copy_options jau::fs::operator~ (const copy_options rhs) noexcept
 
constexpr file_stats::field_t jau::fs::operator~ (const file_stats::field_t rhs) noexcept
 
constexpr fmode_t jau::fs::operator~ (const fmode_t rhs) noexcept
 
constexpr mountflags_linux jau::fs::operator~ (const mountflags_linux rhs) noexcept
 
constexpr traverse_event jau::fs::operator~ (const traverse_event rhs) noexcept
 
constexpr traverse_options jau::fs::operator~ (const traverse_options rhs) noexcept
 
constexpr umountflags_linux jau::fs::operator~ (const umountflags_linux rhs) noexcept
 
constexpr ::mode_t jau::fs::posix_protection_bits (const fmode_t mask) noexcept
 Returns the POSIX protection bits: rwx_all | set_uid | set_gid | sticky, i.e. More...
 
bool jau::fs::remove (const std::string &path, const traverse_options topts=traverse_options::none) noexcept
 Remove the given path. More...
 
bool jau::fs::rename (const std::string &oldpath, const std::string &newpath) noexcept
 Rename oldpath to newpath using POSIX rename(), with the following combinations. More...
 
void jau::fs::sync () noexcept
 Synchronizes filesystems, i.e. More...
 
std::string jau::fs::to_named_fd (const int fd) noexcept
 Returns platform dependent named file descriptor of given file descriptor, if supported. More...
 
std::string jau::fs::to_string (const copy_options mask) noexcept
 
std::string jau::fs::to_string (const file_stats::field_t mask) noexcept
 
std::string jau::fs::to_string (const fmode_t mask, const bool show_rwx=false) noexcept
 Return the string representation of fmode_t. More...
 
std::string jau::fs::to_string (const traverse_event mask) noexcept
 
std::string jau::fs::to_string (const traverse_options mask) noexcept
 
bool jau::fs::touch (const std::string &path, const fmode_t mode=jau::fs::fmode_t::def_file_prot) noexcept
 Touch the file with current time and create file if not existing yet. More...
 
bool jau::fs::touch (const std::string &path, const jau::fraction_timespec &atime, const jau::fraction_timespec &mtime, const fmode_t mode=jau::fs::fmode_t::def_file_prot) noexcept
 Touch the file with given atime and mtime and create file if not existing yet. More...
 
bool jau::fs::umount (const mount_ctx &context, const umountflags_t flags)
 Detach the given mount_ctx context More...
 
bool jau::fs::umount (const std::string &target, const umountflags_t flags)
 Detach the topmost filesystem mounted on target optionally using given umountflags options if supported. More...
 
bool jau::fs::visit (const file_stats &item_stats, const traverse_options topts, const path_visitor &visitor, std::vector< int > *dirfds=nullptr) noexcept
 Visit element(s) of a given path, see traverse_options for detailed settings. More...
 
bool jau::fs::visit (const std::string &path, const traverse_options topts, const path_visitor &visitor, std::vector< int > *dirfds=nullptr) noexcept
 Visit element(s) of a given path, see traverse_options for detailed settings. More...