Man/vzubc.8 - Revision history

Botinki Kira: Automated import of articles * existing text overwritten *

2013-10-30T01:44:13Z

Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles * existing text overwritten *

2013-06-02T05:45:37Z

Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles * existing text overwritten *

2013-05-03T01:53:33Z

Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles * existing text overwritten *

2011-06-16T17:04:34Z

Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles * existing text overwritten *

2011-06-06T15:43:37Z

Automated import of articles *** existing text overwritten ***

195.214.232.10: export newer version (no manual changes ;))

2011-06-03T16:48:34Z

export newer version (no manual changes ;))

Kir: beta version of man2wiki man page (work in progress!)

2011-05-29T21:22:59Z

beta version of man2wiki man page (work in progress!)

New page

== NAME ==

vzubc −
show User Beancounters in a human-readable format.

== SYNOPSIS ==

vzubc
[option ...] [CTID ...]

== DESCRIPTION ==

This utility
aims to show current values for User Beancounter in a
human-readable format. Values that are in pages are
converted into bytes, then long values are converted into
kilo-, mega- gigabytes etc. For held and maxheld, it shows
how close the values are to the barrier and to the limit.
Zero and unlimited values are shown as -.

One or several
CTIDs can be specified to limit the output to the
given containers. Each CTID can be either a name or a
numeric ID. Note that names can only be used if there is a
container on the system with that name (vzlist -o
ctid name command is used for name to ID
conversion). Unknown CTIDs are ignored.

The utility can
also be used from inside the container, in this case it only
shows the values for that container (and it doesn’t
make sense to specify CTID).

== OPTIONS ==

-w, --watch

Watch mode: run itself under
watch(1), redisplaying the output every 2 seconds (by
default) until interrupted by Ctrl-C.

<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">

-wd</td>
<td width="7%"></td>
<td width="78%">

Make watch highlight the differences between
current and previous output (corresponds to watch -d
option). </td></tr>
</table>

-wn time

Refresh interval for
watch(8), in seconds (corresponds to watch -n
time).

-q, --quiet

Quiet mode. In this mode,
vzubc only shows beancounters with fails and those
with held/maxheld values close to limits.

-qh ratio

Quiet threshold for held to
limit ratio. Default is 0.5 (50%).

-qm ratio

Quiet threshold for maxheld to
limit ratio. Default is 0.8 (80%).

-r, --relative

Relative mode: for fail
counters, instead of showing the absolute value, calculate
the difference from the previous run. This mode is denoted
by a + sign before the FAIL column header.

-rd dir

Set a directory for saving fail
counters to dir (default is
/tmp/vzubc.store).

<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">

-rc</td>
<td width="7%"></td>
<td width="52%">

Clear all saved fail counter data.</td>
<td width="26%">
</td></tr>
</table>

-i, --incremental

Incremental mode. Shows an
additional column with a difference in held value from the
previous run. This option also affects quiet mode: all lines
with changed held values are shown. Held data is saved to
the same directory as fail counter data.

-id dir

A synonym for -rd.

<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">

-ic</td>
<td width="7%"></td>
<td width="40%">

Clear all saved held data.</td>
<td width="38%">
</td></tr>
</table>

-c, --color

Enable color highlighting. Not
compatible with --watch. Same thresholds as for quiet
mode are used to highlight "more important" lines,
plus the lines with non-zero fail counters are
highlighted.

-f | --file
filename

Read User Beancounters from
filename. By default this is
/proc/bc/resources or, if that one is not available,
/proc/user_beancounters. Use - to read from
standard input.

== EXAMPLES ==

vzubc 101
web dns

Show all beancounters for CTID
101 and for CTs named web and dns.

vzubc -w -wd -wn 10
101

Display beancounters for CT 101
every 10 seconds, highlighting the changes. Interrupt with
Control-C.

vzubc -q -c

Show beancounters with held or
maxheld close to limits, plus those with non-zero fail
counters, with colors.

vzubc -q -qh 0.8 -qm
1

Show beancounters with held
value equal to or more than 80% of a limit, and/or with
maxheld value equal or more than a limit, plus those with
non-zero fail counters.

vzubc -w -q -r

Display beancounters with held
and maxheld close to limits, plus those with increasing fail
counters.

vzubc -r -q -qh 2 -qm
2

Only show beancounters with
increased (since the last run) fail counters.

vzubc -rc -ic

Show all beancounters, and
clear all saved data for relative and incremental mode (i.e.
saved values for fail counter and held).

