Penguin
Recent Changes
Annotated edit history of upslog(8) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 UPSLOG
2 !!!UPSLOG
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 LOG ROTATION
8 SEE ALSO
9 ----
10 !!NAME
11
12
13 upslog - UPS status logger
14 !!SYNOPSIS
15
16
17 __upslog -h__
18
19
20 __upslog__ ''ups logfile interval''
21 __[[__''format''__]__
22 !!DESCRIPTION
23
24
25 __upslog__ is a daemon that will poll a UPS at periodic
26 intervals, fetch the variables that interest you, format
27 them, and write them to a file.
28
29
30 The default format string includes variables that are
31 supported by many common UPS models. See the description
32 below to make your own.
33 !!OPTIONS
34
35
36 -h
37
38
39 Display the help message.
40
41
42 ''ups''
43
44
45 Monitor this UPS. The format for this option is
46 [[upsname@]hostname[[:port].
47
48
49 ''logfile''
50
51
52 Store the results in this file.
53
54
55 You can use - for stdout, but upslog will remain in the
56 foreground.
57
58
59 ''interval''
60
61
62 Wait this many seconds between polls.
63
64
65 Remember that a poll is not instantaneous, so it will slip
66 back as the program runs. If you require tighter timing, you
67 should write your own logger using the upsfetch
68 library.
69
70
71 ''format''
72
73
74 The string to log, including variables from the UPS. Valid
75 escapes within this string are:
76
77
78 %% - insert a single %
79
80
81 %TIME format% - insert the time with strftime
82 formatting
83
84
85 %ETIME% - insert the number of seconds, ala time_t. This is
86 now a 10 digit number.
87
88
89 %HOST% - insert the local hostname
90
91
92 %UPSHOST% - insert the host of the UPS being
93 monitored
94
95
96 %PID% - insert the pid of upslog
97
98
99 %VAR varname% - insert the value of variable
100 varname
101
102
103 The default format string is:
104
105
106 %TIME @Y@m@d @H@M@S% %VAR battpct% %VAR utility% %VAR
107 loadpct% [[%VAR status%] %VAR upstemp% %VAR
108 acfreq%
109 !!LOG ROTATION
110
111
112 upslog writes its pid to upslog.pid, and will reopen the log
113 file if you send it a SIGHUP. This allows it to keep running
114 when the log is rotated by an external program.
115 !!SEE ALSO
116
117
118 __Server:__
119
120
121 upsd(8)
122
123
124 __Clients:__
125
126
127 upsc(8), upscmd(8), upsct(8),
2 perry 128 upsct2(8), upsmon(8)
1 perry 129
130
131 __Internet resources:__
132
133
134 The NUT (Network UPS Tools) home page:
135 http://www.exploits.org/nut/
136
137
138 NUT mailing list archives and information:
139 http://lists.exploits.org/
140 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.