UBC parameter units

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 different units thereby avoiding the need to do manual conversion of units and making life a little easier!

User Beancounters Definition /proc/user_beancounters /proc/bc/ General information Units of measurement VSwap Parameters description Primary parameters numproc, numtcpsock, numothersock, vmguarpages Secondary parameters kmemsize, tcpsndbuf, tcprcvbuf, othersockbuf, dgramrcvbuf, oomguarpages, privvmpages Auxiliary parameters lockedpages, shmpages, physpages, numfile, numflock, numpty, numsiginfo, dcachesize, numiptent, swappages Internals User pages accounting RSS fractions accounting On-demand accounting UBC consistency Consistency formulae System-wide configuration vzubc(8) Configuration examples Basic Derived Intermediate configurations Tables List of parameters Parameter properties Consistency Config examples

Pages

Parameters which have the suffix "page" are measured in numbers of pages. These include:

• Primary Parameters
  • vmguarpages

• Secondary Parameters
  • privvmpages
  • oomguarpages

• Auxiliary Parameters
  • lockedpages
  • shmpages
  • physpages
  • swappages

When using vzctl to set these beancounter parameters, you can override the default units of "pages" by using a valid suffix.

Numbers of Items

Parameters with the prefix "num" are measured in numbers of items:

• Primary Parameters
  • numproc
  • numtcpsock
  • numothersock

• Secondary Parameters
  • None

• Auxiliary Parameters
  • numfile
  • numflock
  • numpty
  • numsiginfo
  • numiptent

Bytes

Other parameters are measured in bytes:

• Primary Parameters
  • None

• Secondary Parameters
  • kmemsize
  • tcprcvbuf
  • tcpsndbuf
  • othersockbuf
  • dgramrcvbuf

• Auxiliary Parameters
  • dcachesize

When using vzctl to set these beancounter parameters, you can override the default units of "bytes" by using a valid suffix.

Overriding Default Units

When using vzctl to set beancounter parameters which use "Pages" or "Bytes" as the default units, alternative units may be specified using one of the following suffixes:

Suffix	Alternative Suffix	Units
g	G	gigabytes
m	M	megabytes
k	K	kilobytes
p	P	pages

Examples

The following are some examples to demonstrate the use of different units when specifying the value of a parameter. Where $CTID is the container ID.

• Set kmemsize limit to 512 KB

# vzctl set $CTID --kmemsize 512k

• Set privvmpages limit to 256 MB

# vzctl set $CTID --privvmpages 256m

• Set tcprcvbuf limit to 1000 pages (totals to almost 4 MB on x86)

# vzctl set $CTID --tcprcvbuf 1000p