> I am really lame at writing documentation and also not that familiar > with the man format. This is just a first shot. There is one TODO in the > text because I have no idea how to dump ls -l output of the groups > from the example. Would really welcome a help there.
I think the man syntax is fine, nobody is expert in this area here. Regarding the TODO, see my proposal below, but as I read it now, it's far from perfect. There is probably no good way how to easily describe the behavior. Jan --- doc/man/cgconfig.conf.5 | 42 ++++++++++++++++++++++++++++++++++++++++-- 1 files changed, 40 insertions(+), 2 deletions(-) diff --git a/doc/man/cgconfig.conf.5 b/doc/man/cgconfig.conf.5 index ccc6ce5..c291ba8 100644 --- a/doc/man/cgconfig.conf.5 +++ b/doc/man/cgconfig.conf.5 @@ -362,8 +362,6 @@ two subgroups inside, setting one parameter. It corresponds to the following operations (except for file permissions which are little bit trickier to emulate via chmod): -TODO ls -l to show file permissions. - .LP .RS .nf @@ -377,10 +375,50 @@ chown root:root /mnt/cgroups/cpu/daemons/www/* chown root:webmaster /mnt/cgroups/cpu/daemons/www/tasks echo 1000 > /mnt/cgroups/cpu/daemons/www/cpu.shares + # + chmod the files so the result looks like: + # ls -la /mnt/cgroups/cpu/daemons/www/ + # admin.dperm = 755: + # drwxrwxr-x. 2 root webmaster 0 Jun 16 11:51 . + # + # admin.fperm = 744: + # --w-------. 1 root webmaster 0 Jun 16 11:51 cgroup.event_control + # -r--r--r--. 1 root webmaster 0 Jun 16 11:51 cgroup.procs + # -r--r--r--. 1 root webmaster 0 Jun 16 11:51 cpuacct.stat + # -rw-r--r--. 1 root webmaster 0 Jun 16 11:51 cpuacct.usage + # -r--r--r--. 1 root webmaster 0 Jun 16 11:51 cpuacct.usage_percpu + # -rw-r--r--. 1 root webmaster 0 Jun 16 11:51 cpu.rt_period_us + # -rw-r--r--. 1 root webmaster 0 Jun 16 11:51 cpu.rt_runtime_us + # -rw-r--r--. 1 root webmaster 0 Jun 16 11:51 cpu.shares + # -rw-r--r--. 1 root webmaster 0 Jun 16 11:51 notify_on_release + # + # tasks.fperm = 770 + # -rw-rw----. 1 root webmaster 0 Jun 16 11:51 tasks + + mkdir /mnt/cgroups/cpu/daemons/ftp chown root:root /mnt/cgroups/cpu/daemons/ftp/* chown root:ftpmaster /mnt/cgroups/cpu/daemons/ftp/tasks echo 500 > /mnt/cgroups/cpu/daemons/ftp/cpu.shares + + # + chmod the files so the result looks like: + # ls -la /mnt/cgroups/cpu/daemons/ftp/ + # admin.dperm = 755: + # drwxr-xr-x. 2 root ftpmaster 0 Jun 16 11:51 . + # + # admin.fperm = 700: + # --w-------. 1 root ftpmaster 0 Jun 16 11:51 cgroup.event_control + # -r--------. 1 root ftpmaster 0 Jun 16 11:51 cgroup.procs + # -r--------. 1 root ftpmaster 0 Jun 16 11:51 cpuacct.stat + # -rw-------. 1 root ftpmaster 0 Jun 16 11:51 cpuacct.usage + # -r--------. 1 root ftpmaster 0 Jun 16 11:51 cpuacct.usage_percpu + # -rw-------. 1 root ftpmaster 0 Jun 16 11:51 cpu.rt_period_us + # -rw-------. 1 root ftpmaster 0 Jun 16 11:51 cpu.rt_runtime_us + # -rw-------. 1 root ftpmaster 0 Jun 16 11:51 cpu.shares + # -rw-------. 1 root ftpmaster 0 Jun 16 11:51 notify_on_release + # + # tasks.fperm = 774: + # -rw-rw-r--. 1 root ftpmaster 0 Jun 16 11:51 tasks + .fi .RE ------------------------------------------------------------------------------ EditLive Enterprise is the world's most technically advanced content authoring tool. Experience the power of Track Changes, Inline Image Editing and ensure content is compliant with Accessibility Checking. http://p.sf.net/sfu/ephox-dev2dev _______________________________________________ Libcg-devel mailing list Libcg-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/libcg-devel