BC proc entries - Revision history

Kir: Reverted edits by StevenCook (talk) to last revision by Kir

2012-08-04T20:46:02Z

Reverted edits by StevenCook (talk) to last revision by Kir

Kir: Reverted edits by ThomasKelly (talk) to last revision by Kir

2012-08-03T06:08:46Z

Reverted edits by ThomasKelly (talk) to last revision by Kir

Kir: added missing UBC toc

2008-04-08T14:27:38Z

added missing UBC toc

Kir: /* Old interface */ is gone, thus past tense

2008-03-02T20:28:07Z

‎Old interface: is gone, thus past tense

Kir: /* New interface */ use full file names, i.e. add /proc/ to some of them; use source tag; formatting; punctuation

2008-03-02T20:27:18Z

‎New interface: use full file names, i.e. add /proc/ to some of them; use source tag; formatting; punctuation

Kir: /* Old interface */ punctuation, formatting, better wording

2008-03-02T20:16:25Z

‎Old interface: punctuation, formatting, better wording

Xemul: misprint

2006-12-27T14:30:32Z

misprint

Xemul: misprint

2006-12-27T13:06:12Z

misprint

Xemul: Added link to IO

2006-12-27T13:05:42Z

Added link to IO

Xemul: Link to old interface

2006-12-27T13:03:21Z

Link to old interface

@@ Line 1: / Line 1: @@
 This page describes proc interface of [[UBC]] subsystem.
@@ Line 89: / Line 90: @@
 </source>
 {{note|Due to limitations in <code>single_open</code> the <code>struct user_beancounter</code> pointer is not passed as <code>void *v</code> into showing function but must be obtained from <code>seq_file</code> with <code>seq_beancounter</code>}}

@@ Line 2: / Line 2: @@
 == Old interface ==
-The [[Proc/user_beancounters|old interface]] consists of 2 (optionally 3) files:
+The [[Proc/user_beancounters|old interface]] consisted of 2 (optionally 3) files:
 ; <code>/proc/user_beancounters</code>
 : reveals an overall information about resource consumption of each beancounter in system; described [[Proc/user_beancounters|here]];

@@ Line 16: / Line 16: @@
 == New interface ==
-In new interface only <code>user_beancounters</code> entry is left for compatibility with old tools. New entries reside in <code>/proc/bc</code> directory. This directory also contains subdirectories for each beancounter in the system. E.g.
+In new interface only <code>/proc/user_beancounters</code> entry is left for compatibility with old tools. New entries reside in <code>/proc/bc</code> directory. This directory also contains subdirectories for each beancounter in the system. E.g.
 <pre>
 # ls /proc/bc/
@@ Line 32: / Line 32: @@
 === Existing general entries ===
 ; <code>/proc/bc/resources</code>
-: This entry looks like old <code>user_beancounters</code> entry but
+: This entry looks like old <code>/proc/user_beancounters</code> entry but
-# it doesn't contain “dummy” resources
+:# it doesn't contain “dummy” resources
-# if new resource is added to BC it will appear in this entry only
+:# if new resource is added to BC it will appear in this entry only
 ; <code>/proc/bc/$BCID/resources</code>
-: This entry shows the same as <code>bc/resources</code> does but for <code>$BCID</code> beancounter only.
+: This entry shows the same as <code>/proc/bc/resources</code> does but for <code>$BCID</code> beancounter only.
 ; <code>/proc/bc/$BCID/vmaux</code>
 : This entry shows auxiliary resources used in VM accounting.
@@ Line 43: / Line 43: @@
 === Other entries ===
-The following subsystems add their own entries in <code>/proc/bc</code> and <code>/proc/bc/$BCID</code>
+The following subsystems add their own entries in <code>/proc/bc</code> and <code>/proc/bc/$BCID</code>:
 * [[IO accounting]]
@@ Line 52: / Line 52: @@
 ; <code>struct bc_proc_entry;</code>
 : This describes an entry that may show per-beancounter info. This looks like this:
-<pre>
+<source lang="c">
 struct bc_proc_entry {
          char *name;
@@ Line 58: / Line 58: @@
          struct bc_proc_entry *next;
 };
-</pre>
+</source>
 * <code>name</code> is the entry name as it will appear in <code>/proc/bc/$BCID</code>
 * <code>show</code> is a callback that is to fill info about particulat beancounter
@@ Line 64: / Line 64: @@
 : This call registers an entry that shows per-beancounter info.
-The code that fills info about BC must look like this
+The code that fills info about BC must look like this:
-<pre>
+<source lang="c">
 static int bc_my_show(struct seq_file *f, void *v)
+{
@@ Line 87: / Line 87: @@
 late_initcall(bc_my_init);
-</pre>
+</source>
 {{note|Due to limitations in <code>single_open</code> the <code>struct user_beancounter</code> pointer is not passed as <code>void *v</code> into showing function but must be obtained from <code>seq_file</code> with <code>seq_beancounter</code>}}
 [[Category:UBC]]

@@ Line 2: / Line 2: @@
 == Old interface ==
-[[Proc/user_beancounters|Old interface]] consisted of 2 (optionally 3) files
+The [[Proc/user_beancounters|old interface]] consists of 2 (optionally 3) files:
-; <code>user_beancounters</code>
+; <code>/proc/user_beancounters</code>
-: reveals an overall information about resource consumption of each beancounter in system
+: reveals an overall information about resource consumption of each beancounter in system; described [[Proc/user_beancounters|here]];
-; <code>user_beancounters_sub</code>
+; <code>/proc/user_beancounters_sub</code>
-: reveals information about all beancounters and sub-beancounters in system
+: reveals information about all beancounters and sub-beancounters in system;
-; <code>user_beancounters_debug</code>
+; <code>/proc/user_beancounters_debug</code>
-: this files is shown if <code>CONFIG_UBC_DEBUG_KMEM</code> option is turned on and shows debugging information about each beancounter. This includes the numbers of
+: shows debugging information about each beancounter. Available if <code>CONFIG_UBC_DEBUG_KMEM</code> option is turned on. Information revealed includes the numbers of
-# objects charged from each slab
+:# objects charged from each slab;
-# pages charged
+:# pages charged;
-# vmalloc-ed pages
+:# vmalloc-ed pages;
-# page beancounters
+:# page beancounters;
-# etc
+:# etc.
 == New interface ==

@@ Line 44: / Line 44: @@
 === Other entries ===
 The following subsystems add their own entries in <code>/proc/bc</code> and <code>/proc/bc/$BCID</code>
-* [[IO_accounting]]
+* [[IO accounting]]
 === Kernel API ===

← Older revision	Revision as of 20:46, 4 August 2012
(No difference)

← Older revision	Revision as of 06:08, 3 August 2012
(No difference)

@@ Line 41: / Line 41: @@
 ; <code>/proc/bc/$BCID/kmem_debug</code>
 : This entry is available with <code>CONFIG_UBC_DEBUG_KMEM</code> option set and shows per-beancounter info that was in <code>/proc/user_beancounters_debug</code> before.
 === Kernel API ===