Disk ARchive  2.7.15
Full featured and portable backup and archiving tool
cat_mirage.hpp
Go to the documentation of this file.
1 /*********************************************************************/
2 // dar - disk archive - a backup/restoration program
3 // Copyright (C) 2002-2024 Denis Corbin
4 //
5 // This program is free software; you can redistribute it and/or
6 // modify it under the terms of the GNU General Public License
7 // as published by the Free Software Foundation; either version 2
8 // of the License, or (at your option) any later version.
9 //
10 // This program is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 // GNU General Public License for more details.
14 //
15 // You should have received a copy of the GNU General Public License
16 // along with this program; if not, write to the Free Software
17 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18 //
19 // to contact the author, see the AUTHOR file
20 /*********************************************************************/
21 
25 
26 #ifndef CAT_MIRAGE_HPP
27 #define CAT_MIRAGE_HPP
28 
29 #include "../my_config.h"
30 
31 extern "C"
32 {
33 } // end extern "C"
34 
35 #include "cat_nomme.hpp"
36 #include "cat_etoile.hpp"
37 
38 namespace libdar
39 {
40 
43 
45 
47  class cat_mirage : public cat_nomme
48  {
49  public:
53  fmt_file_etiquette };
54 
55  cat_mirage(const std::string & name, cat_etoile *ref): cat_nomme(name, saved_status::saved) { dup_on(ref); };
56  cat_mirage(const std::shared_ptr<user_interaction> & dialog,
57  const smart_pointer<pile_descriptor> & pdesc,
58  const archive_version & reading_ver,
59  saved_status saved,
60  entree_stats & stats,
61  std::map <infinint, cat_etoile *> & corres,
62  compression default_algo,
63  mirage_format fmt,
64  bool lax,
65  bool small);
66  cat_mirage(const std::shared_ptr<user_interaction> & dialog,
67  const smart_pointer<pile_descriptor> & pdesc,
68  const archive_version & reading_ver,
69  saved_status saved,
70  entree_stats & stats,
71  std::map <infinint, cat_etoile *> & corres,
72  compression default_algo,
73  bool lax,
74  bool small);
75  cat_mirage(const cat_mirage & ref) : cat_nomme (ref) { dup_on(ref.star_ref); };
76  cat_mirage(cat_mirage && ref) noexcept: cat_nomme(std::move(ref)) { try { dup_on(ref.star_ref); } catch(...) {}; };
77  cat_mirage & operator = (const cat_mirage & ref);
78  cat_mirage & operator = (cat_mirage && ref);
79  ~cat_mirage() { star_ref->drop_ref(this); };
80 
81  virtual bool operator == (const cat_entree & ref) const override;
82 
83  virtual unsigned char signature() const override { return 'm'; };
84  virtual std::string get_description() const override { return "hard linked inode"; };
85 
86  virtual cat_entree *clone() const override { return new (std::nothrow) cat_mirage(*this); };
87 
88  cat_inode *get_inode() const { if(star_ref == nullptr) throw SRC_BUG; return star_ref->get_inode(); };
89  infinint get_etiquette() const { return star_ref->get_etiquette(); };
90  infinint get_etoile_ref_count() const { return star_ref->get_ref_count(); };
91  cat_etoile *get_etoile() const { return star_ref; };
92 
93  bool is_inode_counted() const { return star_ref->is_counted(); };
94  bool is_inode_wrote() const { return star_ref->is_wrote(); };
95  bool is_inode_dumped() const { return star_ref->is_dumped(); };
96  void set_inode_counted(bool val) const { star_ref->set_counted(val); };
97  void set_inode_wrote(bool val) const { star_ref->set_wrote(val); };
98  void set_inode_dumped(bool val) const { star_ref->set_dumped(val); };
99 
100  virtual void post_constructor(const pile_descriptor & pdesc) override;
101 
103  bool is_first_mirage() const { return star_ref->get_first_ref() == this; };
104 
105  // overwriting virtual method from cat_entree
106  virtual void change_location(const smart_pointer<pile_descriptor> & pdesc) override { get_inode()->change_location(pdesc); };
107 
109 
117  void disable_reduction_to_normal_inode() { star_ref->disable_reduction_to_normal_inode(); };
118 
119  protected:
120  virtual void inherited_dump(const pile_descriptor & pdesc, bool small) const override;
121 
122  private:
123  cat_etoile *star_ref;
124 
125  void init(const std::shared_ptr<user_interaction> & dialog,
126  const smart_pointer<pile_descriptor> & pdesc,
127  const archive_version & reading_ver,
128  saved_status saved,
129  entree_stats & stats,
130  std::map <infinint, cat_etoile *> & corres,
131  compression default_algo,
132  mirage_format fmt,
133  bool lax,
134  bool small);
135 
136  void dup_on(cat_etoile * ref);
137  };
138 
140 
141 } // end of namespace
142 
143 #endif
class holding an cat_inode object that get pointed by multiple mirage objects (smart pointers) to rec...
base class of all objects contained in a catalogue and that can be named
class archive_version manages the version of the archive format
the root class from all other inherite for any entry in the catalogue
Definition: cat_entree.hpp:60
virtual void change_location(const smart_pointer< pile_descriptor > &pdesc)
the hard link implementation
Definition: cat_etoile.hpp:48
the root class for all cat_inode
Definition: cat_inode.hpp:53
the hard link implementation, cat_mirage is the named entry owned by a directory it points to a commo...
Definition: cat_mirage.hpp:48
virtual std::string get_description() const override
inherited class designation
Definition: cat_mirage.hpp:84
mirage_format
format of mirage
Definition: cat_mirage.hpp:51
@ fmt_hard_link
old dual format
Definition: cat_mirage.hpp:52
@ fmt_mirage
new format
Definition: cat_mirage.hpp:51
virtual void post_constructor(const pile_descriptor &pdesc) override
let inherited classes build object's data after CRC has been read from file in small read mode
virtual bool operator==(const cat_entree &ref) const override
returns true if the two object are the same
virtual void change_location(const smart_pointer< pile_descriptor > &pdesc) override
Definition: cat_mirage.hpp:106
virtual void inherited_dump(const pile_descriptor &pdesc, bool small) const override
inherited class may overload this method but shall first call the parent's inherited_dump() in the ov...
virtual cat_entree * clone() const override
a way to copy the exact type of an object even if pointed to by a parent class pointer
Definition: cat_mirage.hpp:86
bool is_first_mirage() const
whether we are the mirage that triggered this hard link creation
Definition: cat_mirage.hpp:103
void disable_reduction_to_normal_inode()
always write the inode as a hardlinked inode
Definition: cat_mirage.hpp:117
virtual unsigned char signature() const override
inherited class signature
Definition: cat_mirage.hpp:83
the base class for all entry that have a name
Definition: cat_nomme.hpp:45
compression
the different compression algorithm available
Definition: compression.hpp:46
saved_status
data saved status for an entry
Definition: cat_status.hpp:45
@ saved
inode is saved in the archive
libdar namespace encapsulate all libdar symbols
Definition: archive.hpp:47
holds the statistics contents of a catalogue