libfoedus-core
FOEDUS Core Library
snapshot_manager.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2014-2015, Hewlett-Packard Development Company, LP.
3  * This program is free software; you can redistribute it and/or modify it
4  * under the terms of the GNU General Public License as published by the Free
5  * Software Foundation; either version 2 of the License, or (at your option)
6  * any later version.
7  *
8  * This program is distributed in the hope that it will be useful, but WITHOUT
9  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
11  * more details. You should have received a copy of the GNU General Public
12  * License along with this program; if not, write to the Free Software
13  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
14  *
15  * HP designates this particular file as subject to the "Classpath" exception
16  * as provided by HP in the LICENSE.txt file that accompanied this code.
17  */
18 #ifndef FOEDUS_SNAPSHOT_SNAPSHOT_MANAGER_HPP_
19 #define FOEDUS_SNAPSHOT_SNAPSHOT_MANAGER_HPP_
20 #include "foedus/epoch.hpp"
21 #include "foedus/fwd.hpp"
22 #include "foedus/initializable.hpp"
23 #include "foedus/snapshot/fwd.hpp"
25 namespace foedus {
26 namespace snapshot {
31 class SnapshotManager CXX11_FINAL : public virtual Initializable {
32  public:
33  explicit SnapshotManager(Engine* engine);
35 
36  // Disable default constructors
40 
42  bool is_initialized() const CXX11_OVERRIDE;
44 
49  Epoch get_snapshot_epoch() const;
52 
57 
63 
75  bool wait_completion,
76  Epoch suggested_snapshot_epoch = INVALID_EPOCH);
77 
79  SnapshotManagerPimpl* get_pimpl() { return pimpl_; }
80 
81  private:
82  SnapshotManagerPimpl *pimpl_;
83 };
84 } // namespace snapshot
85 } // namespace foedus
86 #endif // FOEDUS_SNAPSHOT_SNAPSHOT_MANAGER_HPP_
ErrorStack uninitialize() override
An idempotent method to release all resources of this object, if any.
Represents the data in one snapshot metadata file.
SnapshotManagerPimpl * get_pimpl()
Do not use this unless you know what you are doing.
The pure-virtual interface to initialize/uninitialize non-trivial resources.
Typedefs of ID types used in snapshot package.
Root package of FOEDUS (Fast Optimistic Engine for Data Unification Services).
Definition: assert_nd.hpp:44
Forward declarations of classes in root package.
Brings error stacktrace information as return value of functions.
Definition: error_stack.hpp:81
Forward declarations of classes in snapshot manager package.
Represents a time epoch.
Definition: epoch.hpp:61
ErrorStack read_snapshot_metadata(SnapshotId snapshot_id, SnapshotMetadata *out)
Read the snapshot metadata file that contains storages as of the snapshot.
Snapshot manager that atomically and durably writes out a snapshot file.
Epoch get_snapshot_epoch_weak() const
Non-atomic version.
void trigger_snapshot_immediate(bool wait_completion, Epoch suggested_snapshot_epoch=INVALID_EPOCH)
Immediately take a snapshot.
SnapshotId get_previous_snapshot_id_weak() const
Non-atomic version.
#define CXX11_FINAL
Used in public headers in place of "final" of C++11.
Definition: cxx11.hpp:131
Database engine object that holds all resources and provides APIs.
Definition: engine.hpp:109
uint16_t SnapshotId
Unique ID of Snapshot.
Definition: snapshot_id.hpp:43
bool is_initialized() const override
Returns whether the object has been already initialized or not.
#define CXX11_OVERRIDE
Used in public headers in place of "override" of C++11.
Definition: cxx11.hpp:134
#define CXX11_FUNC_DELETE
Used in public headers in place of " = delete" of C++11.
Definition: cxx11.hpp:128
const Epoch INVALID_EPOCH
A constant epoch object that represents an invalid epoch.
Definition: epoch.hpp:204
SnapshotManager & operator=(const SnapshotManager &)=delete
SnapshotId get_previous_snapshot_id() const
Returns the most recent snapshot's ID.
ErrorStack initialize() override
Acquires resources in this object, usually called right after constructor.
Epoch get_snapshot_epoch() const
Returns the most recently snapshot-ed epoch, all logs upto this epoch is safe to delete.