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. |