libzypp 17.31.23
|
Types and functions for filesystem operations. More...
Classes | |
class | DevInoCache |
Simple cache remembering device/inode to detect hardlinks. More... | |
struct | DirEntry |
Listentry returned by readdir. More... | |
class | Glob |
Find pathnames matching a pattern. More... | |
class | PathInfo |
Wrapper class for stat/lstat. More... | |
class | Pathname |
Pathname. More... | |
class | StatMode |
Wrapper class for mode_t values as derived from ::stat. More... | |
class | TmpDir |
Provide a new empty temporary directory and recursively delete it when no longer needed. More... | |
class | TmpFile |
Provide a new empty temporary file and delete it when no longer needed. More... | |
class | TmpPath |
Automaticaly deletes files or directories when no longer needed. More... | |
Enumerations | |
enum | FileType { FT_NOT_AVAIL = 0x00 , FT_NOT_EXIST = 0x01 , FT_FILE = 0x02 , FT_DIR = 0x04 , FT_CHARDEV = 0x08 , FT_BLOCKDEV = 0x10 , FT_FIFO = 0x20 , FT_LINK = 0x40 , FT_SOCKET = 0x80 } |
File type information. More... | |
Functions | |
std::ostream & | operator<< (std::ostream &str, const Glob &obj) |
ZYPP_DECLARE_OPERATORS_FOR_FLAGS (Glob::Flags) | |
const StrMatcher & | matchNoDots () |
Convenience returning StrMatcher( "[^.]*", Match::GLOB ) | |
int | dirForEach (const Pathname &dir_r, const StrMatcher &matcher_r, function< bool(const Pathname &, const char *const)> fnc_r) |
std::ostream & | operator<< (std::ostream &str, FileType obj) |
std::ostream & | operator<< (std::ostream &str, const StatMode &obj) |
std::ostream & | operator<< (std::ostream &str, const PathInfo &obj) |
static int | recursive_rmdir_1 (const Pathname &dir, bool removeDir=true) |
template<typename F > | |
int | dirForEachImpl (const Pathname &dir_r, F &&fnc_r) |
std::ostream & | operator<< (std::ostream &str, const TmpPath &obj) |
Stream output as pathname. | |
File related functions. | |
int | unlink (const Pathname &path) |
Like 'unlink'. | |
int | rename (const Pathname &oldpath, const Pathname &newpath) |
Like 'rename'. | |
int | exchange (const Pathname &lpath, const Pathname &rpath) |
Exchanges two files or directories. | |
int | copy (const Pathname &file, const Pathname &dest) |
Like 'cp file dest'. | |
int | symlink (const Pathname &oldpath, const Pathname &newpath) |
Like 'symlink'. | |
int | hardlink (const Pathname &oldpath, const Pathname &newpath) |
Like '::link'. | |
int | hardlinkCopy (const Pathname &oldpath, const Pathname &newpath) |
Create newpath as hardlink or copy of oldpath. | |
int | readlink (const Pathname &symlink_r, Pathname &target_r) |
Like 'readlink'. | |
Pathname | expandlink (const Pathname &path_r) |
Recursively follows the symlink pointed to by path_r and returns the Pathname to the real file or directory pointed to by the link. | |
int | copy_file2dir (const Pathname &file, const Pathname &dest) |
Like 'cp file dest'. | |
int | assert_file (const Pathname &path, unsigned mode=0644) |
Create an empty file if it does not yet exist. | |
int | assert_file_mode (const Pathname &path, unsigned mode=0644) |
Like assert_file but enforce mode even if the file already exists. | |
int | touch (const Pathname &path) |
Change file's modification and access times. | |
Pathname | readlink (const Pathname &symlink_r) |
Digest computaion. | |
| |
std::string | md5sum (const Pathname &file) |
Compute a files md5sum. | |
std::string | sha1sum (const Pathname &file) |
Compute a files sha1sum. | |
std::string | checksum (const Pathname &file, const std::string &algorithm) |
Compute a files checksum. | |
bool | is_checksum (const Pathname &file, const CheckSum &checksum) |
check files checksum | |
Changing permissions. | |
int | chmod (const Pathname &path, mode_t mode) |
Like 'chmod'. | |
int | addmod (const Pathname &path, mode_t mode) |
Add the mode bits to the file given by path. | |
int | delmod (const Pathname &path, mode_t mode) |
Remove the mode bits from the file given by path. | |
Variables | |
template<class... T> | |
constexpr bool | always_false = false |
Misc. | |
enum | ZIP_TYPE { ZT_NONE , ZT_GZ , ZT_BZ2 , ZT_ZCHNK } |
Test whether a file is compressed (gzip/bzip2). More... | |
int | erase (const Pathname &path) |
Erase whatever happens to be located at path (file or directory). | |
ZIP_TYPE | zipType (const Pathname &file) |
ByteCount | df (const Pathname &path) |
Report free disk space on a mounted file system. | |
mode_t | getUmask () |
Get the current umask (file mode creation mask) | |
mode_t | applyUmaskTo (mode_t mode_r) |
Modify mode_r according to the current umask ( mode_r & ~getUmask() ) . | |
Directory related functions. | |
typedef std::list< DirEntry > | DirContent |
Returned by readdir. | |
int | mkdir (const Pathname &path, unsigned mode=0755) |
Like 'mkdir'. | |
int | assert_dir (const Pathname &path, unsigned mode=0755) |
Like 'mkdir -p'. | |
int | rmdir (const Pathname &path) |
Like 'rmdir'. | |
int | recursive_rmdir (const Pathname &path) |
Like 'rm -r DIR'. | |
int | clean_dir (const Pathname &path) |
Like 'rm -r DIR/ *'. | |
int | copy_dir (const Pathname &srcpath, const Pathname &destpath) |
Like 'cp -a srcpath destpath'. | |
int | copy_dir_content (const Pathname &srcpath, const Pathname &destpath) |
Like 'cp -a srcpath/. | |
int | dirForEach (const Pathname &dir_r, function< bool(const Pathname &, const char *const)> fnc_r) |
Invoke callback function fnc_r for each entry in directory dir_r. | |
int | dirForEachExt (const Pathname &dir_r, const function< bool(const Pathname &, const DirEntry &)> &fnc_r) |
Simiar to. | |
int | readdir (std::list< std::string > &retlist, const Pathname &path, bool dots=true) |
Return content of directory via retlist. | |
int | readdir (std::list< Pathname > &retlist, const Pathname &path, bool dots=true) |
Return content of directory via retlist. | |
int | readdir (DirContent &retlist, const Pathname &path, bool dots=true, PathInfo::Mode statmode=PathInfo::STAT) |
Return content of directory via retlist. | |
std::ostream & | operator<< (std::ostream &str, const DirContent &obj) |
int | is_empty_dir (const Pathname &path) |
Check if the specified directory is empty. | |
std::ostream & | operator<< (std::ostream &str, const DirEntry &obj) |
Types and functions for filesystem operations.
move zypp::filesystem stuff into separate header
Add tmpfile and tmpdir handling.
think about using Exceptions in zypp::filesystem
provide a readdir iterator; at least provide an interface using an insert_iterator to be independent from std::container.
move zypp::filesystem stuff into separate header
Add tmpfile and tmpdir handling.
think about using Exceptions in zypp::filesystem
provide a readdir iterator; at least provide an interface using an insert_iterator to be independent from std::container.
typedef std::list<DirEntry> zypp::filesystem::DirContent |
Returned by readdir.
Definition at line 518 of file PathInfo.h.
File type information.
Enumerator | |
---|---|
FT_NOT_AVAIL | |
FT_NOT_EXIST | |
FT_FILE | |
FT_DIR | |
FT_CHARDEV | |
FT_BLOCKDEV | |
FT_FIFO | |
FT_LINK | |
FT_SOCKET |
Definition at line 55 of file PathInfo.h.
Test whether a file is compressed (gzip/bzip2).
Enumerator | |
---|---|
ZT_NONE | |
ZT_GZ | |
ZT_BZ2 | |
ZT_ZCHNK |
Definition at line 754 of file PathInfo.h.
|
related |
zypp::filesystem::ZYPP_DECLARE_OPERATORS_FOR_FLAGS | ( | Glob::Flags | ) |
const StrMatcher & zypp::filesystem::matchNoDots | ( | ) |
Convenience returning StrMatcher( "[^.]*", Match::GLOB )
Definition at line 26 of file PathInfo.cc.
int zypp::filesystem::dirForEach | ( | const Pathname & | dir_r, |
const StrMatcher & | matcher_r, | ||
function< bool(const Pathname &, const char *const)> | fnc_r | ||
) |
Definition at line 32 of file PathInfo.cc.
std::ostream & zypp::filesystem::operator<< | ( | std::ostream & | str, |
FileType | obj | ||
) |
Definition at line 47 of file PathInfo.cc.
|
related |
Definition at line 95 of file PathInfo.cc.
|
related |
Definition at line 261 of file PathInfo.cc.
int zypp::filesystem::mkdir | ( | const Pathname & | path, |
unsigned | mode = 0755 |
||
) |
Like 'mkdir'.
Attempt to create a new directory named path. mode specifies the permissions to use. It is modified by the process's umask in the usual way.
Definition at line 305 of file PathInfo.cc.
int zypp::filesystem::assert_dir | ( | const Pathname & | path, |
unsigned | mode = 0755 |
||
) |
Like 'mkdir -p'.
No error if directory exists. Make parent directories as needed. mode specifies the permissions to use, if directories have to be created. It is modified by the process's umask in the usual way.
Definition at line 319 of file PathInfo.cc.
int zypp::filesystem::rmdir | ( | const Pathname & | path | ) |
Like 'rmdir'.
Delete a directory, which must be empty.
Definition at line 366 of file PathInfo.cc.
|
static |
Definition at line 380 of file PathInfo.cc.
int zypp::filesystem::recursive_rmdir | ( | const Pathname & | path | ) |
Like 'rm -r DIR'.
Delete a directory, recursively removing its contents.
Definition at line 412 of file PathInfo.cc.
int zypp::filesystem::clean_dir | ( | const Pathname & | path | ) |
Like 'rm -r DIR/ *'.
Delete directory contents, but keep the directory itself.
Definition at line 442 of file PathInfo.cc.
Like 'cp -a srcpath destpath'.
Copy directory tree. srcpath/destpath must be directories. 'basename srcpath' must not exist in destpath.
Definition at line 463 of file PathInfo.cc.
Like 'cp -a srcpath/.
destpath'. Copy the content of srcpath recursively into destpath. Both srcpath
and destpath
has to exists.
Definition at line 504 of file PathInfo.cc.
int zypp::filesystem::dirForEachImpl | ( | const Pathname & | dir_r, |
F && | fnc_r | ||
) |
Definition at line 547 of file PathInfo.cc.
int zypp::filesystem::dirForEach | ( | const Pathname & | dir_r, |
function< bool(const Pathname &, const char *const)> | fnc_r | ||
) |
Invoke callback function fnc_r for each entry in directory dir_r.
If fnc_r is a NULL
function 0
is returned immediately without even testing or accessing dir_r.
Otherwise readdir
is used to read the name of every entry in dir_r, omitting '
.' and '
..'. dir_r and the current entries name are passed as arguments to fnc_r. If fnc_r returns false
processing is aborted.
Definition at line 584 of file PathInfo.cc.
int zypp::filesystem::dirForEachExt | ( | const Pathname & | dir_r, |
const function< bool(const Pathname &, const DirEntry &)> & | fnc_r | ||
) |
Simiar to.
Definition at line 593 of file PathInfo.cc.
int zypp::filesystem::readdir | ( | std::list< std::string > & | retlist, |
const Pathname & | path, | ||
bool | dots = true |
||
) |
Return content of directory via retlist.
If dots is false entries starting with '.' are not reported. "." and ".." are never reported.
Returns just the directory entries as string.
Definition at line 605 of file PathInfo.cc.
int zypp::filesystem::readdir | ( | std::list< Pathname > & | retlist, |
const Pathname & | path, | ||
bool | dots = true |
||
) |
Return content of directory via retlist.
If dots is false entries starting with '.' are not reported. "." and ".." are never reported.
Returns the directory entries prefixed with path.
Definition at line 618 of file PathInfo.cc.
int zypp::filesystem::readdir | ( | DirContent & | retlist, |
const Pathname & | path, | ||
bool | dots = true , |
||
PathInfo::Mode | statmode = PathInfo::STAT |
||
) |
Return content of directory via retlist.
If dots is false entries starting with '.' are not reported. "." and ".." are never reported.
The type of individual directory entries is determined accoding to statmode (i.e. via stat or lstat).
Definition at line 669 of file PathInfo.cc.
std::ostream & zypp::filesystem::operator<< | ( | std::ostream & | str, |
const DirContent & | obj | ||
) |
Definition at line 681 of file PathInfo.cc.
int zypp::filesystem::is_empty_dir | ( | const Pathname & | path | ) |
Check if the specified directory is empty.
path | The path of the directory to check. |
Definition at line 688 of file PathInfo.cc.
int zypp::filesystem::unlink | ( | const Pathname & | path | ) |
Like 'unlink'.
Delete a file (symbolic link, socket, fifo or device).
Definition at line 700 of file PathInfo.cc.
Like 'rename'.
Renames a file, moving it between directories if required. It falls back to using mv(1) in case errno is set to EXDEV, indicating a cross-device rename, which is likely to happen when oldpath and newpath are not on the same OverlayFS layer.
Definition at line 742 of file PathInfo.cc.
Exchanges two files or directories.
Most common use is when building a new config file (or dir) in a tempfile. After the job is done, configfile and tempfile are exchanged. This includes moving away the configfile in case the tempfile does not exist. Parent directories are created as needed.
rename
, so take care both paths are located on the same filesystem.Definition at line 756 of file PathInfo.cc.
Like 'cp file dest'.
Copy file to destination file.
Definition at line 820 of file PathInfo.cc.
Like 'symlink'.
Creates a symbolic link named newpath which contains the string oldpath. If newpath exists it will not be overwritten.
Definition at line 855 of file PathInfo.cc.
Like '::link'.
Creates a hard link named newpath to an existing file oldpath. If newpath exists it will not be overwritten.
Definition at line 869 of file PathInfo.cc.
Create newpath as hardlink or copy of oldpath.
Definition at line 883 of file PathInfo.cc.
Like 'readlink'.
Return the contents of the symbolic link symlink_r via target_r.
Definition at line 924 of file PathInfo.cc.
Recursively follows the symlink pointed to by path_r and returns the Pathname to the real file or directory pointed to by the link.
There is a recursion limit of 256 iterations to protect against a cyclic link.
Definition at line 945 of file PathInfo.cc.
Like 'cp file dest'.
Copy file to dest dir.
Definition at line 990 of file PathInfo.cc.
std::string zypp::filesystem::md5sum | ( | const Pathname & | file | ) |
Compute a files md5sum.
Definition at line 1024 of file PathInfo.cc.
std::string zypp::filesystem::sha1sum | ( | const Pathname & | file | ) |
Compute a files sha1sum.
Definition at line 1041 of file PathInfo.cc.
std::string zypp::filesystem::checksum | ( | const Pathname & | file, |
const std::string & | algorithm | ||
) |
Compute a files checksum.
Definition at line 1051 of file PathInfo.cc.
check files checksum
Definition at line 1063 of file PathInfo.cc.
int zypp::filesystem::erase | ( | const Pathname & | path | ) |
Erase whatever happens to be located at path (file or directory).
Definition at line 1073 of file PathInfo.cc.
int zypp::filesystem::chmod | ( | const Pathname & | path, |
mode_t | mode | ||
) |
Like 'chmod'.
The mode of the file given by path is changed.
Definition at line 1092 of file PathInfo.cc.
int zypp::filesystem::addmod | ( | const Pathname & | path, |
mode_t | mode | ||
) |
Add the mode
bits to the file given by path.
Definition at line 1101 of file PathInfo.cc.
int zypp::filesystem::delmod | ( | const Pathname & | path, |
mode_t | mode | ||
) |
Remove the mode
bits from the file given by path.
Definition at line 1110 of file PathInfo.cc.
Definition at line 1124 of file PathInfo.cc.
Report free disk space on a mounted file system.
path is the path name of any file within the mounted filesystem.
Definition at line 1155 of file PathInfo.cc.
mode_t zypp::filesystem::getUmask | ( | ) |
Get the current umask (file mode creation mask)
Definition at line 1171 of file PathInfo.cc.
int zypp::filesystem::assert_file | ( | const Pathname & | path, |
unsigned | mode = 0644 |
||
) |
Create an empty file if it does not yet exist.
Make parent directories as needed. mode specifies the permissions to use. It is modified by the process's umask in the usual way.
Definition at line 1183 of file PathInfo.cc.
int zypp::filesystem::assert_file_mode | ( | const Pathname & | path, |
unsigned | mode | ||
) |
Like assert_file but enforce mode even if the file already exists.
Definition at line 1202 of file PathInfo.cc.
int zypp::filesystem::touch | ( | const Pathname & | path | ) |
Change file's modification and access times.
Definition at line 1234 of file PathInfo.cc.
|
inline |
Definition at line 514 of file PathInfo.h.
Definition at line 657 of file PathInfo.h.
|
inline |
Modify mode_r
according to the current umask ( mode_r & ~getUmask() )
.
Definition at line 789 of file PathInfo.h.
|
inline |
|
constexpr |
Definition at line 544 of file PathInfo.cc.