libstorage-ng
Bcache.h
1 /*
2  * Copyright (c) [2016-2019] 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 
61  class Bcache : public Partitionable
62  {
63  public:
64 
65  static Bcache* create(Devicegraph* devicegraph, const std::string& dm_name);
66  static Bcache* create(Devicegraph* devicegraph, const std::string& dm_name, BcacheType type);
67  static Bcache* load(Devicegraph* devicegraph, const xmlNode* node);
68 
69  BcacheType get_type() const;
70 
71  unsigned int get_number() const;
72 
80  const BlkDevice* get_backing_device() const;
81 
85  const BlkDevice* get_blk_device() const ST_DEPRECATED;
86 
93  bool has_bcache_cset() const;
94 
101  const BcacheCset* get_bcache_cset() const;
102 
110  void add_bcache_cset(BcacheCset* bcache_cset);
111 
119  void remove_bcache_cset();
120 
126  CacheMode get_cache_mode() const;
127 
135  void set_cache_mode(CacheMode mode);
136 
142  unsigned long long get_sequential_cutoff() const;
143 
149  unsigned get_writeback_percent() const;
150 
154  static std::vector<Bcache*> get_all(Devicegraph* devicegraph);
155 
159  static std::vector<const Bcache*> get_all(const Devicegraph* devicegraph);
160 
171  static void reassign_numbers(Devicegraph* devicegraph);
172 
178  static Bcache* find_by_name(Devicegraph* devicegraph, const std::string& name);
179 
183  static const Bcache* find_by_name(const Devicegraph* devicegraph, const std::string& name);
184 
188  static std::string find_free_name(const Devicegraph* devicegraph);
189 
193  static bool compare_by_number(const Bcache* lhs, const Bcache* rhs);
194 
195  public:
196 
197  class Impl;
198 
199  Impl& get_impl();
200  const Impl& get_impl() const;
201 
202  virtual Bcache* clone() const override;
203 
204  protected:
205 
206  Bcache(Impl* impl);
207 
208  };
209 
210 
211  bool is_bcache(const Device* device);
212 
219  Bcache* to_bcache(Device* device);
220 
224  const Bcache* to_bcache(const Device* device);
225 
226 }
227 
228 #endif
void remove_bcache_cset()
Removes association with a caching set.
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.
const BlkDevice * get_backing_device() const
Get the BlkDevice used as backing device.
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:61
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 master container of the libstorage.
Definition: Devicegraph.h:153
An abstract Block Device.
Definition: BlkDevice.h:44
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 of storage devices, and a vertex in the Devicegraph.
Definition: Device.h:75
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:37
static Bcache * find_by_name(Devicegraph *devicegraph, const std::string &name)
Find a bcache by its name.
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.