DSTAT(1)

NAME
dstat - dwm status bar statistics

SYNOPSIS
dstat if
dstat version

DESCRIPTION
dstat is a lightweight utility to set the dwm(1) status bar text. dstat displays the current network throughput for the given interface if, wireless signal quality, CPU usage, performance settings, battery status, temperature, volume settings, as well as the current date and time on the dwm(1) status bar.

The arguments are as follows:

if  Specify the interface to collect the network statistics.

version
    Print the version and copyright information of dstat to the standard output, then exit.

dstat is supposed to be started with the dwm(1) session. dstat updates the statistics shown on the dwm(1) status bar every second using the results from ioctl(2,) calls as well as calls to apm(4), audio(4), getifaddrs(3), sysctl(3), and time(3). dstat displays a warning window if the estimated number of minutes for the remaining battery life drops below 10 minutes.

EXIT STATUS

EXAMPLES
Run dstat using the urtwn0 network interface:

    $ dstat urtwn0 &

Print version and copyright information of dstat to the standard output stream and exit successfully:

    $ dstat version

dstat can also be used with tint2(1) by adding an executor to the panel items within the tint2(1) configuration, like in the following:

    execp = new
    execp_command = /usr/local/bin/dstat trunk0
    execp_interval = 0
    execp_continuous = 1
    panel_items = TE

SEE ALSO
dwm(1), ioctl(2), getifaddrs(3), sysctl(3), time(3), apm(4), audio(4)

STANDARDS
The dstat utility is not compliant with any specification.

Where portability is paramount, do not use it.

HISTORY
The first version of the dstat utility was a shell script and appeared back in May 2013.

AUTHORS
-nosplit dstat was written by Joerg Jung <mail@umaxx.net>.

CAVEATS
Displayed wireless signal quality is rather coarse grained.

HOMEPAGE
https://www.umaxx.net/