tools.hpp
Go to the documentation of this file.
/*********************************************************************/
// dar - disk archive - a backup/restoration program
// Copyright (C) 2002-2023 Denis Corbin
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
// to contact the author, see the AUTHOR file
/*********************************************************************/
#ifndef TOOLS_HPP
#define TOOLS_HPP
#include "../my_config.h"
extern "C"
{
#if STDC_HEADERS
#include <stdarg.h>
#endif
#if HAVE_SIGNAL_H
#include <signal.h>
#endif
#if HAVE_GPGME_H
#include <gpgme.h>
#endif
}
#include <string>
#include <vector>
#include <deque>
#include <map>
#include <set>
#include "path.hpp"
#include "infinint.hpp"
#include "generic_file.hpp"
#include "integers.hpp"
#include "tlv_list.hpp"
#include "datetime.hpp"
#include "entrepot.hpp"
namespace libdar
{
extern void tools_init();
extern void tools_end();
extern void tools_write_string(generic_file & f, const std::string & s);
extern void tools_read_string(generic_file & f, std::string & s);
extern void tools_write_string_all(generic_file & f, const std::string & s);
extern void tools_read_string_size(generic_file & f, std::string & s, infinint taille);
extern infinint tools_get_filesize(const path &p);
extern std::string tools_display_integer_in_metric_system(infinint number, const std::string & unit, bool binary);
extern std::string::iterator tools_find_last_char_of(std::string &s, unsigned char v);
extern void tools_blocking_read(int fd, bool mode);
extern std::string tools_name_of_uid(const infinint & uid);
extern std::string tools_name_of_gid(const infinint & gid);
extern std::string tools_uword2str(U_16 x);
extern std::string tools_int2str(S_I x);
extern std::string tools_uint2str(U_I x);
extern std::string tools_addspacebefore(std::string s, U_I expected_size);
extern std::string tools_display_date(const datetime & date);
extern char *tools_str2charptr(const std::string &x);
extern U_I tools_str2int(const std::string & x);
extern void tools_system(user_interaction & dialog, const std::vector<std::string> & argvector);
extern void tools_system_with_pipe(const std::shared_ptr<user_interaction> & dialog,
const std::string & dar_cmd,
const std::vector<std::string> & argvpipe);
extern void tools_write_vector(generic_file & f, const std::vector<std::string> & x);
extern void tools_read_vector(generic_file & f, std::vector<std::string> & x);
extern std::string tools_concat_vector(const std::string & separator,
const std::vector<std::string> & x);
std::vector<std::string> operator + (std::vector<std::string> a, std::vector<std::string> b);
extern bool tools_is_equal_with_hourshift(const infinint & hourshift, const datetime & date1, const datetime & date2);
template <class T> std::vector<T> operator +=(std::vector<T> & a, const std::vector<T> & b)
{
a = a + b;
return a;
}
extern std::string tools_readlink(const char *root);
extern void tools_noexcept_make_date(const std::string & chem, bool symlink, const datetime & last_acc, const datetime & last_mod, const datetime & birth);
extern void tools_make_date(const std::string & chemin, bool symlink, const datetime & access, const datetime & modif, const datetime & birth);
extern bool tools_is_case_insensitive_equal(const std::string & a, const std::string & b);
extern void tools_to_upper(const std::string & r, std::string & uppered);
#if HAVE_WCTYPE_H
extern void tools_to_wupper(std::wstring & r);
#endif
extern std::string tools_printf(const char *format, ...);
extern std::string tools_vprintf(const char *format, va_list ap);
extern bool tools_do_some_files_match_mask_regex(const entrepot & ent,
const std::string & file_mask);
extern void tools_unlink_file_mask_regex(user_interaction & dialog,
const entrepot & ent,
const std::string & file_mask,
bool info_details);
extern void tools_avoid_slice_overwriting_regex(user_interaction & dialog,
const entrepot & ent,
const std::string & basename,
const std::string & extension,
bool info_details,
bool allow_overwriting,
bool warn_overwriting,
bool dry_run);
extern bool tools_are_on_same_filesystem(const std::string & file1, const std::string & file2);
extern path tools_relative2absolute_path(const path & src, const path & cwd);
extern void tools_block_all_signals(sigset_t &old_mask);
extern void tools_set_back_blocked_signals(sigset_t old_mask);
extern U_I tools_count_in_string(const std::string & s, const char a);
extern datetime tools_get_mtime(user_interaction & dialog,
const std::string & s,
bool auto_zeroing,
bool silent,
const std::set<std::string> & ignored_as_symlink = std::set<std::string>());
extern infinint tools_get_size(const std::string & s);
extern infinint tools_get_extended_size(std::string s, U_I base);
extern std::string tools_substitute(const std::string & hook,
const std::map<char, std::string> & corres);
extern std::string tools_hook_substitute(const std::string & hook,
const std::string & path,
const std::string & basename,
const std::string & num,
const std::string & padded_num,
const std::string & ext,
const std::string & context,
const std::string & base_url);
extern void tools_hook_execute(user_interaction & ui,
const std::string & cmd_line);
extern void tools_hook_substitute_and_execute(user_interaction & ui,
const std::string & hook,
const std::string & path,
const std::string & basename,
const std::string & num,
const std::string & padded_num,
const std::string & ext,
const std::string & context,
const std::string & base_url);
extern std::string tools_output2xml(const std::string & src);
extern U_I tools_octal2int(const std::string & perm);
extern std::string tools_int2octal(const U_I & perm);
extern char tools_cast_type_to_unix_type(char type);
extern std::string tools_get_permission_string(char type, U_32 perm, bool hard);
extern void tools_set_permission(S_I fd, U_I perm);
extern U_I tools_get_permission(S_I fd);
extern uid_t tools_ownership2uid(const std::string & user);
extern uid_t tools_ownership2gid(const std::string & group);
extern void tools_set_ownership(S_I filedesc, const std::string & slice_user, const std::string & slice_group);
extern void tools_memxor(void *dest, const void *src, U_I n);
extern tlv_list tools_string2tlv_list(user_interaction & dialog, const U_16 & type, const std::vector<std::string> & data);
extern U_I tools_pseudo_random(U_I max);
template <class N, class B> std::deque<B> tools_number_base_decomposition_in_big_endian(N number, const B & base)
{
std::deque<B> ret;
if(base <= 0)
throw Erange("tools_number_decoupe_in_big_endian", "base must be strictly positive");
while(number != 0)
{
ret.push_back(number % base);
number /= base;
}
return ret;
}
extern std::string tools_unsigned_char_to_hexa(unsigned char x);
extern std::string tools_string_to_hexa(const std::string & input);
extern infinint tools_file_size_to_crc_size(const infinint & size);
extern std::string tools_getcwd();
extern std::string tools_get_compression_ratio(const infinint & storage_size, const infinint & file_size, bool compressed);
extern std::string tools_strerror_r(int errnum);
#ifdef GPGME_SUPPORT
extern std::string tools_gpgme_strerror_r(gpgme_error_t err);
#endif
#if HAVE_WCHAR_H
extern std::wstring tools_string_to_wstring(const std::string & val);
extern std::string tools_wstring_to_string(const std::wstring & val);
#endif
extern void tools_secu_string_show(user_interaction & dialog, const std::string & msg, const secu_string & key);
template <class T> T tools_max(T a, T b) { return a > b ? a : b; }
template <class T> T tools_min(T a, T b) { return a > b ? b : a; }
void tools_unlink(const std::string & filename);
extern std::string tools_escape_chars_in_string(const std::string & val, const char *to_escape);
extern bool tools_infinint2U_64(infinint val, U_64 & res);
extern bool tools_my_atoi(const char *a, U_I & val);
extern infinint tools_double2infinint(double arg);
template <class T> void tools_check_negative_date(T & val,
user_interaction & ui,
const char *inode_path,
const char *nature,
bool ask_before,
bool silent)
{
if(val < 0)
{
if(!silent)
{
std::string msg = tools_printf(gettext("Found negative date (%s) for inode %s ."),
nature,
inode_path);
if(ask_before)
ui.pause(tools_printf(gettext("%S Can we read it as if it was zero (1st January 1970 at 00:00:00 UTC)?"),
&msg));
else // just warn
ui.message(msg + gettext("Considering date as if it was zero (Jan 1970)"));
}
val = 0;
}
}
extern infinint tools_upper_rounded_log2(const infinint & ref);
extern infinint tools_lower_rounded_exp2(const infinint & ref);
extern infinint tools_rounded_square_root(const infinint & ref);
extern infinint tools_rounded_cube_root(const infinint & ref);
}
#endif
libdar::Erange
exception used to signal range error
Definition: erreurs.hpp:220
libdar::datetime
stores time information
Definition: datetime.hpp:59
libdar::entrepot
the Entrepot interface
Definition: entrepot.hpp:56
libdar::generic_file
this is the interface class from which all other data transfer classes inherit
Definition: generic_file.hpp:77
libdar::infinint
the arbitrary large positive integer class
Definition: real_infinint.hpp:62
libdar::path
the class path is here to manipulate paths in the Unix notation: using'/'
Definition: path.hpp:51
libdar::secu_string
class secu_string
Definition: secu_string.hpp:54
libdar::user_interaction
This is a pure virtual class that is used by libdar when interaction with the user is required.
Definition: user_interaction.hpp:47
datetime.hpp
this file contains the definition of class datetime that stores unix times in a portable way
entrepot.hpp
defines the entrepot interface.
generic_file.hpp
class generic_file is defined here as well as class fichier
libdar::tools_is_equal_with_hourshift
bool tools_is_equal_with_hourshift(const infinint &hourshift, const datetime &date1, const datetime &date2)
test if two dates are equal taking care of a integer hour of difference
libdar::tools_check_negative_date
void tools_check_negative_date(T &val, user_interaction &ui, const char *inode_path, const char *nature, bool ask_before, bool silent)
check the value is not negative, and if asked set it to zero
Definition: tools.hpp:671
libdar::tools_secu_string_show
void tools_secu_string_show(user_interaction &dialog, const std::string &msg, const secu_string &key)
display the content of a secu_string, this function is only for trouble shooting!
libdar::tools_set_back_blocked_signals
void tools_set_back_blocked_signals(sigset_t old_mask)
unblock signals according to given mask
libdar::tools_system
void tools_system(user_interaction &dialog, const std::vector< std::string > &argvector)
wrapper to the "system" system call.
libdar::tools_escape_chars_in_string
std::string tools_escape_chars_in_string(const std::string &val, const char *to_escape)
escape with a anti-slash character a set of chars found in the given string
libdar::tools_get_compression_ratio
std::string tools_get_compression_ratio(const infinint &storage_size, const infinint &file_size, bool compressed)
return the string about compression ratio
libdar::tools_unlink
void tools_unlink(const std::string &filename)
remove from filesystem the file which path is given
libdar::tools_uword2str
std::string tools_uword2str(U_16 x)
convert unsigned word to string
libdar::tools_read_string
void tools_read_string(generic_file &f, std::string &s)
read a string from a file expecting it to terminate by '\0'
libdar::tools_infinint2U_64
bool tools_infinint2U_64(infinint val, U_64 &res)
convert an infinint to U_64 (aka "uint64_t" or yet "unsigned long long")
libdar::tools_are_on_same_filesystem
bool tools_are_on_same_filesystem(const std::string &file1, const std::string &file2)
tells whether two files are on the same mounted filesystem
libdar::tools_addspacebefore
std::string tools_addspacebefore(std::string s, U_I expected_size)
prepend spaces before the given string
libdar::tools_number_base_decomposition_in_big_endian
std::deque< B > tools_number_base_decomposition_in_big_endian(N number, const B &base)
Template for the decomposition of any number in any base (decimal, octal, hexa, etc....
Definition: tools.hpp:577
libdar::tools_to_upper
void tools_to_upper(const std::string &r, std::string &uppered)
convert a string to upper case
libdar::tools_write_string_all
void tools_write_string_all(generic_file &f, const std::string &s)
write a string to a file, '\0' has no special meaning nor is added at the end
libdar::tools_avoid_slice_overwriting_regex
void tools_avoid_slice_overwriting_regex(user_interaction &dialog, const entrepot &ent, const std::string &basename, const std::string &extension, bool info_details, bool allow_overwriting, bool warn_overwriting, bool dry_run)
prevents slice overwriting: check the presence of slice and if necessary ask the user if they can be ...
libdar::tools_display_integer_in_metric_system
std::string tools_display_integer_in_metric_system(infinint number, const std::string &unit, bool binary)
libdar::tools_read_string_size
void tools_read_string_size(generic_file &f, std::string &s, infinint taille)
read a string if given size from a file '\0' has no special meaning
libdar::tools_get_extended_size
infinint tools_get_extended_size(std::string s, U_I base)
convert the given string to infinint taking care of multiplication suffixes like k,...
libdar::tools_set_permission
void tools_set_permission(S_I fd, U_I perm)
change the permission of the file which descriptor is given
libdar::tools_double2infinint
infinint tools_double2infinint(double arg)
convert a double (float) to infinint (integer) taking care of rounding it to the closest value
libdar::tools_int2octal
std::string tools_int2octal(const U_I &perm)
convert a number to a string corresponding to its octal representation
libdar::tools_block_all_signals
void tools_block_all_signals(sigset_t &old_mask)
block all signals (based on POSIX sigprocmask)
libdar::tools_is_case_insensitive_equal
bool tools_is_case_insensitive_equal(const std::string &a, const std::string &b)
compare two string in case insensitive manner
libdar::tools_count_in_string
U_I tools_count_in_string(const std::string &s, const char a)
counts the number of a given char in a given string
libdar::tools_ownership2gid
uid_t tools_ownership2gid(const std::string &group)
convert string group name or gid to numeric gid value
libdar::tools_write_vector
void tools_write_vector(generic_file &f, const std::vector< std::string > &x)
write a list of string to file
libdar::tools_get_size
infinint tools_get_size(const std::string &s)
returns the size of the given plain file
libdar::tools_end
void tools_end()
libdar internal use only: it is launched from close_and_clean() and releases tools internal variables
libdar::tools_string_to_hexa
std::string tools_string_to_hexa(const std::string &input)
convert a string into its hexadecima representation
libdar::tools_strerror_r
std::string tools_strerror_r(int errnum)
wrapper routine to strerror_r
libdar::tools_file_size_to_crc_size
infinint tools_file_size_to_crc_size(const infinint &size)
Defines the CRC size to use for a given filesize.
libdar::tools_ownership2uid
uid_t tools_ownership2uid(const std::string &user)
change ownership of the file which descriptor is given
libdar::tools_hook_execute
void tools_hook_execute(user_interaction &ui, const std::string &cmd_line)
execute and retries at user will a given command line
libdar::tools_memxor
void tools_memxor(void *dest, const void *src, U_I n)
Produces in "dest" the XORed value of "dest" and "src".
libdar::tools_noexcept_make_date
void tools_noexcept_make_date(const std::string &chem, bool symlink, const datetime &last_acc, const datetime &last_mod, const datetime &birth)
set dates of a given file, no exception thrown
libdar::tools_relative2absolute_path
path tools_relative2absolute_path(const path &src, const path &cwd)
transform a relative path to an absolute one given the current directory value
libdar::tools_display_date
std::string tools_display_date(const datetime &date)
convert a date in second to its human readable representation
libdar::tools_readlink
std::string tools_readlink(const char *root)
returns the file pointed to by a symbolic link (or transparent if the file is not a symlink).
libdar::tools_upper_rounded_log2
infinint tools_upper_rounded_log2(const infinint &ref)
compute an approximate log2 of the argument
libdar::tools_str2charptr
char * tools_str2charptr(const std::string &x)
convert a string to a char *
libdar::tools_get_permission
U_I tools_get_permission(S_I fd)
obtain the permission of the file which descriptor is given
libdar::tools_getcwd
std::string tools_getcwd()
get current working directory
libdar::tools_octal2int
U_I tools_octal2int(const std::string &perm)
convert octal string to integer
libdar::tools_get_mtime
datetime tools_get_mtime(user_interaction &dialog, const std::string &s, bool auto_zeroing, bool silent, const std::set< std::string > &ignored_as_symlink=std::set< std::string >())
returns the last modification date of the given file
libdar::tools_blocking_read
void tools_blocking_read(int fd, bool mode)
set blocking/not blocking mode for reading on a file descriptor
libdar::tools_output2xml
std::string tools_output2xml(const std::string &src)
convert string for xml output
libdar::tools_pseudo_random
U_I tools_pseudo_random(U_I max)
Produces a pseudo random number x, where 0 <= x < max.
libdar::tools_cast_type_to_unix_type
char tools_cast_type_to_unix_type(char type)
change the libdar internal type representation to the usual unix char type
libdar::tools_hook_substitute_and_execute
void tools_hook_substitute_and_execute(user_interaction &ui, const std::string &hook, const std::string &path, const std::string &basename, const std::string &num, const std::string &padded_num, const std::string &ext, const std::string &context, const std::string &base_url)
subsititue and execute command line
libdar::tools_rounded_square_root
infinint tools_rounded_square_root(const infinint &ref)
compute an approximate square root of the argument
libdar::tools_system_with_pipe
void tools_system_with_pipe(const std::shared_ptr< user_interaction > &dialog, const std::string &dar_cmd, const std::vector< std::string > &argvpipe)
wrapper to the "system" system call using anonymous pipe to tranmit arguments to the child process
libdar::tools_hook_substitute
std::string tools_hook_substitute(const std::string &hook, const std::string &path, const std::string &basename, const std::string &num, const std::string &padded_num, const std::string &ext, const std::string &context, const std::string &base_url)
produces the string resulting from the substitution of %... macro
libdar::tools_find_last_char_of
std::string::iterator tools_find_last_char_of(std::string &s, unsigned char v)
give a pointer to the last character of the given value in the given string
libdar::tools_rounded_cube_root
infinint tools_rounded_cube_root(const infinint &ref)
compute an approximate cube root of the argument
libdar::tools_name_of_gid
std::string tools_name_of_gid(const infinint &gid)
convert gid to name in regards of the current system's configuration
libdar::tools_unlink_file_mask_regex
void tools_unlink_file_mask_regex(user_interaction &dialog, const entrepot &ent, const std::string &file_mask, bool info_details)
remove files from a given directory
libdar::tools_write_string
void tools_write_string(generic_file &f, const std::string &s)
write a string to a file with a '\0' at then end
libdar::tools_concat_vector
std::string tools_concat_vector(const std::string &separator, const std::vector< std::string > &x)
concatenate a vectors of strings in a single string
libdar::tools_lower_rounded_exp2
infinint tools_lower_rounded_exp2(const infinint &ref)
compute an approximate exp2 of the argument
libdar::tools_set_ownership
void tools_set_ownership(S_I filedesc, const std::string &slice_user, const std::string &slice_group)
change ownership of the file which descriptor is given
libdar::tools_printf
std::string tools_printf(const char *format,...)
make printf-like formating to a std::string
libdar::tools_my_atoi
bool tools_my_atoi(const char *a, U_I &val)
ascii to integer conversion
libdar::tools_int2str
std::string tools_int2str(S_I x)
convert integer to string
libdar::tools_get_permission_string
std::string tools_get_permission_string(char type, U_32 perm, bool hard)
convert a permission number into its string representation (rwxrwxrwx)
libdar::tools_substitute
std::string tools_substitute(const std::string &hook, const std::map< char, std::string > &corres)
produce the string resulting from the substition of % macro defined in the map
libdar::tools_str2int
U_I tools_str2int(const std::string &x)
convert an integer written in decimal notation to the corresponding value
libdar::operator+=
std::vector< T > operator+=(std::vector< T > &a, const std::vector< T > &b)
template function to add two vectors
Definition: tools.hpp:230
libdar::tools_do_some_files_match_mask_regex
bool tools_do_some_files_match_mask_regex(const entrepot &ent, const std::string &file_mask)
test the presence of files corresponding to a given mask in a directory (regex mask)
libdar::tools_init
void tools_init()
libdar internal use only: it is launched from get_version() and initializes tools internal variables
libdar::tools_unsigned_char_to_hexa
std::string tools_unsigned_char_to_hexa(unsigned char x)
convert a unsigned char into its hexa decima representation
libdar::tools_get_filesize
infinint tools_get_filesize(const path &p)
retrieve the size in byte of a file
libdar::tools_string2tlv_list
tlv_list tools_string2tlv_list(user_interaction &dialog, const U_16 &type, const std::vector< std::string > &data)
Produces a list of TLV from a constant type and a list of string.
libdar::tools_vprintf
std::string tools_vprintf(const char *format, va_list ap)
make printf-like formating to a std::string
libdar::tools_name_of_uid
std::string tools_name_of_uid(const infinint &uid)
convert uid to name in regards to the current system's configuration
libdar::tools_make_date
void tools_make_date(const std::string &chemin, bool symlink, const datetime &access, const datetime &modif, const datetime &birth)
set dates of a given file, may throw exception
libdar::tools_read_vector
void tools_read_vector(generic_file &f, std::vector< std::string > &x)
read a list of string from a file
infinint.hpp
switch module to limitint (32 ou 64 bits integers) or infinint
integers.hpp
are defined here basic integer types that tend to be portable
libdar
libdar namespace encapsulate all libdar symbols
Definition: archive.hpp:47
path.hpp
here is the definition of the path class
tlv_list.hpp
List of Generic Type Length Value data structures.