ref: edb6f64d357aa270c1266c652876788f96f50f7a
parent: 02f19713a101f2cab3ef6b89ed6ca8b59ee11ffb
author: Sigrid <ftrvxmtrx@gmail.com>
date: Thu Jul 30 07:25:14 EDT 2020
aux/acpi: write a man page, fix usage, call threadexits
--- /dev/null
+++ b/sys/man/8/acpi
@@ -1,0 +1,61 @@
+.TH ACPI 8
+.SH NAME
+acpi \- Advanced Configuration and Power Interface
+.SH SYNOPSIS
+.I (in plan9.ini)
+.B *acpi=
+.PP
+.B aux/acpi
+[
+.B -m
+.I mountpoint
+]
+[
+.B -s
+.I service
+]
+.SH DESCRIPTION
+.I Aux/acpi
+presents at
+.I mountpoint
+(default
+.BR /mnt/acpi )
+an interface to the ACPI. If a
+.I service
+is specified, the interface will be
+posted at
+.BI /srv/ service
+as well.
+.PP
+The directory contains the following files.
+.TP
+.B battery
+Contains one line for each battery in the system. Each line lists 12
+fields: the percent charge remaining, power unit used (mW or mA),
+remaining capacity, last full charge capacity, design capacity,
+warning and low capacity values,
+.BR "mV"
+separator, present voltage, design voltage, approximate time of charge
+left as
+.BR hh:mm:ss ,
+and the status (a string, one of
+.BR unknown ,
+.BR critical ,
+.BR discharging
+or
+.BR charging ).
+.TP
+.B cputemp
+Each line provides a current temperature reading of a specific CPU.
+.TP
+.B ctl
+The
+.B ctl
+file currently does not provide any functionality.
+.SH SOURCE
+.B /sys/src/cmd/aux/acpi.c
+.SH BUGS
+ACPI itself.
+.SH HISTORY
+.I Acpi
+first appeared in 9front (October, 2016).
--- a/sys/man/8/apm
+++ b/sys/man/8/apm
@@ -110,3 +110,5 @@
.B off
should be supported but doing so requires
nontrivial help from the kernel.
+.SH "SEE ALSO"
+.IR acpi (8)
--- a/sys/src/cmd/aux/acpi.c
+++ b/sys/src/cmd/aux/acpi.c
@@ -417,7 +417,7 @@
static void
usage(void)
{- fprint(2, "usage: aux/acpi [-D] [-d /dev] [-m /mnt/acpi] [-s service]\n");
+ fprint(2, "usage: aux/acpi [-Dp] [-m /mnt/acpi] [-s service]\n");
exits("usage");}
@@ -454,6 +454,8 @@
case 's':
srv = EARGF(usage());
break;
+ default:
+ usage();
}ARGEND
if((ec = open("/dev/ec", ORDWR)) < 0)@@ -500,7 +502,7 @@
amlenum(amlroot, "_PSL", enumtmp, nil);
threadpostmountsrv(&fs, srv, mtpt, MREPL);
- return;
+ threadexits(nil);
fail:
fprint(2, "%r\n");