lbcdclient

(Query a remote lbcd daemon for system load)

SYNOPSIS

lbcdclient [-2] [-s service[,service ...]] host ...

DESCRIPTION

lbcdclient sends a query packet to a remote lbcd server and prints the results. The result output will look something like this:

    btime 1092858021 ctime 1092960298 utime 1092955199
    load l1 96 l5 69 l15 57
    total 0 unique 0 console 0
    tmp full 0 P_tmpdir full 2
    services 0 pads 0 0
    service 0: weight 1 increment 1

btime is the time of the last system boot in seconds since epoch. ctime is the current system time in seconds since epoch. utime is the last modification time of the information about logged in users in seconds since epoch.

The load line gives the one-minute (l1), five-minute (l5), and fifteen-minute (l15) load averages, multiplied by 100.

The next line gives the count of logged-in users. total gives the count of all logged-in users, unique lists the total number of unique users, and console is 1 if a user is logged in to the console of the system.

tmp full is the percentage used in the system /tmp directory and P_tmpdir full is the percentage full in the system /var/tmp directory.

Finally, the last lines give information for each service, using the extended service response for the version three packet format. The first line gives the count of number of configured services minus one. (The pads numbers are reserved space in the packet and will generally always be zero.) Then, each subsequent line lists the weights and increments for each service lbcd is monitoring on the system.

If the -2 option is used, lbcdclient will send a version two packet instead, and the returned results will not include the services line and everything after that.

OPTIONS

-2

Send a version two protocol packet instead of a version three packet. Version two doesn't support the separate service weights.

-s service,[service ...]

Request information for the specified service names. It's not entirely clear whether this works correctly.

SEE ALSO

lbcd(8)

The current version of this program is available from its web page at <http://www.eyrie.org/~eagle/software/lbcd/>.

AUTHORS

Written by Larry Schwimmer. Currently maintained by Russ Allbery <rra@stanford.edu>.

Last spun 2004-11-17 from POD modified 2004-11-16