| Disk ARchive 2.7.18 Full featured and portable backup and archiving tool

Loading...
Searching...
No Matches
cat_delta_signature.hpp
Go to the documentation of this file.
1/*********************************************************************/
2// dar - disk archive - a backup/restoration program
3// Copyright (C) 2002-2025 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_DELTA_SIGNATURE_HPP
27#define CAT_DELTA_SIGNATURE_HPP
28
29#include "../my_config.h"
30
31 extern "C"
32{
33} // end extern "C"
34
35#include "memory_file.hpp"
36#include "crc.hpp"
37#include "proto_compressor.hpp"
38#include "archive_version.hpp"
39
40#include <memory>
41
42 namespace libdar
43{
44
47
48 // Datastructure in archive (DATA+METADATA)
49 //
50 // SEQUENTIAL MODE - in the core of the archive
51 // +------+------+-----------+--------------+----------+--------+
52 // | base | sig | sig block |sig data | data CRC | result |
53 // | CRC | size | len (if |(if size > 0) | if | CRC |
54 // | (*) | | size > 0) | | size > 0 | |
55 // +------+------+-----------+--------------+----------+--------+
56 //
57 // DIRECT MODE - in catalogue at end of archive (METADATA)
58 // +------+------+---------------+--------+
59 // | base | sig | sig offset | result |
60 // | CRC | size | (if size > 0) | CRC |
61 // | (*) | | | |
62 // +------+------+---------------+--------+
63 //
64 // DIRECT MODE - in the core of the archive (DATA)
65 // +-----------+---------------+----------+
66 // | sig block | sig data | data CRC |
67 // | len (if | (if size > 0) | if |
68 // | size > 0) | | size > 0 |
69 // +-----------+---------------+----------+
70 //
71 // (*) base_CRC has been moved to cat_file structure since format 11,2
72 // in order to read this field before the delta patch in sequential read mode
73 //
74 // this structure is used for all cat_file inode that have
75 // either a delta signature or contain a delta patch (s_delta status)
76 // base_crc is used to check we apply the patch on the good file before proceeding
77 // result_crc is used to store the crc of the file the signature has been computed on
78 // result_crc is also used once a patch has been applied to verify the correctness of the patch result
79
80
82
93 class cat_delta_signature
94 {
95 public:
97
103 cat_delta_signature(generic_file *f, proto_compressor* c);
104
106 cat_delta_signature() { init(); };
107
109 cat_delta_signature(const cat_delta_signature & ref) { init(); copy_from(ref); };
110
112 cat_delta_signature(cat_delta_signature && ref) noexcept { init(); move_from(std::move(ref)); };
113
115 cat_delta_signature & operator = (const cat_delta_signature & ref) { clear(); copy_from(ref); return *this; };
116
118 cat_delta_signature & operator = (cat_delta_signature && ref) noexcept { move_from(std::move(ref)); return *this; };
119
121 ~cat_delta_signature() { destroy(); };
122
124
126 bool is_pending_read() const { return pending_read; };
127
131 void read(bool sequential_read, const archive_version & ver);
132
134 bool can_obtain_sig() const { return !delta_sig_size.is_zero(); };
135
137
141 std::shared_ptr<memory_file> obtain_sig(const archive_version & ver) const;
142
144 U_I obtain_sig_block_size() const { return sig_block_len; };
145
147
150 void drop_sig() const { sig.reset(); };
151
153
155
157
159 void will_have_signature() { delta_sig_size = 1; };
160
162
165 void set_sig(const std::shared_ptr<memory_file> & ptr, U_I sig_block_size);
166
168 void set_sig() { delta_sig_size = 0; delta_sig_offset = 0; sig_block_len = 0; sig.reset(); };
169
171
174 void dump_data(generic_file & f, bool sequential_mode, const archive_version & ver) const;
175
177 void dump_metadata(generic_file & f) const;
178
179
181
183 bool has_patch_base_crc() const { return patch_base_check != nullptr; };
184
186 bool get_patch_base_crc(const crc * & c) const;
187
189 void set_patch_base_crc(const crc & c);
190
192 bool has_patch_result_crc() const { return patch_result_check != nullptr; };
193
195 bool get_patch_result_crc(const crc * & c) const;
196
198 void set_patch_result_crc(const crc & c);
199
201 void clear() { destroy(); init(); };
202
203 private:
204 crc *patch_base_check;
205 infinint delta_sig_size;
206 infinint delta_sig_offset;
208 mutable std::shared_ptr<memory_file>sig;
209 crc *patch_result_check;
210 generic_file *src;
211 proto_compressor *zip;
212 mutable U_I sig_block_len;
213 bool pending_read;
214
215 void init() noexcept;
216 void copy_from(const cat_delta_signature & ref);
217 void move_from(cat_delta_signature && ref) noexcept;
218 void destroy() noexcept;
219
220 // reads sig_block_len + sig data
221 void fetch_data(const archive_version & ver) const;
222 };
223
225
226} // end of namespace
227
228#endif
archive_version.hpp
class archive_version that rules which archive format to follow
libdar::archive_version
class archive_version manages the version of the archive format
Definition archive_version.hpp:47
libdar::cat_delta_signature
the cat_delta_signature file class
Definition cat_delta_signature.hpp:94
libdar::cat_delta_signature::pending_read
bool pending_read
when the object has been created for read but data not yet read from archive
Definition cat_delta_signature.hpp:213
libdar::cat_delta_signature::obtain_sig
std::shared_ptr< memory_file > obtain_sig(const archive_version &ver) const
provide a memory_file object which the caller has the duty to destroy after use
libdar::cat_delta_signature::delta_sig_size
infinint delta_sig_size
size of the data to setup "sig" (set to zero when reading in sequential mode, sig is then setup on-fl...
Definition cat_delta_signature.hpp:205
libdar::cat_delta_signature::dump_metadata
void dump_metadata(generic_file &f) const
write down the delta_signature metadata for catalogue
libdar::cat_delta_signature::get_patch_result_crc
bool get_patch_result_crc(const crc *&c) const
returns the CRC the file will have once restored or patched (for s_saved, s_delta,...
libdar::cat_delta_signature::cat_delta_signature
cat_delta_signature(const cat_delta_signature &ref)
copy constructor
Definition cat_delta_signature.hpp:109
libdar::cat_delta_signature::has_patch_base_crc
bool has_patch_base_crc() const
returns whether the object has a base patch CRC (s_delta status objects)
Definition cat_delta_signature.hpp:183
libdar::cat_delta_signature::drop_sig
void drop_sig() const
drop signature but keep metadata available
Definition cat_delta_signature.hpp:150
libdar::cat_delta_signature::cat_delta_signature
cat_delta_signature()
constructor to write an object to filesytem/backup (using dump_* methods later on)
Definition cat_delta_signature.hpp:106
libdar::cat_delta_signature::read
void read(bool sequential_read, const archive_version &ver)
libdar::cat_delta_signature::set_sig
void set_sig()
variante used when the delta_signature object will only contain CRCs (no delta signature)
Definition cat_delta_signature.hpp:168
libdar::cat_delta_signature::get_patch_base_crc
bool get_patch_base_crc(const crc *&c) const
returns the CRC of the file to base the patch on, for s_delta objects
libdar::cat_delta_signature::can_obtain_sig
bool can_obtain_sig() const
the cat_delta_signature structure can only hold CRC without delta_signature, this call gives the situ...
Definition cat_delta_signature.hpp:134
libdar::cat_delta_signature::will_have_signature
void will_have_signature()
give the object where to fetch from the delta signature, object must exist up to the next call to dum...
Definition cat_delta_signature.hpp:159
libdar::cat_delta_signature::clear
void clear()
reset the object
Definition cat_delta_signature.hpp:201
libdar::cat_delta_signature::sig_block_len
U_I sig_block_len
block length used within delta signature
Definition cat_delta_signature.hpp:212
libdar::cat_delta_signature::has_patch_result_crc
bool has_patch_result_crc() const
returns whether the object has a CRC corresponding to data (for s_saved, s_delta, and when delta sign...
Definition cat_delta_signature.hpp:192
libdar::cat_delta_signature::cat_delta_signature
cat_delta_signature(cat_delta_signature &&ref) noexcept
move constructor
Definition cat_delta_signature.hpp:112
libdar::cat_delta_signature::set_patch_base_crc
void set_patch_base_crc(const crc &c)
set the reference CRC of the file to base the patch on, for s_detla objects
libdar::cat_delta_signature::set_patch_result_crc
void set_patch_result_crc(const crc &c)
set the CRC the file will have once restored or patched (for s_saved, s_delta, and when delta signatu...
libdar::cat_delta_signature::set_sig
void set_sig(const std::shared_ptr< memory_file > &ptr, U_I sig_block_size)
the object pointed to by ptr must stay available when calling dump_data()/dump_metadata() later on
libdar::cat_delta_signature::dump_data
void dump_data(generic_file &f, bool sequential_mode, const archive_version &ver) const
write down the data eventually with sequential read mark followed by delta sig metadata
libdar::cat_delta_signature::patch_base_check
crc * patch_base_check
associated CRC for the file this signature has been computed on, moved to cat_file since format 11....
Definition cat_delta_signature.hpp:204
libdar::cat_delta_signature::is_pending_read
bool is_pending_read() const
tells whether the read() call has been invoked
Definition cat_delta_signature.hpp:126
libdar::cat_delta_signature::obtain_sig_block_size
U_I obtain_sig_block_size() const
provide the block size used for delta signature
Definition cat_delta_signature.hpp:144
libdar::cat_delta_signature::sig
std::shared_ptr< memory_file > sig
the signature data, if set nullptr it will be fetched from f in direct access mode only
Definition cat_delta_signature.hpp:208
libdar::cat_delta_signature::patch_result_check
crc * patch_result_check
associated CRC
Definition cat_delta_signature.hpp:209
libdar::cat_delta_signature::zip
proto_compressor * zip
needed to disable compression when reading delta signature data from an archive
Definition cat_delta_signature.hpp:211
libdar::cat_delta_signature::~cat_delta_signature
~cat_delta_signature()
destructor
Definition cat_delta_signature.hpp:121
libdar::cat_delta_signature::src
generic_file * src
where to read data from
Definition cat_delta_signature.hpp:210
libdar::cat_delta_signature::delta_sig_offset
infinint delta_sig_offset
Definition cat_delta_signature.hpp:206
libdar::cat_delta_signature::cat_delta_signature
cat_delta_signature(generic_file *f, proto_compressor *c)
constructor to read an object (using read() later on) from filesystem/backup
libdar::cat_delta_signature::operator=
cat_delta_signature & operator=(const cat_delta_signature &ref)
assignement operator
Definition cat_delta_signature.hpp:115
libdar::crc
pure virtual class defining interface of a CRC object
Definition crc.hpp:47
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
crc.hpp
class crc definition, used to handle Cyclic Redundancy Checks
libdar::infinint::is_zero
bool is_zero() const
memory_file.hpp
Memory_file is a generic_file class that only uses virtual memory.
my_config.h
include macro defined by the configure script and some specific additional ones
libdar
libdar namespace encapsulate all libdar symbols
Definition archive.hpp:47
proto_compressor.hpp
abstracted ancestor class for compressor and parallel_compressor classes