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 argument).

OPTIONS

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

       -wd    Make watch(1) highlight the differences between current and previous output. Corresponds to  watch
              -d option.

       -wt    Instruct  watch(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 to watch -t option.

       -wn time
              Refresh interval for watch(1), 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.  -v, --verbose Verbose mode. In this mode, vzubc also shows beancounters
              with barrier set to unlimited (those are hidden by default).

       -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).

       -rc    Clear all saved fail counter data.

       -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.

       -ic    Clear all saved held data.

       -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.*

EXIT STATUS

       Returns 0 upon successful execution, 1 otherwise.

SEE ALSO

       watch(1), vzlist(8), vzmemcheck(8), vzcfgvalidate(8), http://wiki.openvz.org/UBC.

LICENSE

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

OpenVZ                                             2 May 2013                                           vzubc(8)