From: Balbir Singh <balbir@linux.vnet.ibm.com>
To: Paul Menage <menage@google.com>
Cc: Li Zefan <lizf@cn.fujitsu.com>,
balbir@in.ibm.com, pj@sgi.com, Pavel Emelianov <xemul@openvz.org>,
KAMEZAWA Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>,
vatsa@linux.vnet.ibm.com, akpm@linux-foundation.org,
containers@lists.linux-foundation.org,
linux-kernel@vger.kernel.org
Subject: Re: [RFC][PATCH 1/7] CGroup API: Add cgroup.api control file
Date: Mon, 18 Feb 2008 16:02:59 +0530 [thread overview]
Message-ID: <47B95EDB.1020400@linux.vnet.ibm.com> (raw)
In-Reply-To: <47B953A8.9030206@cn.fujitsu.com>
Li Zefan wrote:
> Paul Menage wrote:
>> On Feb 16, 2008 2:07 AM, Balbir Singh <balbir@linux.vnet.ibm.com> wrote:
>>> Paul Menage wrote:
>>>
>>> Hi, Paul,
>>>
>>> Do we need to use a cgroup.api file? Why not keep up to date documentation and
>>> get users to use that. I fear that, cgroup.api will not be kept up-to-date,
>>> leading to confusion.
>> The cgroup.api file isn't meant to give complete documentation for a
>> control file, simply a brief indication of its usage.
>>
>
> But we don't have /proc/proc.api or /sys/sysfs.api ...
>
Yes, doing that would make the size of the kernel go out of control.
>> The aim is that most bits of the information reported in cgroup.api
>> are auto-generated, so there shouldn't be problems with it getting
>> out-of-date.
>>
>> Is it just the space used by the documentation string that you're
>> objecting to? The other function of the file is to declare a type for
>> each variable.
>>
I like the documentation aspect, it is the space that I object to.
--
Warm Regards,
Balbir Singh
Linux Technology Center
IBM, ISTL
next prev parent reply other threads:[~2008-02-18 10:37 UTC|newest]
Thread overview: 56+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-02-15 20:44 [RFC][PATCH 0/7] CGroup API: More structured API for CGroups control files Paul Menage
2008-02-15 20:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 1/7] CGroup API: Add cgroup.api control file Paul Menage
2008-02-15 20:44 ` Paul Menage
[not found] ` <20080215204820.734926000-B63HFAS8fGlSzHKm+aFRNNkmqwFzkYv6@public.gmane.org>
2008-02-16 10:07 ` Balbir Singh
2008-02-16 10:07 ` Balbir Singh
2008-02-16 17:44 ` Paul Menage
2008-02-18 9:45 ` Li Zefan
2008-02-18 10:32 ` Balbir Singh [this message]
2008-02-19 21:57 ` Paul Jackson
2008-02-20 2:51 ` Paul Menage
2008-02-20 5:17 ` Paul Jackson
2008-02-20 5:23 ` Paul Menage
[not found] ` <20080219231726.4bd97520.pj-sJ/iWh9BUns@public.gmane.org>
2008-02-20 5:23 ` Paul Menage
[not found] ` <6599ad830802191851l66281e67rb49c766c2b1427c9-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2008-02-20 5:17 ` Paul Jackson
[not found] ` <20080219155742.0298f25f.pj-sJ/iWh9BUns@public.gmane.org>
2008-02-20 2:51 ` Paul Menage
[not found] ` <47B953A8.9030206-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
2008-02-18 10:32 ` Balbir Singh
2008-02-19 21:57 ` Paul Jackson
2008-02-20 2:51 ` Paul Menage
2008-02-20 2:51 ` Paul Menage
[not found] ` <6599ad830802160944v6d529570k1ade6df273ca3d0d-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2008-02-18 9:45 ` Li Zefan
[not found] ` <47B6B5CA.7040201-23VcF4HTsmIX0ybBhKVfKdBPR1lH4CV8@public.gmane.org>
2008-02-16 17:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 2/7] CGroup API: Add cgroup map data type Paul Menage
2008-02-15 20:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 3/7] CGroup API: Use cgroup map for memcontrol stats file Paul Menage
2008-02-15 20:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 4/7] CGroup API: Add res_counter_read_uint() Paul Menage
2008-02-15 20:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 5/7] CGroup API: Use read_uint in memory controller Paul Menage
2008-02-15 20:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 6/7] CGroup API: Use descriptions for memory controller API files Paul Menage
2008-02-15 20:44 ` Paul Menage
2008-02-15 20:44 ` [RFC][PATCH 7/7] CGroup API: Update cpusets to use cgroup structured file API Paul Menage
[not found] ` <20080215204821.778088000-B63HFAS8fGlSzHKm+aFRNNkmqwFzkYv6@public.gmane.org>
2008-02-17 3:29 ` Paul Jackson
2008-02-17 3:29 ` Paul Jackson
[not found] ` <20080216212901.70fe35ce.pj-sJ/iWh9BUns@public.gmane.org>
2008-02-17 17:18 ` Paul Menage
2008-02-18 9:55 ` Li Zefan
2008-02-17 17:18 ` Paul Menage
[not found] ` <6599ad830802170918q4c748f7fs32e5b8ea63e49f15-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2008-02-17 17:28 ` Paul Jackson
2008-02-17 17:28 ` Paul Jackson
[not found] ` <20080217112843.5496412d.pj-sJ/iWh9BUns@public.gmane.org>
2008-02-17 17:48 ` Paul Menage
2008-02-17 17:48 ` Paul Menage
2008-02-18 9:55 ` Li Zefan
[not found] ` <47B96805.7070002@linux.vnet.ibm.com>
2008-02-18 11:13 ` Balbir Singh
2008-02-18 11:52 ` Andreas Schwab
[not found] ` <47B971C6.4080807@linux.vnet.ibm.com>
2008-02-18 11:56 ` Balbir Singh
[not found] ` <47B971C6.4080807-23VcF4HTsmIX0ybBhKVfKdBPR1lH4CV8@public.gmane.org>
2008-02-18 11:56 ` Balbir Singh
[not found] ` <20080218111333.GA6333-SINUvgVNF2CyUtPGxGje5AC/G2K4zDHf@public.gmane.org>
2008-02-18 11:52 ` Andreas Schwab
[not found] ` <47B96805.7070002-23VcF4HTsmIX0ybBhKVfKdBPR1lH4CV8@public.gmane.org>
2008-02-18 11:13 ` Balbir Singh
2008-02-15 20:44 ` Paul Menage
[not found] ` <20080215204418.535025000-B63HFAS8fGlSzHKm+aFRNNkmqwFzkYv6@public.gmane.org>
2008-02-16 4:21 ` [RFC][PATCH 0/7] CGroup API: More structured API for CGroups control files KAMEZAWA Hiroyuki
2008-02-16 4:21 ` KAMEZAWA Hiroyuki
[not found] ` <20080216132118.877e769b.kamezawa.hiroyu-+CUm20s59erQFUHtdCDX3A@public.gmane.org>
2008-02-16 9:31 ` Li Zefan
2008-02-16 9:31 ` Li Zefan
[not found] ` <47B6AD86.2060802-BthXqXjhjHXQFUHtdCDX3A@public.gmane.org>
2008-02-16 17:40 ` Paul Menage
2008-02-16 17:40 ` Paul Menage
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=47B95EDB.1020400@linux.vnet.ibm.com \
--to=balbir@linux.vnet.ibm.com \
--cc=akpm@linux-foundation.org \
--cc=balbir@in.ibm.com \
--cc=containers@lists.linux-foundation.org \
--cc=kamezawa.hiroyu@jp.fujitsu.com \
--cc=linux-kernel@vger.kernel.org \
--cc=lizf@cn.fujitsu.com \
--cc=menage@google.com \
--cc=pj@sgi.com \
--cc=vatsa@linux.vnet.ibm.com \
--cc=xemul@openvz.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.