File: replication_bandwidth_limiter.h

package info (click to toggle)
lizardfs 3.12.0%2Bdfsg-3
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 8,064 kB
  • sloc: cpp: 91,899; sh: 9,341; python: 3,878; ansic: 3,109; pascal: 128; makefile: 57
file content (93 lines) | stat: -rw-r--r-- 2,372 bytes parent folder | download | duplicates (3)
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
/*
   Copyright 2013-2015 Skytechnology sp. z o.o.

   This file is part of LizardFS.

   LizardFS is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, version 3.

   LizardFS is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with LizardFS. If not, see <http://www.gnu.org/licenses/>.
 */

#pragma once

#include "common/platform.h"

#include "common/io_limiting.h"

/**
 * Implements full mechanism of limiting replication I/O bandwidth
 * providing the simplest possible API
 */
class ReplicationBandwidthLimiter {
public:
	/**
	 * Constructor
	 */
	ReplicationBandwidthLimiter();

	/**
	 * Sets the current limit of replication
	 * \param limit_kBps - limit in kibibytes in second
	 */
	void setLimit(uint64_t limit_kBps);

	/**
	 * Removes any limit
	 */
	void unsetLimit();

	/**
	 * Performs a wait for requested operation size
	 * \param requestedSize size of data requested to replicate in bytes
	 * \param timeout maximum allowed waiting time
	 * \return status of the operation
	 */
	uint8_t wait(uint64_t requestedSize, const SteadyDuration timeout);

private:
	/**
	 * A very simple limiter which manages one specific limit: kReplicationGroupId
	 */
	class ReplicationLimiter : public ioLimiting::Limiter {
	public:
		/**
		 * See the base class description
		 */
		uint64_t request(const IoLimitGroupId& groupId, uint64_t size) override;

		/**
		 * Sets current limit of replication in database
		 * \param limit_kBps - limit in kibibytes in second
		 */
		void setLimit(uint64_t limit_kBps);

		/**
		 * Removes replication limit from database
		 */
		void unsetLimit();

		// This implementation doesn't use registerReconfigure()

	private:
		/// A database holding and managing limits (only one in this class)
		IoLimitsDatabase database_;
	};

	/// An instance of replication limiter
	ReplicationLimiter limiter_;

	ioLimiting::RTClock clock_;
	ioLimiting::SharedState state_;
	std::unique_ptr<ioLimiting::Group> group_;

	/// A mutex for waiting operations
	static std::mutex mutex_;
};