Open main menu

OpenVZ Virtuozzo Containers Wiki β

Changes

Proc/user beancounters

2,303 bytes added, 08:24, 22 August 2006
Expanded a lot, added fields descriptions etc.
{{UBC toc}}
File The proc filesystem entry showing resource control information is <code>/proc/user_beancounters</code> shows in-kernel [[UBC]] parameter settingsfile. Here An example content of <code>/proc/user_beancounters</code> is how it looks like:shown below.
== Fields ==
 
=== <code>uid</code> ===
The field <code>uid</code> is a numeric identifier of the Virtual Environment<ref>The name “uid” is related to the fact that OpenVZ Resource Management can used without virtualization and Virtual Environments.</ref>.
 
=== <code>held</code> and <code>maxheld</code> ===
For accountable parameters, the field <code>held</code> shows the current counter for the Virtual Environment (resource “usage”), and the field <code>maxheld</code> shows the counter's maximum for the last accounting period. The accounting period is usually the lifetime of the Virtual Environment<ref>The lifetime of a Virtual Environment is the period from the start of the VE till the time all processes in the VE exited and all resources used by these processes are freed. Usually, the lifetime is just the time between the start and the stop of the Virtual Environment.</ref>.
 
=== <code>failcnt</code> ===
The field <code>failcnt</code> shows the number of refused “resource allocations” for the whole lifetime of the process group.
 
=== <code>barrier</code> and <code>limit</code> ===
The <code>barrier</code> and <code>limit</code> fields are resource control settings. For some
parameters, only one of them may be used, for some parameters — both.
These fields may specify limits or guarantees, and the exact meaning of
them is parameter-specific. Description of each parameter in [[UBC parameters]]
contains information about the difference between the <code>barrier</code> and
the <code>limit</code> for the parameter.
 
== Units of measurement ==
As also discussed in [[UBC parameter units]], all values related to parameters with
names starting with <code>num</code> are measured in pieces. Values related to parameters
with names ending with pages are measured in memory pages (memory page is 4 kilobytes on
x86 and x86_64 hardware, others may differ). Values related to other parameters are measured in bytes.
 
== Settings ==
 
General notes about parameters and their barrier and limit settings
are provided in [[UBC parameters]]. Parameters not having limit setting have
[[MAX_ULONG]] in the corresponding field.
 
== Example of <code>/proc/user_beancounter</code> ==
<pre>
# cat /proc/user_beancounters
numiptent 10 16 128 128 0
</pre>
 
== Notes ==
<references/>