~ubuntu-branches/ubuntu/saucy/nut/saucy

« back to all changes in this revision

Viewing changes to man/upsd.8

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2005-07-20 19:48:50 UTC
  • mto: (16.1.1 squeeze)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20050720194850-oo61wjr33rrx2mre
Tags: upstream-2.0.2
ImportĀ upstreamĀ versionĀ 2.0.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH UPSD 8 "Fri Nov  7 2003" "" "Network UPS Tools (NUT)" 
 
1
.TH UPSD 8 "Wed Nov 26 2003" "" "Network UPS Tools (NUT)" 
2
2
.SH NAME
3
3
upsd \- UPS information server
4
4
.SH SYNOPSIS
5
 
.B upsd -h
 
5
.B upsd \-h
6
6
 
7
7
.B upsd [OPTIONS] 
8
8
 
27
27
 
28
28
.SH OPTIONS
29
29
 
30
 
.IP "-c \fIcommand\fR"
 
30
.IP "\-c \fIcommand\fR"
31
31
Send \fIcommand\fR to the background process as a signal.  Valid commands
32
32
are:
33
33
.IP
34
34
.nf
35
 
        reload - reread configuration files
36
 
        stop - stop process and exit
 
35
        reload \(hy reread configuration files
 
36
        stop \(hy stop process and exit
37
37
.fi
38
38
.LP
39
39
 
40
 
.IP "-D"
 
40
.IP "\-D"
41
41
Raise the debug level.  Use this multiple times for additional details.
42
42
 
43
 
.IP "-f"
 
43
.IP "\-f"
44
44
Stay in the foreground for testing.
45
45
 
46
 
.IP "-h"
 
46
.IP "\-h"
47
47
Display the help text.
48
48
 
49
 
.IP "-i \fIinterface\fR"
50
 
Bind the listeners to the interface specified by its internet address.
51
 
This may be useful in situations with internal and external interfaces on
52
 
the same host.
53
 
 
54
 
.IP "-p \fIport\fR"
55
 
Run the UDP and TCP listeners on that port.  This overrides any value
56
 
you may have set with 'configure --with-port'.  If you don't change it
57
 
with configure or this switch, upsd will listen on port 3493.
58
 
 
59
 
.IP "-r \fIdirectory\fR"
 
49
.IP "\-i \fIinterface\fR"
 
50
Bind the listening port to the interface specified by its Internet
 
51
address.  This may be useful on hosts with multiple interfaces.
 
52
You should not rely exclusively on this for security, as it can be
 
53
subverted on many systems.
 
54
 
 
55
.IP "\-p \fIport\fR"
 
56
Listen on TCP port \fIport\fR instead of the default value which was
 
57
compiled into the code.  This overrides any value you may have set
 
58
with 'configure \-\-with\-port'.  If you don't change it with configure
 
59
or this switch, upsd will listen on port 3493.
 
60
 
 
61
.IP "\-r \fIdirectory\fR"
60
62
upsd will \fBchroot\fR(2) to \fIdirectory\fR shortly after startup
61
63
and before parsing any configuration files with this option set.  You
62
64
can use this to create a "jail" for greater security.
65
67
the state path within \fIdirectory\fR.  See \fBupsdrvctl\fR(8) and
66
68
\fBnutupsdrv\fR(8).
67
69
 
68
 
.IP "-u \fIuser\fR"
 
70
.IP "\-u \fIuser\fR"
69
71
Switch to user \fIuser\fR after startup if started as root.  This
70
72
overrides whatever you may have compiled in with 'configure
71
 
--with-user'.
 
73
\-\-with\-user'.
72
74
 
73
 
.IP "-V"
 
75
.IP "\-V"
74
76
Display the version of the program.
75
77
 
76
78
.SH RELOADING
77
79
 
78
80
upsd can reload its configuration files without shutting down the process
79
 
if you send it a SIGHUP or start it again with '-c reload'.  This only works
 
81
if you send it a SIGHUP or start it again with '\-c reload'.  This only works
80
82
if the background process is able to read those files.
81
83
 
82
84
If you think that upsd can't reload, check your syslogs for error messages.
84
86
to adjust your system to make it possible.  Either change the permissions
85
87
on the files, or run upsd as another user that will be able to read them.
86
88
 
87
 
DO NOT make your upsd.conf or upsd.users world-readable, as those files
 
89
DO NOT make your upsd.conf or upsd.users world\(hyreadable, as those files
88
90
hold important authentication information.  In the wrong hands, it could
89
91
be used by some evil person to spoof your master upsmon and command your
90
92
systems to shut down.
118
120
 
119
121
\fBNUT_CONFPATH\fR is the path name of the directory that contains
120
122
\fBupsd.conf\fR and other configuration files.  If this variable is not set,
121
 
\fBupsd\fR uses a built-in default, which is often \fB/usr/local/ups/etc\fR.
 
123
\fBupsd\fR uses a built\(hyin default, which is often \fB/usr/local/ups/etc\fR.
122
124
 
123
125
\fBNUT_STATEPATH\fR is the path name of the directory in which 
124
126
\fBupsd\fR keeps state information.  If this variable is not set,
125
 
\fBupsd\fR uses a built-in default, which is often \fB/var/state/ups\fR.
 
127
\fBupsd\fR uses a built\(hyin default, which is often \fB/var/state/ups\fR.
126
128
The \fBSTATEPATH\fR directive in \fBupsd.conf\fR overrides this variable.
127
129
 
128
130
.SH SEE ALSO
134
136
.SS CGI programs:
135
137
\fBupsset.cgi\fR(8), \fBupsstats.cgi\fR(8), \fBupsimage.cgi\fR(8)
136
138
 
137
 
.SS Driver controller:
138
 
\fBupsdrvctl\fR(8)
139
 
 
140
 
.SS Driver overview:
141
 
\fBnutupsdrv\fR(8)
142
 
 
143
139
.SS Drivers:
144
 
 
145
 
\fBapcsmart\fR(8), \fBbcmxcp\fR(8), \fBbelkin\fR(8),
146
 
\fBbestfortress\fR(8), \fBbestuferrups\fR(8), \fBbestups\fR(8),
147
 
\fBcyberpower\fR(8), \fBdummycons\fR(8), \fBenergizerups\fR(8),
148
 
\fBetapro\fR(8), \fBeverups\fR(8), \fBfentonups\fR(8), \fBferrups\fR(8),
149
 
\fBgenericups\fR(8), \fBhidups\fR(8), \fBisbmex\fR(8), \fBliebert\fR(8),
150
 
\fBmasterguard\fR(8), \fBmge-shut\fR(8), \fBmge-utalk\fR(8),
151
 
\fBmicrodowell\fR(8), \fBnewapc\fR(8), \fBoneac\fR(8),
152
 
\fBpowercom\fR(8), \fBpowernet\fR(8), \fBsafenet\fR(8), \fBsec\fR(8),
153
 
\fBsms\fR(8), \fBsnmp-ups\fR(8), \fBtripplite\fR(8),
154
 
\fBtripplitesu\fR(8), \fBvictronups\fR(8)
 
140
\fBnutupsdrv\fR(8),
 
141
\fBapcsmart\fR(8), \fBbelkin\fR(8), \fBbelkinunv\fR(8),
 
142
\fBbestuferrups\fR(8), \fBbestups\fR(8), \fBcpsups\fR(8),
 
143
\fBcyberpower\fR(8), \fBenergizerups\fR(8), \fBetapro\fR(8),
 
144
\fBeverups\fR(8), \fBfentonups\fR(8), \fBgenericups\fR(8),
 
145
\fBippon\fR(8), \fBisbmex\fR(8), \fBliebert\fR(8), \fBmasterguard\fR(8),
 
146
\fBmge\(hyshut\fR(8), \fBmge\(hyutalk\fR(8), \fBoneac\fR(8),
 
147
\fBpowercom\fR(8), \fBsafenet\fR(8), \fBsms\fR(8), \fBsnmp\-ups\fR(8),
 
148
\fBtripplite\fR(8), \fBtripplitesu\fR(8), \fBvictronups\fR(8), 
155
149
 
156
150
.SS Internet resources:
157
151
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/