Re: [PATCH] Add Documentation for FAIR_USER_SCHED sysfs files

From: Greg KH
Date: Wed Dec 12 2007 - 00:33:32 EST


On Wed, Dec 12, 2007 at 08:08:36AM +0530, Dhaval Giani wrote:
>
> This patch adds documentation about /sys/kernel/uids/<uid>/cpu_share
> to Documentation/ABI.
>
> Signed-off-by: Dhaval Giani <dhaval@xxxxxxxxxxxxxxxxxx>
>
> ---
> Documentation/ABI/testing/sysfs-kernel-uids | 10 ++++++++++
> 1 files changed, 10 insertions(+)
>
> Index: current/Documentation/ABI/testing/sysfs-kernel-uids
> ===================================================================
> --- /dev/null
> +++ current/Documentation/ABI/testing/sysfs-kernel-uids
> @@ -0,0 +1,10 @@
> +What: /sys/kernel/uids/<uid>/cpu_shares
> +Date: December 2007
> +Contact: Dhaval Giani <dhaval@xxxxxxxxxxxxxxxxxx>
> + Srivatsa Vaddagiri <vatsa@xxxxxxxxxxxxxxxxxx>
> +Description:
> + The /sys/kernel/uids/<uid>/cpu_shares tunable is used
> + to set the cpu bandwidth a user is allowed. This is a
> + propotional value. What that means is that if there
> + are two users logged in, each with shares 1024, they
> + will get equal CPU bandwidth.

Hm, how about describing the units here? Can you put "10" in each file
and everyone will get the same share? 100? 1? 1024 seems like an odd
"share" number. Unless there is some other document you wish to refer
people to do help describe these values?

thanks,

greg k-h
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/