Penguin
Recent Changes
Annotated edit history of upsd(8) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 UPSD
2 !!!UPSD
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 RELOADING
8 DIAGNOSTICS
9 FILES
10 SEE ALSO
11 ----
12 !!NAME
13
14
15 upsd - UPS information server
16 !!SYNOPSIS
17
18
19 __upsd -h__
20
21
22 __upsd -V__
23
24
25 __upsd [[-p__ ''port''__] [[-t__ ''port''__]
26 [[-i__ ''interface''__] [[-f] [[-u__ ''user''__]
27 [[-c__ ''command''__]__
28 !!DESCRIPTION
29
30
31 __upsd__ is responsible for serving the data from the
32 drivers to the clients. It listens on network ports and
33 delivers the data from the state files or shared memory used
34 by the drivers. It also conveys administration messages from
2 perry 35 the clients such as upsct2(8) or upscmd(8)
1 perry 36 back to the drivers.
37
38
39 This program is essential, and must be running at all times
40 to actually make any use out of the drivers and
41 clients.
42
43
44 Controls in the configuration files allow you to limit
45 access to the server, but you should also use a firewall for
46 extra protection. Client processes such as upsmon(8)
47 trust upsd for status information about the UPS hardware, so
48 keep it secure.
49 !!OPTIONS
50
51
52 -c ''command''
53
54
55 Send ''command'' to the background process as a signal.
56 Valid commands are:
57
58
59 reload - reread configuration files
60 stop - stop process and exit
61
62
63 -f
64
65
66 Stay in the foreground for testing.
67
68
69 -h
70
71
72 Display the help text.
73
74
75 -i ''interface''
76
77
78 Bind the listeners to the interface specified by its
79 internet address. This may be useful in situations with
80 internal and external interfaces on the same
81 host.
82
83
84 -p ''port''
85
86
87 Run the UDP and TCP listeners on that port. This overrides
88 any value you may have set with 'configure --with-port'. If
89 you don't change it with configure or this switch, upsd will
90 listen on port 3305.
91
92
93 -t ''port''
94
95
96 Run just the TCP listener on that port. If you want the TCP
97 and UDP listeners on different ports for some reason, use
98 -p, then follow it with -t.
99
100
101 -u ''user''
102
103
104 Switch to user ''user'' after startup if started as root.
105 This overrides whatever you may have compiled in with
106 'configure --with-user'.
107
108
109 -V
110
111
112 Display the version of the program.
113 !!RELOADING
114
115
116 upsd can reload its configuration files without shutting
117 down the process if you send it a SIGHUP or start it again
118 with '-c reload'. This only works if the background process
119 is able to read those files. Since upsd gives up root after
120 reading the files for the first time, this may not always be
121 the case.
122
123
124 If you think that upsd can't reload, check your syslogs for
125 error messages. If it's complaining about not being able to
126 read the files, then you need to adjust your system to make
127 it possible. Either change the permissions on the files, or
128 run upsd as another user that will be able to read
129 them.
130
131
132 DO NOT make your upsd.conf world-readable, as it contains
133 passwords and some evil person could pretend to be your
134 master upsmon and command your systems to shut
135 down.
136 !!DIAGNOSTICS
137
138
139 upsd expects the model drivers to update their status
140 regularly. By default, they must be refreshed every 15
141 seconds. After that, the UPS is declared
142
143
144 If upsd complains about staleness when you start it, then
145 either your driver or configuration files are probably
146 broken. Be sure that the driver is actually running, and
2 perry 147 that the UPS definition in ups.conf(5) is
1 perry 148 correct.
149 !!FILES
150
151
2 perry 152 The general upsd configuration file is upsd.conf(5).
1 perry 153 The administrative functions like SET and INSTCMD for users
2 perry 154 are defined and controlled in upsd.users(5). UPS
155 definitions are found in ups.conf(5).
1 perry 156 !!SEE ALSO
157
158
159 __Clients:__
160
161
162 upsc(8), upscmd(8), upsct(8),
2 perry 163 upsct2(8), upslog(8),
1 perry 164 upsmon(8)
165
166
167 __CGI programs:__
168
169
2 perry 170 upsset.cgi(8), __multimon.cgi__(8),
171 upsstats.cgi(8), __upsimage.cgi__(8)
1 perry 172
173
174 __Drivers:__
175
176
177 nutupsdrv(8), apcsmart(8), belkin(8),
178 bestups(8), powercom(8)
179
180
181 __Internet resources:__
182
183
184 The NUT (Network UPS Tools) home page:
185 http://www.exploits.org/nut/
186
187
188 NUT mailing list archives and information:
189 http://lists.exploits.org/
190 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.