libstorage-ng
Bcache.h
1 /*
2  * Copyright (c) [2016-2020] SUSE LLC
3  *
4  * All Rights Reserved.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms of version 2 of the GNU General Public License as published
8  * by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13  * more details.
14  *
15  * You should have received a copy of the GNU General Public License along
16  * with this program; if not, contact Novell, Inc.
17  *
18  * To contact Novell about this file by physical or electronic mail, you may
19  * find current contact information at www.novell.com.
20  */
21 
22 
23 #ifndef STORAGE_BCACHE_H
24 #define STORAGE_BCACHE_H
25 
26 
27 #include "storage/Devices/Partitionable.h"
28 #include "storage/Devices/Device.h"
29 #include "storage/Devicegraph.h"
30 #include "storage/Utils/Swig.h"
31 
32 
33 namespace storage
34 {
35 
36  class BcacheCset;
37 
38 
42  enum class BcacheType {
43  BACKED, FLASH_ONLY
44  };
45 
46 
50  enum class CacheMode {
51  WRITETHROUGH, WRITEBACK, WRITEAROUND, NONE
52  };
53 
54 
62  class Bcache : public Partitionable
63  {
64  public:
65 
70  static Bcache* create(Devicegraph* devicegraph, const std::string& dm_name);
71 
75  static Bcache* create(Devicegraph* devicegraph, const std::string& dm_name, BcacheType type);
76 
77  static Bcache* load(Devicegraph* devicegraph, const xmlNode* node);
78 
84  BcacheType get_type() const;
85 
89  unsigned int get_number() const;
90 
98  const BlkDevice* get_backing_device() const;
99 
103  const BlkDevice* get_blk_device() const ST_DEPRECATED;
104 
111  bool has_bcache_cset() const;
112 
119  const BcacheCset* get_bcache_cset() const;
120 
128  void add_bcache_cset(BcacheCset* bcache_cset);
129 
137  void remove_bcache_cset();
138 
144  CacheMode get_cache_mode() const;
145 
153  void set_cache_mode(CacheMode mode);
154 
160  unsigned long long get_sequential_cutoff() const;
161 
167  unsigned get_writeback_percent() const;
168 
172  static std::vector<Bcache*> get_all(Devicegraph* devicegraph);
173 
177  static std::vector<const Bcache*> get_all(const Devicegraph* devicegraph);
178 
189  static void reassign_numbers(Devicegraph* devicegraph);
190 
196  static Bcache* find_by_name(Devicegraph* devicegraph, const std::string& name);
197 
201  static const Bcache* find_by_name(const Devicegraph* devicegraph, const std::string& name);
202 
209  static std::string find_free_name(const Devicegraph* devicegraph);
210 
216  static bool compare_by_number(const Bcache* lhs, const Bcache* rhs);
217 
218  public:
219 
220  class Impl;
221 
222  Impl& get_impl();
223  const Impl& get_impl() const;
224 
225  virtual Bcache* clone() const override;
226 
227  protected:
228 
229  Bcache(Impl* impl);
230 
231  };
232 
233 
239  bool is_bcache(const Device* device);
240 
247  Bcache* to_bcache(Device* device);
248 
252  const Bcache* to_bcache(const Device* device);
253 
254 }
255 
256 #endif
void remove_bcache_cset()
Removes association with a caching set.
static Bcache * create(Devicegraph *devicegraph, const std::string &dm_name)
Create a device of type Bcache.
static std::vector< Bcache * > get_all(Devicegraph *devicegraph)
Get all bcaches.
static std::string find_free_name(const Devicegraph *devicegraph)
Find a free name for a bcache, e.g.
const BlkDevice * get_backing_device() const
Get the BlkDevice used as backing device.
bool is_bcache(const Device *device)
Checks whether device points to a Bcache.
static bool compare_by_number(const Bcache *lhs, const Bcache *rhs)
Compare (less than) two bcaches by number.
const BlkDevice * get_blk_device() const ST_DEPRECATED
Get the BlkDevice used as backing device.
BcacheType
Bcache types.
Definition: Bcache.h:42
A bcache device.
Definition: Bcache.h:62
bool has_bcache_cset() const
Returns true if a caching set is attached.
static void reassign_numbers(Devicegraph *devicegraph)
Fix the numeric ids of bcache devices so that there are no holes in the id sequence for in-memory bca...
The main container of the libstorage-ng.
Definition: Devicegraph.h:169
An abstract Block Device.
Definition: BlkDevice.h:48
unsigned get_writeback_percent() const
Returns percent of writeback dirty pages.
const BcacheCset * get_bcache_cset() const
Get the caching set associated with this bcache device.
An abstract base class for storage devices.
Definition: Device.h:81
A bcache cache set.
Definition: BcacheCset.h:41
Bcache * to_bcache(Device *device)
Converts pointer to Device to pointer to Bcache.
unsigned long long get_sequential_cutoff() const
Returns size of sequential_cutoff attribute.
Definition: Partitionable.h:39
The storage namespace.
Definition: Actiongraph.h:38
BcacheType get_type() const
Get the bcache type.
static Bcache * find_by_name(Devicegraph *devicegraph, const std::string &name)
Find a bcache by its name.
unsigned int get_number() const
Get the number of the bcache.
void set_cache_mode(CacheMode mode)
Sets cache mode attribute.
void add_bcache_cset(BcacheCset *bcache_cset)
Associates a caching set to the bcache.
CacheMode
The Cache mode attribute.
Definition: Bcache.h:50
CacheMode get_cache_mode() const
Returns cache mode attribute.