/usr/include/dar/cat_directory.hpp is in libdar-dev 2.5.14+bis-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 | /*********************************************************************/
// dar - disk archive - a backup/restoration program
// Copyright (C) 2002-2052 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
//
// to contact the author : http://dar.linux.free.fr/email.html
/*********************************************************************/
/// \file cat_directory.hpp
/// \brief class used to organize objects in tree in catalogue as like directories in a filesystem
/// \ingroup Private
#ifndef CAT_DIRECTORY_HPP
#define CAT_DIRECTORY_HPP
#include "/usr/include/dar/libdar_my_config.h"
extern "C"
{
} // end extern "C"
#ifdef LIBDAR_FAST_DIR
#include <map>
#endif
#include <list>
#include "/usr/include/dar/cat_inode.hpp"
#include "/usr/include/dar/cat_tools.hpp"
namespace libdar
{
class cat_eod;
/// \addtogroup Private
/// @{
/// the cat_directory inode class
class cat_directory : public cat_inode
{
public :
cat_directory(const infinint & xuid,
const infinint & xgid,
U_16 xperm,
const datetime & last_access,
const datetime & last_modif,
const datetime & last_change,
const std::string & xname,
const infinint & device);
cat_directory(const cat_directory &ref); // only the inode part is build, no children is duplicated (empty dir)
const cat_directory & operator = (const cat_directory & ref); // set the inode part *only* no subdirectories/subfiles are copies or removed.
cat_directory(user_interaction & dialog,
const smart_pointer<pile_descriptor> & pdesc,
const archive_version & reading_ver,
saved_status saved,
entree_stats & stats,
std::map <infinint, cat_etoile *> & corres,
compression default_algo,
bool lax,
bool only_detruit, // objects of other class than detruit and cat_directory are not built in memory
bool small);
~cat_directory() throw(Ebug); // detruit aussi tous les fils et se supprime de son 'parent'
/// attention this compares only the directories themselves, not the list of their children
bool operator == (const cat_entree & ref) const;
void add_children(cat_nomme *r); // when r is a cat_directory, 'parent' is set to 'this'
bool has_children() const { return !ordered_fils.empty(); };
void reset_read_children() const;
void end_read() const;
bool read_children(const cat_nomme * &r) const; // read the direct children of the cat_directory, returns false if no more is available
// remove all entry not yet read by read_children
void tail_to_read_children();
/// remove the given entry from the catalogue
///
/// \note read_children() is taken into account by this operation,
/// no need to call reset_read_children(), if the argument removed was the
/// one about to be read by read_children() the one following the removed entry
/// will be returned the next time read_children() is invoked.
void remove(const std::string & name);
cat_directory * get_parent() const { return parent; };
bool search_children(const std::string &name, const cat_nomme *&ref) const;
bool callback_for_children_of(user_interaction & dialog, const std::string & sdir, bool isolated = false) const;
// using is_more_recent_than() from cat_inode class
// using method has_changed_since() from cat_inode class
unsigned char signature() const { return mk_signature('d', get_saved_status()); };
/// detemine whether some data has changed since archive of reference in this cat_directory or subdirectories
bool get_recursive_has_changed() const { return recursive_has_changed; };
/// ask recursive update for the recursive_has_changed field
void recursive_has_changed_update() const;
/// get then number of "cat_nomme" entry contained in this cat_directory and subdirectories (recursive call)
infinint get_tree_size() const;
/// get the number of entry having some EA set in the cat_directory tree (recursive call)
infinint get_tree_ea_num() const;
/// get the number of entry that are hard linked inode (aka mirage in dar implementation) (recursive call)
infinint get_tree_mirage_num() const;
// for each mirage found (hard link implementation) in the cat_directory tree, add its etiquette to the returned
// list with the number of reference that has been found in the tree. (map[etiquette] = number of occurence)
// from outside of class cat_directory, the given argument is expected to be an empty map.
void get_etiquettes_found_in_tree(std::map<infinint, infinint> & already_found) const;
/// whether this cat_directory is empty or not
bool is_empty() const { return ordered_fils.empty(); };
/// recursively remove all mirage entries
void remove_all_mirages_and_reduce_dirs();
/// recursively set all mirage inode_wrote flag
void set_all_mirage_s_inode_wrote_field_to(bool val);
/// set the value of inode_dumped for all mirage (recusively)
void set_all_mirage_s_inode_dumped_field_to(bool val);
cat_entree *clone() const { return new (get_pool()) cat_directory(*this); };
const infinint & get_size() const { recursive_update_sizes(); return x_size; };
const infinint & get_storage_size() const { recursive_update_sizes(); return x_storage_size; };
void recursively_set_to_unsaved_data_and_FSA();
/// overwrite virtual method of cat_entree to propagate the action to all entries of the directory tree
void change_location(const smart_pointer<pile_descriptor> & pdesc);
protected:
void inherited_dump(const pile_descriptor & pdesc, bool small) const;
private:
static const cat_eod fin;
infinint x_size;
infinint x_storage_size;
bool updated_sizes;
cat_directory *parent;
#ifdef LIBDAR_FAST_DIR
std::map<std::string, cat_nomme *> fils; // used for fast lookup
#endif
std::list<cat_nomme *> ordered_fils;
std::list<cat_nomme *>::iterator it; //< next to entry to be returned by read_children
bool recursive_has_changed;
void clear();
void recursive_update_sizes() const;
void recursive_flag_size_to_update() const;
};
/// @}
} // end of namespace
#endif
|