.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH pwrkap_cli 1 "January 2009" Linux "User Manuals"
.SH NAME
pwrkap_cli \- Command line monitor and control program for pwrkap
.SH SYNOPSIS
.B pwrkap_cli
.I host:port
.SH DESCRIPTION
.B pwrkap_cli
is a command-line program that connects to a pwrkap server and downloads the
hardware configuration and power configuration domain data from the server.
Power use, energy use, and system status are dumped to the screen when the
server sends a status update, and raw commands can be sent to the server.
.SH OPTIONS
.IP "host:port"
A hostname (or IP address) and a port to which this client should connect.
.SH COMMAND FORMAT
The command format looks like this:

.I domain_name
.B [ help | dump | cap
.I new_cap
.B ]
.SH COMMANDS
.IP domain_name
The name of the power configuration domain that the user wants to control.
.IP help
Displays a short help screen.
.IP dump
Displays the current hardware configuration and state of the server.
.IP "cap new_cap"
Sets a new power cap and reconfigures the hardware to meet the cap.
.SH AUTHOR
Darrick J. Wong <djwong at us dot ibm dot com>
.SH "SEE ALSO"
.BR pwrkap_gtk (1),
.BR pwrkap_aggregate (8),
.BR pwrkap_main (8)