wiplcSimple

Langue: en

Version: 255298 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

wiplcSimple - Generate tables in HTML or text format containing statistics maintained by wipld

SYNOPSIS

wiplcSimple [ options ] -- counterlist

USE WIPLC INSTEAD

This is the wiplc program from the 991008 release of wipl. This program is much less flexible and more obscure than the new wiplc(1) program. But you find might it easier to use than wiplc for outputting simple tables.

DESCRIPTION

This program will connect to the wipld daemon and display tables based on statistics maintained by the daemon. The space-separated numbers in the counterlist argument describes which columns should be displayed in the table. The numbers can be:
-5
Display the MAC address of the card.
-1 to -4
Display the IP address with 1 to 4 components
>=0
Display the counter with the given number.

OPTIONS

The following options are recognized:
-d daemonfile --daemon daemonfile
Connect to the wipld daemon through the file daemonfile
-o file --outfile file
Write tables to file instead of to stdout.
-c --clearscr
Clear the Linux console before each table is displayed
-s so --sort so
Indicates how the information should be sorted. so can have the same values as the elements of counterlist described above.
-r --sortrev
Reverse the sort order
-p n --periodlen n
Set the period length to n in effect writing a new table every n'th second.
-q n --quittime n
This is used to control how many periods the program should go through. As default the program goes through no periods and will exit immediately after printing the first table. If n is 0 the program will run until terminated. If n is 1 the program will go through exactly one period.

If n is greater than 1 it indicates the date/time where the program should quit. This is given in number of seconds since 1970-01-01 00:00:00 UTC. Such a number can be obtained from the date(1) command. For example the command echo $(date --date 'next monday 00:00' +%s) will print the number corresponding to next monday at 00:00.

-t title --title
If -h is given this will set the title for the HTML page.
-h --html
Write table in HTML instead of in plain text format
-l --long
Use long format in output using several lines to display information about a single entry in the table.
-m --mega
Use megabytes as units (default is kilobytes)
-e --speed
Print speeds and not totals
-i n --history n
This option only makes since if the value given to the -q argument is either 0 or a number greater than 1. Normally the information displayed is based on the start time of the daemon. But when n=0 the tables are based on the starttime of this client program. And when n>0 the tables are based on the information n periods ago.

EXAMPLES

You might want to compare these examples with the examples on the wiplc man page.

To display the values of counter 0 and 1 together with the MAC and IP addresses they are associated with use:

 wiplcSimple -- -5 -4 0 1
 

To write a HTML file every 10th second displaying in KB/s the speed data was transfered with during the last minute for counter 0 and 1 use:

 wiplcSimple \
   --speed --quittime 0 --periodlen 10 --history 6 \
   --html --outfile speed.html -- -5 -4 0 1
 

To write a similar page to the Linux console use:

 wiplcSimple \
   --speed --quittime 0 --periodlen 10 --history 6 \
   --clearscr -- -5 -4 0 1
 

FILES

/etc/wipld.conf
Default daemonfile.

 

SEE ALSO wipl(1), wiplc(1), date(1)