UPSD(8) Network UPS Tools (NUT) UPSD(8)NAMEupsd - UPS information server
SYNOPSISupsd-h
upsd-V
upsd [-p port] [-t port] [-i interface] [-f] [-u user] [-c
command]
DESCRIPTIONupsd is responsible for serving the data from the drivers
to the clients. It listens on network ports and delivers
the data from the state files or shared memory used by the
drivers. It also conveys administration messages from the
clients such as upsrw(8) or upscmd(8) back to the drivers.
This program is essential, and must be running at all
times to actually make any use out of the drivers and
clients.
Controls in the configuration files allow you to limit
access to the server, but you should also use a firewall
for extra protection. Client processes such as upsmon(8)
trust upsd for status information about the UPS hardware,
so keep it secure.
OPTIONS-c command
Send command to the background process as a signal.
Valid commands are:
reload - reread configuration files
stop - stop process and exit
-f Stay in the foreground for testing.
-h Display the help text.
-i interface
Bind the listeners to the interface specified by
its internet address. This may be useful in situa-
tions with internal and external interfaces on the
same host.
-p port
Run the UDP and TCP listeners on that port. This
overrides any value you may have set with 'config-
ure --with-port'. If you don't change it with con-
figure or this switch, upsd will listen on port
3493.
-t port
Run just the TCP listener on that port. If you
want the TCP and UDP listeners on different ports
for some reason, use -p, then follow it with -t.
-u user
Switch to user user after startup if started as
root. This overrides whatever you may have com-
piled in with 'configure --with-user'.
-V Display the version of the program.
RELOADINGupsd can reload its configuration files without shutting
down the process if you send it a SIGHUP or start it again
with '-c reload'. This only works if the background pro-
cess is able to read those files. Since upsd gives up
root after reading the files for the first time, this may
not always be the case.
If you think that upsd can't reload, check your syslogs
for error messages. If it's complaining about not being
able to read the files, then you need to adjust your sys-
tem to make it possible. Either change the permissions on
the files, or run upsd as another user that will be able
to read them.
DO NOT make your upsd.conf world-readable, as it contains
passwords and some evil person could pretend to be your
master upsmon and command your systems to shut down.
DIAGNOSTICSupsd expects the drivers to update their status regularly.
By default, they must be refreshed every 15 seconds.
After that, the UPS is declared "stale" and no more infor-
mation will be provided to the clients.
If upsd complains about staleness when you start it, then
either your driver or configuration files are probably
broken. Be sure that the driver is actually running, and
that the UPS definition in ups.conf(5) is correct.
FILES
The general upsd configuration file is upsd.conf(5). The
administrative functions like SET and INSTCMD for users
are defined and controlled in upsd.users(5). UPS defini-
tions are found in ups.conf(5).
SEE ALSO
Clients:
upsc(8), upscmd(8), upsrw(8), upslog(8), upsmon(8)
CGI programs:
upsset.cgi(8), upsstats.cgi(8), upsimage.cgi(8)
Drivers:
nutupsdrv(8), apcsmart(8), bcmxcp(8), belkin(8), bestfer-
rups801-807(8), bestuferrups(8), bestups(8), cyber-
power(8), dummycons(8), dummyups(8), everups(8),
fentonups(8), genericups(8), hidups(8), hp(8), master-
guard(8), mge-ellipse(8), mge-utalk(8), microdowell(8),
newapc(8), powercom(8), powernet(8), sec(8), snmp-ups(8),
tripplite(8), victronups(8)
Internet resources:
The NUT (Network UPS Tools) home page:
http://www.exploits.org/nut/
NUT mailing list archives and information:
http://lists.exploits.org/
Sat Aug 31 2002 UPSD(8)