Blame


1 d2618eef 2024-01-11 benni .\"
2 d2618eef 2024-01-11 benni .\" Copyright (c) 2023 Benjamin Stürz
3 d2618eef 2024-01-11 benni .\"
4 d2618eef 2024-01-11 benni .\" Permission to use, copy, modify, and distribute this software for any
5 d2618eef 2024-01-11 benni .\" purpose with or without fee is hereby granted, provided that the above
6 d2618eef 2024-01-11 benni .\" copyright notice and this permission notice appear in all copies.
7 d2618eef 2024-01-11 benni .\"
8 d2618eef 2024-01-11 benni .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 d2618eef 2024-01-11 benni .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 d2618eef 2024-01-11 benni .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 d2618eef 2024-01-11 benni .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 d2618eef 2024-01-11 benni .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 d2618eef 2024-01-11 benni .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 d2618eef 2024-01-11 benni .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 d2618eef 2024-01-11 benni .\"
16 d2618eef 2024-01-11 benni .Dd $Mdocdate$
17 d2618eef 2024-01-11 benni .Dt APMTOP 1
18 d2618eef 2024-01-11 benni .Os
19 d2618eef 2024-01-11 benni .Sh NAME
20 d2618eef 2024-01-11 benni .Nm apmtop
21 d2618eef 2024-01-11 benni .Nd monitor power-usage-related statistics
22 d2618eef 2024-01-11 benni .Sh SYNOPSIS
23 d2618eef 2024-01-11 benni .Nm
24 d2618eef 2024-01-11 benni .Op Fl d Ar delay
25 d2618eef 2024-01-11 benni .Op Fl V
26 d2618eef 2024-01-11 benni .Sh DESCRIPTION
27 d2618eef 2024-01-11 benni .Nm
28 d2618eef 2024-01-11 benni is a little utility useful for monitoring power-usage-related statistics.
29 d2618eef 2024-01-11 benni .Pp
30 d2618eef 2024-01-11 benni .Sy Note: This program is still in development and will change.
31 d2618eef 2024-01-11 benni .Pp
32 d2618eef 2024-01-11 benni The options are as follows:
33 d2618eef 2024-01-11 benni .Bl -tag -width -Ds
34 d2618eef 2024-01-11 benni .It Fl d Ar delay
35 d2618eef 2024-01-11 benni The refresh delay in tenths of seconds. (default: 10)
36 d2618eef 2024-01-11 benni .It Fl V
37 d2618eef 2024-01-11 benni Print the version of apmtop(1) and exit.
38 d2618eef 2024-01-11 benni .El
39 d2618eef 2024-01-11 benni .Pp
40 d2618eef 2024-01-11 benni .Bl -tag -width 8n
41 d2618eef 2024-01-11 benni The keybindings are as follows:
42 d2618eef 2024-01-11 benni .It Ar q
43 d2618eef 2024-01-11 benni Quit the program.
44 d2618eef 2024-01-11 benni .It Ar 1-5
45 d2618eef 2024-01-11 benni Show/hide panes 1 through 5.
46 d2618eef 2024-01-11 benni .It Ar +/-
47 d2618eef 2024-01-11 benni Increase/decrease delay.
48 d2618eef 2024-01-11 benni .It Ar (space)
49 d2618eef 2024-01-11 benni Pause/resume measuring.
50 d2618eef 2024-01-11 benni .El
51 d2618eef 2024-01-11 benni .Sh TODO
52 d2618eef 2024-01-11 benni .Bl -bullet
53 d2618eef 2024-01-11 benni .It
54 d2618eef 2024-01-11 benni Fancier graphs using Unicode characters.
55 d2618eef 2024-01-11 benni .It
56 d2618eef 2024-01-11 benni Being able to specify which sensors to use,
57 d2618eef 2024-01-11 benni .It
58 d2618eef 2024-01-11 benni or just show all sensors.
59 d2618eef 2024-01-11 benni .It
60 d2618eef 2024-01-11 benni Show a warning instead of showing -1 (or similar), when a sensor is missing.
61 d2618eef 2024-01-11 benni .It
62 d2618eef 2024-01-11 benni Show something, when min=max.
63 d2618eef 2024-01-11 benni .It
64 d2618eef 2024-01-11 benni Put an empty line before the keybindings-subsection.
65 d2618eef 2024-01-11 benni .El
66 d2618eef 2024-01-11 benni .Sh EXIT STATUS
67 d2618eef 2024-01-11 benni .Ex -std
68 d2618eef 2024-01-11 benni .Sh SEE ALSO
69 d2618eef 2024-01-11 benni .Xr apm 8 ,
70 d2618eef 2024-01-11 benni .Xr sysctl 8 ,
71 d2618eef 2024-01-11 benni .Xr top 1
72 d2618eef 2024-01-11 benni .Sh COMPATIBILITY
73 d2618eef 2024-01-11 benni OpenBSD does not support all kinds of temperature/power/battery sensors.
74 d2618eef 2024-01-11 benni So, make sure that you actually have the sensors you want to measure.
75 d2618eef 2024-01-11 benni This can be done, by comparing apmtop's graphs with the output of the following command:
76 d2618eef 2024-01-11 benni .Pp
77 d2618eef 2024-01-11 benni .Dl $ sysctl hw.sensors
78 d2618eef 2024-01-11 benni .Pp
79 d2618eef 2024-01-11 benni If you still think, that apmtop(1) shows incorrect data,
80 d2618eef 2024-01-11 benni please contact the maintainer.
81 d2618eef 2024-01-11 benni .Sh AUTHORS
82 d2618eef 2024-01-11 benni .An Benjamin Stürz Aq Mt benni@stuerz.xyz