This patch adds documentation about /sys/kernel/uids/<uid>/cpu_share
to Documentation/ABI.
Signed-off-by: Dhaval Giani <[email protected]>
---
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 <[email protected]>
+ Srivatsa Vaddagiri <[email protected]>
+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.
--
regards,
Dhaval
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 <[email protected]>
>
> ---
> 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 <[email protected]>
> + Srivatsa Vaddagiri <[email protected]>
> +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
On Tue, Dec 11, 2007 at 09:35:56PM -0800, Greg KH wrote:
> 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 <[email protected]>
> >
> > ---
> > 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 <[email protected]>
> > + Srivatsa Vaddagiri <[email protected]>
> > +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?
>
It is proportional. That is, if two users have same value for shares,
they will get equal bandwidth on the CPU. If they are in the ratio 1:2,
then they will share it in that ratio. I've updated the patch for this.
Hope it is clearer.
Thanks,
--
This patch adds documentation about /sys/kernel/uids/<uid>/cpu_share
to Documentation/ABI.
Signed-off-by: Dhaval Giani <[email protected]>
---
Documentation/ABI/testing/sysfs-kernel-uids | 14 ++++++++++++++
1 files changed, 14 insertions(+)
Index: current/Documentation/ABI/testing/sysfs-kernel-uids
===================================================================
--- /dev/null
+++ current/Documentation/ABI/testing/sysfs-kernel-uids
@@ -0,0 +1,14 @@
+What: /sys/kernel/uids/<uid>/cpu_shares
+Date: December 2007
+Contact: Dhaval Giani <[email protected]>
+ Srivatsa Vaddagiri <[email protected]>
+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 an equal number of
+ shares, then they will get equal CPU bandwidth. Another
+ example would be, if User A has shares = 1024 and user
+ B has shares = 2048, User B will get twice the CPU
+ bandwidth user A will. For more details refer
+ Documentation/sched-design-CFS.txt
--
regards,
Dhaval
* Dhaval Giani <[email protected]> wrote:
> > 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?
>
> It is proportional. That is, if two users have same value for shares,
> they will get equal bandwidth on the CPU. If they are in the ratio
> 1:2, then they will share it in that ratio. I've updated the patch for
> this. Hope it is clearer.
thanks, applied.
Ingo
* Ingo Molnar <[email protected]> wrote:
>
> * Dhaval Giani <[email protected]> wrote:
>
> > > 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?
> >
> > It is proportional. That is, if two users have same value for shares,
> > they will get equal bandwidth on the CPU. If they are in the ratio
> > 1:2, then they will share it in that ratio. I've updated the patch for
> > this. Hope it is clearer.
>
> thanks, applied.
unless Greg wants to push this via the sysfs git tree?
Ingo
On Wed, Dec 12, 2007 at 11:16:45AM +0100, Ingo Molnar wrote:
>
> * Ingo Molnar <[email protected]> wrote:
>
> >
> > * Dhaval Giani <[email protected]> wrote:
> >
> > > > 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?
> > >
> > > It is proportional. That is, if two users have same value for shares,
> > > they will get equal bandwidth on the CPU. If they are in the ratio
> > > 1:2, then they will share it in that ratio. I've updated the patch for
> > > this. Hope it is clearer.
> >
> > thanks, applied.
>
> unless Greg wants to push this via the sysfs git tree?
Sure, I can do that, what's one more patch in my tree? :)
thanks,
greg k-h
This is a note to let you know that I've just added the patch titled
Subject: Add Documentation for FAIR_USER_SCHED sysfs files
to my gregkh-2.6 tree. Its filename is
add-documentation-for-fair_user_sched-sysfs-files.patch
This tree can be found at
http://www.kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/patches/
>From [email protected] Tue Dec 11 21:51:17 2007
From: Dhaval Giani <[email protected]>
Date: Wed, 12 Dec 2007 11:18:59 +0530
Subject: Add Documentation for FAIR_USER_SCHED sysfs files
To: Greg KH <[email protected]>
Cc: lkml <[email protected]>, Ingo Molnar <[email protected]>, Andrew Morton <[email protected]>, Srivatsa Vaddagiri <[email protected]>, Balbir Singh <[email protected]>
Message-ID: <[email protected]>
Content-Disposition: inline
This patch adds documentation about /sys/kernel/uids/<uid>/cpu_share
to Documentation/ABI.
Signed-off-by: Dhaval Giani <[email protected]>
Cc: Ingo Molnar <[email protected]>
Signed-off-by: Greg Kroah-Hartman <[email protected]>
---
Documentation/ABI/testing/sysfs-kernel-uids | 14 ++++++++++++++
1 file changed, 14 insertions(+)
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-kernel-uids
@@ -0,0 +1,14 @@
+What: /sys/kernel/uids/<uid>/cpu_shares
+Date: December 2007
+Contact: Dhaval Giani <[email protected]>
+ Srivatsa Vaddagiri <[email protected]>
+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 an equal number of
+ shares, then they will get equal CPU bandwidth. Another
+ example would be, if User A has shares = 1024 and user
+ B has shares = 2048, User B will get twice the CPU
+ bandwidth user A will. For more details refer
+ Documentation/sched-design-CFS.txt
Patches currently in gregkh-2.6 which might be from [email protected] are
driver/struct-user_info-sysfs.patch
driver/add-documentation-for-fair_user_sched-sysfs-files.patch