16
edits
Changes
→Reading: fixed a typo
{{UBC toc}}
{{wrongtitle|DISPLAYTITLE:/proc/user_beancounters}}
The proc filesystem entry showing resource control information is <code>/proc/user_beancounters</code> file. An example content of <code>/proc/user_beancounters</code> is shown below.
{{Note|This article describes an old interface. This is kept for compatibility and [[BC proc entries|new one]] will be used since <code>028test008</code> kernel}}
== Example ==
== Fields ==
The field '''<code>uid</code>''' is a numeric identifier of the Virtual Environmentcontainer<ref>The name “uid” is related to the fact that OpenVZ Resource Management can be used without virtualization and Virtual Environmentscontainers.</ref>.
For accountable parameters, the field '''<code>held</code>''' shows the current counter for the Virtual Environment container (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 Environmentcontainer<ref>The lifetime of a Virtual Environment container is the period from the start of the VE container till the time all processes in the VE container 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 Environmentcontainer.</ref>.
The field '''<code>failcnt</code>''' shows the number of refused “resource allocations” for the whole lifetime of the process group.
the <code>limit</code> for the parameter.
== Units of measurement ==As also discussed in [[{{Main|UBC parameter units]], all values related to parameters withnames starting with <code>num</code> are measured in pieces. Values related to parameterswith names ending with pages are measured in memory pages (memory page is 4 kilobytes onx86 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_ULONGLONG_MAX]] in the corresponding field. == Reading == {{Note|It's easier to use [[BC proc entries|the new <code>/proc/bc</code> interface]], i.e. <code>cat /proc/bc/$CTID/resources</code>.}} If you want to print UBC values for a specific container, the following construct can be helpful <nowiki>egrep -A23 "${CTID}:" /proc/user_beancounters</nowiki> Or with headers, though slightly harder to remember: <nowiki>sed -nr "1,2p;/${CTID}:/,+23p" /proc/user_beancounters</nowiki> Here <code>${CTID}</code> is the ID of the container you are interested in. In case you want to print UBC values for a few containers at once, set CTID to something like <code>(101|102|103)</code>.
== Notes ==
<references/>