| Peter Zijlstra | cf0ca9f | 2008-04-30 00:54:32 -0700 | [diff] [blame] | 1 | What:		/sys/class/bdi/<bdi>/ | 
 | 2 | Date:		January 2008 | 
 | 3 | Contact:	Peter Zijlstra <a.p.zijlstra@chello.nl> | 
 | 4 | Description: | 
 | 5 |  | 
| Miklos Szeredi | 76f1418 | 2008-04-30 00:54:36 -0700 | [diff] [blame] | 6 | Provide a place in sysfs for the backing_dev_info object.  This allows | 
 | 7 | setting and retrieving various BDI specific variables. | 
| Peter Zijlstra | cf0ca9f | 2008-04-30 00:54:32 -0700 | [diff] [blame] | 8 |  | 
 | 9 | The <bdi> identifier can be either of the following: | 
 | 10 |  | 
 | 11 | MAJOR:MINOR | 
 | 12 |  | 
 | 13 | 	Device number for block devices, or value of st_dev on | 
 | 14 | 	non-block filesystems which provide their own BDI, such as NFS | 
 | 15 | 	and FUSE. | 
 | 16 |  | 
| Miklos Szeredi | 03fb0bc | 2008-05-23 13:04:19 -0700 | [diff] [blame] | 17 | MAJOR:MINOR-fuseblk | 
 | 18 |  | 
 | 19 | 	Value of st_dev on fuseblk filesystems. | 
 | 20 |  | 
| Peter Zijlstra | cf0ca9f | 2008-04-30 00:54:32 -0700 | [diff] [blame] | 21 | default | 
 | 22 |  | 
 | 23 | 	The default backing dev, used for non-block device backed | 
 | 24 | 	filesystems which do not provide their own BDI. | 
 | 25 |  | 
 | 26 | Files under /sys/class/bdi/<bdi>/ | 
 | 27 | --------------------------------- | 
 | 28 |  | 
 | 29 | read_ahead_kb (read-write) | 
 | 30 |  | 
 | 31 | 	Size of the read-ahead window in kilobytes | 
 | 32 |  | 
| Peter Zijlstra | 189d3c4 | 2008-04-30 00:54:35 -0700 | [diff] [blame] | 33 | min_ratio (read-write) | 
 | 34 |  | 
| Miklos Szeredi | 76f1418 | 2008-04-30 00:54:36 -0700 | [diff] [blame] | 35 | 	Under normal circumstances each device is given a part of the | 
 | 36 | 	total write-back cache that relates to its current average | 
 | 37 | 	writeout speed in relation to the other devices. | 
 | 38 |  | 
 | 39 | 	The 'min_ratio' parameter allows assigning a minimum | 
 | 40 | 	percentage of the write-back cache to a particular device. | 
 | 41 | 	For example, this is useful for providing a minimum QoS. | 
| Peter Zijlstra | a42dde0 | 2008-04-30 00:54:36 -0700 | [diff] [blame] | 42 |  | 
 | 43 | max_ratio (read-write) | 
 | 44 |  | 
| Miklos Szeredi | 76f1418 | 2008-04-30 00:54:36 -0700 | [diff] [blame] | 45 | 	Allows limiting a particular device to use not more than the | 
 | 46 | 	given percentage of the write-back cache.  This is useful in | 
 | 47 | 	situations where we want to avoid one device taking all or | 
 | 48 | 	most of the write-back cache.  For example in case of an NFS | 
 | 49 | 	mount that is prone to get stuck, or a FUSE mount which cannot | 
 | 50 | 	be trusted to play fair. |