Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

xen: document balloon driver sysfs files

Add ABI documentation for the balloon driver's sysfs files.

Signed-off-by: David Vrabel <david.vrabel@citrix.com>
Reviewed-by: Daniel Kiper <dkiper@net-space.pl>
[v2: Added comments from Daniel]
Signed-off-by: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>

authored by

David Vrabel and committed by
Konrad Rzeszutek Wilk
e0438b91 c3b92c87

+77
+77
Documentation/ABI/stable/sysfs-devices-system-xen_memory
··· 1 + What: /sys/devices/system/xen_memory/xen_memory0/max_retry_count 2 + Date: May 2011 3 + KernelVersion: 2.6.39 4 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 5 + Description: 6 + The maximum number of times the balloon driver will 7 + attempt to increase the balloon before giving up. See 8 + also 'retry_count' below. 9 + A value of zero means retry forever and is the default one. 10 + 11 + What: /sys/devices/system/xen_memory/xen_memory0/max_schedule_delay 12 + Date: May 2011 13 + KernelVersion: 2.6.39 14 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 15 + Description: 16 + The limit that 'schedule_delay' (see below) will be 17 + increased to. The default value is 32 seconds. 18 + 19 + What: /sys/devices/system/xen_memory/xen_memory0/retry_count 20 + Date: May 2011 21 + KernelVersion: 2.6.39 22 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 23 + Description: 24 + The current number of times that the balloon driver 25 + has attempted to increase the size of the balloon. 26 + The default value is one. With max_retry_count being 27 + zero (unlimited), this means that the driver will attempt 28 + to retry with a 'schedule_delay' delay. 29 + 30 + What: /sys/devices/system/xen_memory/xen_memory0/schedule_delay 31 + Date: May 2011 32 + KernelVersion: 2.6.39 33 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 34 + Description: 35 + The time (in seconds) to wait between attempts to 36 + increase the balloon. Each time the balloon cannot be 37 + increased, 'schedule_delay' is increased (until 38 + 'max_schedule_delay' is reached at which point it 39 + will use the max value). 40 + 41 + What: /sys/devices/system/xen_memory/xen_memory0/target 42 + Date: April 2008 43 + KernelVersion: 2.6.26 44 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 45 + Description: 46 + The target number of pages to adjust this domain's 47 + memory reservation to. 48 + 49 + What: /sys/devices/system/xen_memory/xen_memory0/target_kb 50 + Date: April 2008 51 + KernelVersion: 2.6.26 52 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 53 + Description: 54 + As target above, except the value is in KiB. 55 + 56 + What: /sys/devices/system/xen_memory/xen_memory0/info/current_kb 57 + Date: April 2008 58 + KernelVersion: 2.6.26 59 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 60 + Description: 61 + Current size (in KiB) of this domain's memory 62 + reservation. 63 + 64 + What: /sys/devices/system/xen_memory/xen_memory0/info/high_kb 65 + Date: April 2008 66 + KernelVersion: 2.6.26 67 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 68 + Description: 69 + Amount (in KiB) of high memory in the balloon. 70 + 71 + What: /sys/devices/system/xen_memory/xen_memory0/info/low_kb 72 + Date: April 2008 73 + KernelVersion: 2.6.26 74 + Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> 75 + Description: 76 + Amount (in KiB) of low (or normal) memory in the 77 + balloon.