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 
54 
62  class Bcache : public Partitionable
63  {
64  public:
65 
66  static Bcache* create(Devicegraph* devicegraph, const std::string& dm_name);
67  static Bcache* create(Devicegraph* devicegraph, const std::string& dm_name, BcacheType type);
68  static Bcache* load(Devicegraph* devicegraph, const xmlNode* node);
69 
70  BcacheType get_type() const;
71 
72  unsigned int get_number() const;
73 
81  const BlkDevice* get_backing_device() const;
82 
86  const BlkDevice* get_blk_device() const ST_DEPRECATED;
87 
94  bool has_bcache_cset() const;
95 
102  const BcacheCset* get_bcache_cset() const;
103 
111  void add_bcache_cset(BcacheCset* bcache_cset);
112 
120  void remove_bcache_cset();
121 
127  CacheMode get_cache_mode() const;
128 
136  void set_cache_mode(CacheMode mode);
137 
143  unsigned long long get_sequential_cutoff() const;
144 
150  unsigned get_writeback_percent() const;
151 
155  static std::vector<Bcache*> get_all(Devicegraph* devicegraph);
156 
160  static std::vector<const Bcache*> get_all(const Devicegraph* devicegraph);
161 
172  static void reassign_numbers(Devicegraph* devicegraph);
173 
179  static Bcache* find_by_name(Devicegraph* devicegraph, const std::string& name);
180 
184  static const Bcache* find_by_name(const Devicegraph* devicegraph, const std::string& name);
185 
189  static std::string find_free_name(const Devicegraph* devicegraph);
190 
194  static bool compare_by_number(const Bcache* lhs, const Bcache* rhs);
195 
196  public:
197 
198  class Impl;
199 
200  Impl& get_impl();
201  const Impl& get_impl() const;
202 
203  virtual Bcache* clone() const override;
204 
205  protected:
206 
207  Bcache(Impl* impl);
208 
209  };
210 
211 
217  bool is_bcache(const Device* device);
218 
225  Bcache* to_bcache(Device* device);
226 
230  const Bcache* to_bcache(const Device* device);
231 
232 }
233 
234 #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.
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 master container of the libstorage.
Definition: Devicegraph.h:153
An abstract Block Device.
Definition: BlkDevice.h:46
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.