== FILES ==

/proc/bc/resources
 
/proc/user_beancounters 
/tmp/vzubc.store/ubc.*

== SEE ALSO ==

watch(1),
[[Man/vzlist.8|vzlist(8)]], [[Man/vzmemcheck.8|vzmemcheck(8)]],
[[Man/vzcfgvalidate.8|vzcfgvalidate(8)]],
[[UBC]].

== LICENSE ==

Copyright (C)
2011, Parallels, Inc. Licensed under GNU GPL.

@@ Line 77: / Line 77: @@
 <p style="margin-left:22%;">Quiet mode. In this mode,
 <b>vzubc</b> only shows beancounters with fails and those
-with held/maxheld values close to limits.</p>
+with held/maxheld values close to limits.
 <p style="margin-left:11%;"><b>-qh&nbsp;</b><i>ratio</i></p>

@@ Line 61: / Line 61: @@
 <td width="78%">
-<p>Instruct <b>watch</b>(1) to now show its title
+<p>Instruct <b>watch</b>(1) to not show its title
 (interval, command, and current time at the top of the
 display, as well as the following blank line). Corresponds

@@ Line 51: / Line 51: @@
 <p>Make <b>watch</b>(1) highlight the differences between
-current and previous output (corresponds to <b>watch -d</b>
+current and previous output. Corresponds to <b>watch -d</b>
-option).</p> </td></tr>
+option.</p> </td></tr>
 </table>

@@ Line 25: / Line 25: @@
 container on the system with that name (<b>vzlist -o
 ctid</b> <i>name</i> command is used for name to ID
-conversion). Unknown CTIDs are ignored.</p>
+conversion). Unknown <i>CTID</i>s are ignored.</p>
 <p style="margin-left:11%; margin-top: 1em">The utility can
 also be used from inside the container, in this case it only
 shows the values for that container (and it doesn&rsquo;t
-make sense to specify <b>CTID</b>).</p>
+make sense to specify <i>CTID</i> argument).</p>
 == OPTIONS ==
@@ Line 198: / Line 198: @@
 == FILES ==
-<p style="margin-left:11%; margin-top: 1em">/proc/bc/resources
+<pre style="margin-left:11%; margin-top: 1em">/proc/bc/resources
-<br>
+/proc/user_beancounters
-/proc/user_beancounters <br>
+/tmp/vzubc.store/ubc.*</pre>
-== DIAGNOSTICS ==
+== EXIT STATUS ==
 <p style="margin-left:11%; margin-top: 1em">Returns 0 upon

@@ Line 2: / Line 2: @@
 <p style="margin-left:11%; margin-top: 1em">vzubc &minus;
-show User Beancounters in a human-readable format.</p>
+show User Beancounters in a human-readable format</p>
 == SYNOPSIS ==
@@ Line 50: / Line 50: @@
 <td width="78%">
-<p>Make <b>watch</b> highlight the differences between
+<p>Make <b>watch</b>(1) highlight the differences between
 current and previous output (corresponds to <b>watch -d</b>
 option).</p> </td></tr>
@@ Line 58: / Line 58: @@
 <p style="margin-left:22%;">Refresh interval for
-<b>watch</b>(8), in seconds (corresponds to <b>watch -n</b>
+<b>watch</b>(1), in seconds (corresponds to <b>watch -n</b>
 <i>time</i>).</p>
@@ Line 202: / Line 202: @@
 /proc/user_beancounters <br>
 /tmp/vzubc.store/ubc.*</p>
 == SEE ALSO ==

@@ Line 155: / Line 155: @@
 <p style="margin-left:22%;">Show all beancounters for CTID
-and for CTs named <b>web</b> and dns.</p>
+and for CTs named <b>web</b> and <b>dns</b>.</p>
 <p style="margin-left:11%;"><b>vzubc -w -wd -wn 10

Man/vzubc.8 - Revision history

Botinki Kira: Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles *** existing text overwritten ***

Botinki Kira: Automated import of articles *** existing text overwritten ***

195.214.232.10: export newer version (no manual changes ;))

Kir: beta version of man2wiki man page (work in progress!)

Botinki Kira: Automated import of articles * existing text overwritten *

Botinki Kira: Automated import of articles * existing text overwritten *

Botinki Kira: Automated import of articles * existing text overwritten *

Botinki Kira: Automated import of articles * existing text overwritten *

Botinki Kira: Automated import of articles * existing text overwritten *