Open main menu

OpenVZ Virtuozzo Containers Wiki β

Changes

UBC parameter units

1,779 bytes added, 18:14, 13 October 2011
Change capitilization on example units to read as (mega/kilo)BYTES instead of BITS
[[User Beancounters]] have default units which are used when viewing and setting the parameter values. When setting the values for some parameters, you are able to specify [[#Overriding Default Units|different units]] thereby avoiding the need to do manual conversion of units and making life a little easier!
 
{{UBC toc}}
== Pages ==
 
Parameters which have the suffix "page" are measured in numbers of [[memory page|pages]]. These include:
 
* [[UBC primary parameters|Primary Parameters]]
** <code>[[vmguarpages]]</code>
 
* [[UBC secondary parameters|Secondary Parameters]]
** <code>[[privvmpages]]</code>
** <code>[[oomguarpages]]</code>
 
* [[UBC auxiliary parameters|Auxiliary Parameters]]
** <code>[[lockedpages]]</code>
** <code>[[shmpages]]</code>
** <code>[[physpages]]</code>
** <code>[[swappages]]</code>
 
When using [[vzctl]] to set these beancounter parameters, you can override the default units of "pages" by using a [[#Overriding Default Units|valid suffix]].
 
 
== Numbers of Items ==
 
Parameters with the prefix "num" are measured in numbers of items:
 
* [[UBC primary parameters|Primary Parameters]]
** <code>[[numproc]]</code>
** <code>[[numtcpsock]]</code>
** <code>[[numothersock]]</code>
# entries which name has word 'page' are measured in * [[memory pageUBC secondary parameters|Secondary Parameters]]s (4K on x86 and x86_64, 16K for IA64). These are <code>privvmpages</code>, <code>oomguarpages</code> and others.# entries with names like 'num*' are measured in items. i.e. <code>numproc</code> - number of processes, <code>numiptent</code> - number of iptables entries.# other entries like <code>kmemsize</code>, <code>tcprcvbuf</code>, <code>tcpsndbuf</code> are measured in bytes * None
== Overriding default units ==* [[UBC auxiliary parameters|Auxiliary Parameters]]** <code>[[numfile]]</code>** <code>[[numflock]]</code>** <code>[[numpty]]</code>** <code>[[numsiginfo]]</code>** <code>[[numiptent]]</code>
  == Bytes == Other parameters are measured in bytes: * [[UBC primary parameters|Primary Parameters]]** None * [[UBC secondary parameters|Secondary Parameters]]** <code>[[kmemsize]]</code>** <code>[[tcprcvbuf]]</code>** <code>[[tcpsndbuf]]</code>** <code>[[othersockbuf]]</code>** <code>[[dgramrcvbuf]]</code> * [[UBC auxiliary parameters|Auxiliary Parameters]]** <code>[[dcachesize]]</code> When using [[vzctl]] to set these beancounter parameters, you can set override the default units explicitly when appropriate (iof "bytes" by using a [[#Overriding Default Units|valid suffix]].e. for all   == Overriding Default Units == When using [[vzctl]] to set beancounter parameters which names are not starting with <code>num</code>*). The use "Pages" or "Bytes" as the default units, alternative units may be specified using one of the following suffixes are available:
{| class="wikitable"
| g, G || gigabytes!Suffix! Alternative Suffix! Units
|-
| m, M g || megabytesG || gigabytes
|-
| k, K m || kilobytesM || megabytes
|-
| k || K || kilobytes|-| p, || P || [[memory page|pages]]s|}  
=== Examples ===
The following are some examples to demonstrate the use of different units when specifying the value of a parameter. Where <code>$CTID</code> is the container ID. * Set <code>kmemsize </code> limit to 512 KbKB
<pre>
# vzctl set $CTID --kmemsize 512k
</pre>
* Set <code>privvmpages </code> limit to 256 MbMB
<pre>
# vzctl set $CTID --privvmpages 256m
</pre>
* Set <code>tcprcvbuf </code> limit to 1000 pages (totals to almost 4 Mb MB on x86)
<pre>
# vzctl set $CTID --tcprcvbuf 1000p
Anonymous user