meter

meter pathName [option value...]

The meter command creates a new resource meter widget named pathName. A meter widget can contain CPU, memory, network interface and or disk gauges, depending on the presence and order of the -cpu, -mem, -if, and -disk options; and may be oriented vertically or horizontally, depending on the use of the -orient option.

Standard Options

-activebackground -activeforeground -background
-borderwidth -cursor -foreground
-highlightbackground -highlightcolor -highlightthickness
-relief                      

Canvas Options

-height height
           Desired height, in screen units, that the meter's canvas should request from its geometry manager (default 68).
-width width
           Width, in screen units, that the meter's canvas should request from its geometry manager (default 60).

Widget-Specific Options

-button boolean
           Whether the widget should emulate button behaviour, by changing the foreground and background colours to the active foreground and background colours and back as the cursor enters and leaves the widget, and by pressing the button in and out when clicked.
-command tclCommand
           Command to be evaluated when the widget is clicked.
-color1 color
           Colour to use for visualising physical memory, user cpu time and incoming data (default blue).
-color2 color
           Colour to use for visualising swap space, system cpu time and outgoing data (default red).
-color3 color
           Colour to use for visualising nice cpu time (default yellow).
-cpu boolean
           Whether a CPU meter should be displayed in the widget. User time is shown in colour 1 (default blue), system time in colour 2 (default red). On Linux systems, nice time is also shown in colour 3 (default yellow). On BSD, nice time is included in the user time figure.
-disk diskName
           Which disk or partition to display activity for. If diskName is 1, true or yes, the first available hard disk is shown. If diskName is 0, false, no, or an empty string, all disks are removed from the meter, and any subsequent -disk options are applied to the end of the list. On Linux systems, reads are shown in colour 1 (default blue), and writes in colour 2 (default red). On BSD systems, all activity is shown in colour 1 (default blue).
-font fontName
           Font for drawing titles (legend) underneath or beside the meters (default Helvetica 8). The legend and the meter outlines are displayed in the foreground colour (default black).
-if interfaceName
           Which network interface to display activity for. If interfaceName is 0, false, no, or an empty string, all network interfaces are removed from the meter, and any subsequent -if options are applied to the end of the list. Incoming data is shown in colour 1 (default blue), outbound data in colour 2 (default red).
-interval seconds
           Update frequency in whole seconds (default 1).
-legend labelList
           A list of labels to use as legends for the meters. The number of labels should match the number of -cpu, -mem, -if and -disk options. If less are given, the remaining labels are left blank. If no labels are given, the default legend is taken from the command line options.
-mem boolean
           Whether a memory meter should be displayed in the widget. Physical memory is shown in colour 1 (default blue), swap usage in colour 2 (default red). On BSD systems, a line in the foreground colour (default black) indicates the level of active virtual memory within the memory use, but swap usage is not available through the vmstat command.
-orient orientation
           The orientation in which the widget should be laid out. Valid orientation values are vertical or horizontal (default vertical).
-padx width
           Extra space, in screen units, to request for padding the widget's left and right sides, i.e. the margins. Also used to separate adjacent meters from each other within the widget (default 2).
-pady height
           Extra space, in screen units, to request for padding the widget's top and bottom sides, i.e. the margins (default 2).

Methods

pathName configure [option value] ...
           If one or more option-value pairs are specified, the given options are set to the given values. If no option-value pairs are specified, the command returns a list with an element for each supported widget option, each element itself a list of five items describing an option. The five items are the option itself, its database name, its class name, its default value, and its current value. If only the first option argument is specified, just the five-item list describing that option is returned.
When configuring -disk and -if options, values are applied from left to right, or top to bottom, to the disk and network items already displayed on the widget. If less -disk or -if options are given than are displayed on the widget, the remaining displayed items are unchanged; if more are given, new items are added to the end and the items are resized accordingly. If the value of a -disk or -if option is 0, no, false or an empty string, all disks/interfaces are removed from the meter, and subsequent -disk or -if options are applied to the end.
pathName cget option value
           Returns the current setting of the option option.
pathName invoke
           Invokes the Tcl command associated with the meter and returns its result. An empty string is returned if there is no command associated with the meter.