Re: [Xen-devel] [PATCH] xen: document balloon driver sysfs files

[Daniel Kiper <dkiper@xxxxxxxxxxxx>]

On Wed, Oct 26, 2011 at 11:57:43AM +0100, David Vrabel wrote:
> From: David Vrabel <david.vrabel@xxxxxxxxxx>
>
> Add ABI documentation for the balloon driver's sysfs files.
>
> Signed-off-by: David Vrabel <david.vrabel@xxxxxxxxxx>
> ---
>  .../ABI/stable/sysfs-devices-system-xen_memory     |   72 
> ++++++++++++++++++++
>  1 files changed, 72 insertions(+), 0 deletions(-)
>  create mode 100644 Documentation/ABI/stable/sysfs-devices-system-xen_memory
>
> diff --git a/Documentation/ABI/stable/sysfs-devices-system-xen_memory 
> b/Documentation/ABI/stable/sysfs-devices-system-xen_memory
> new file mode 100644
> index 0000000..4fbc446
> --- /dev/null
> +++ b/Documentation/ABI/stable/sysfs-devices-system-xen_memory
> @@ -0,0 +1,72 @@
> +What:                
> /sys/devices/system/xen_memory/xen_memory0/max_retry_count
> +Date:                April 2008

May 2011

> +KernelVersion:       2.6.26

2.6.39, git commit 95d2ac4a0c904942a4fecf815781ebd4171e7a30
and 40095de1f9082f058970b985a96d2fbef43f94f4.

Additionally, I think it is worth to add default value and special
cases description (e.g. max_retry_count == 0 => RETRY_UNLIMITED).
Please look into drivers/xen/{balloon.c,xen-balloon.c}
and include/xen/balloon.h for details.

> +Contact:     Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>
> +Description:
> +             The maximum number of times the balloon driver will
> +             attempt to increase the balloon before giving up.  See
> +             also 'retry_count' below.
> +
> +What:                
> /sys/devices/system/xen_memory/xen_memory0/max_schedule_delay
> +Date:                April 2008

Ditto.

> +KernelVersion:       2.6.26

Ditto.

> +Contact:     Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>
> +Description:
> +             The limit that 'schedule_delay' (see below) will be
> +             increased to.
> +
> +What:                /sys/devices/system/xen_memory/xen_memory0/retry_count
> +Date:                April 2008

Ditto.

> +KernelVersion:       2.6.26

Ditto.

> +Contact:     Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>
> +Description:
> +             The current number of times that the balloon driver
> +             has attempted to increase the size of the balloon.
> +
> +What:                
> /sys/devices/system/xen_memory/xen_memory0/schedule_delay
> +Date:                April 2008

Ditto.

> +KernelVersion:       2.6.26

Ditto.

Daniel

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel