.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "APM_GET_POWER_STATUS" "" "06 October 2005" "" ""

.SH NAME
apm_get_power_status \- get current power state
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int apm_get_power_status  (u_short * \fIstatus\fB, u_short * \fIbat\fB, u_short * \fIlife\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIstatus\fB\fR
returned status
.TP
\fB\fIbat\fB\fR
battery info
.TP
\fB\fIlife\fB\fR
estimated life
.SH "DESCRIPTION"
.PP
Obtain the current power status from the APM BIOS. We return a
status which gives the rough battery status, and current power
source. The bat value returned give an estimate as a percentage
of life and a status value for the battery. The estimated life
if reported is a lifetime in secodnds/minutes at current powwer
consumption.