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
|
// -*- mode:C++; tab-width:8; c-basic-offset:2; indent-tabs-mode:t -*-
// vim: ts=8 sw=2 smarttab
#pragma once
#include <string>
#include <unordered_map>
#include <map>
#include <typeinfo>
#include <vector>
#include <seastar/core/future.hh>
#include "include/buffer_fwd.h"
#include "include/uuid.h"
#include "osd/osd_types.h"
namespace ceph::os {
class Transaction;
}
namespace crimson::os {
class FuturizedCollection;
class FuturizedStore {
public:
// TODO: replace with the crimson::errorator concept
template <class ConcreteExceptionT>
class Exception : public std::logic_error {
public:
using std::logic_error::logic_error;
// Throwing an exception isn't the sole way to signalize an error
// with it. This approach nicely fits cold, infrequent issues but
// when applied to a hot one (like ENOENT on write path), it will
// likely hurt performance.
// Alternative approach for hot errors is to create exception_ptr
// on our own and place it in the future via make_exception_future.
// When ::handle_exception is called, handler would inspect stored
// exception whether it's hot-or-cold before rethrowing it.
// The main advantage is both types flow through very similar path
// based on future::handle_exception.
static bool is_class_of(const std::exception_ptr& ep) {
// Seastar offers hacks for making throwing lock-less but stack
// unwinding still can be a problem so painful to justify going
// with non-standard, obscure things like this one.
return *ep.__cxa_exception_type() == typeid(ConcreteExceptionT);
}
};
struct EnoentException : public Exception<EnoentException> {
using Exception<EnoentException>::Exception;
};
struct EnodataException : public Exception<EnodataException> {
using Exception<EnodataException>::Exception;
};
static std::unique_ptr<FuturizedStore> create(const std::string& type,
const std::string& data);
FuturizedStore() = default;
virtual ~FuturizedStore() = default;
// no copying
explicit FuturizedStore(const FuturizedStore& o) = delete;
const FuturizedStore& operator=(const FuturizedStore& o) = delete;
virtual seastar::future<> mount() = 0;
virtual seastar::future<> umount() = 0;
virtual seastar::future<> mkfs(uuid_d new_osd_fsid) = 0;
virtual store_statfs_t stat() const = 0;
using CollectionRef = boost::intrusive_ptr<FuturizedCollection>;
virtual seastar::future<ceph::bufferlist> read(CollectionRef c,
const ghobject_t& oid,
uint64_t offset,
size_t len,
uint32_t op_flags = 0) = 0;
virtual seastar::future<ceph::bufferptr> get_attr(CollectionRef c,
const ghobject_t& oid,
std::string_view name) const = 0;
using attrs_t = std::map<std::string, ceph::bufferptr, std::less<>>;
virtual seastar::future<attrs_t> get_attrs(CollectionRef c,
const ghobject_t& oid) = 0;
using omap_values_t = std::map<std::string, bufferlist, std::less<>>;
using omap_keys_t = std::set<std::string>;
virtual seastar::future<omap_values_t> omap_get_values(
CollectionRef c,
const ghobject_t& oid,
const omap_keys_t& keys) = 0;
virtual seastar::future<std::vector<ghobject_t>, ghobject_t> list_objects(
CollectionRef c,
const ghobject_t& start,
const ghobject_t& end,
uint64_t limit) const = 0;
virtual seastar::future<bool, omap_values_t> omap_get_values(
CollectionRef c, ///< [in] collection
const ghobject_t &oid, ///< [in] oid
const std::optional<std::string> &start ///< [in] start, empty for begin
) = 0; ///< @return <done, values> values.empty() iff done
virtual seastar::future<CollectionRef> create_new_collection(const coll_t& cid) = 0;
virtual seastar::future<CollectionRef> open_collection(const coll_t& cid) = 0;
virtual seastar::future<std::vector<coll_t>> list_collections() = 0;
virtual seastar::future<> do_transaction(CollectionRef ch,
ceph::os::Transaction&& txn) = 0;
virtual seastar::future<> write_meta(const std::string& key,
const std::string& value) = 0;
virtual seastar::future<int, std::string> read_meta(const std::string& key) = 0;
virtual uuid_d get_fsid() const = 0;
virtual unsigned get_max_attr_name_length() const = 0;
};
}
|
