~ubuntu-branches/ubuntu/hardy/net-snmp/hardy-proposed

« back to all changes in this revision

Viewing changes to man/snmpd.8.def

  • Committer: Bazaar Package Importer
  • Author(s): Steve Kowalik
  • Date: 2007-05-10 22:20:23 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20070510222023-2yqbm8wasqpni3c1
Tags: 5.3.1-5ubuntu1
* Merge from Debian unstable.
* Remaining Ubuntu changes:
  - Remove stop links from rc0 and rc6
* Munge Maintainer field as per spec. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
68
68
agent and then exit.
69
69
.TP
70
70
.B -I \fI[-]INITLIST
71
 
This option specifies which modules you do (or do not) want to be
72
 
initialized when the agent starts up.  If the comma-separated
 
71
Specifies which modules should (or should not) be initialized
 
72
when the agent starts up.  If the comma-separated
73
73
.I INITLIST
74
74
is preceded
75
 
with a '-', it is the list of modules that you do
76
 
.I not
77
 
want to be started.  Otherwise,
78
 
.I INITLIST
79
 
is the list of modules to be started.
 
75
with a '-', it is the list of modules that should \fInot\fR be started.
 
76
Otherwise this is the list of the \fIonly\fR modules that should be started.
80
77
 
81
78
To get a list of compiled modules, run the agent with the arguments
82
79
.I "-Dmib_init -H"
83
 
(assumes you have debugging support compiled in).
84
 
.TP
85
 
.BR -l "" " " "[\fIFILE" "" "]"
86
 
Log all output from the agent (including stdout and stderr) to 
87
 
.IR FILE .
88
 
If no filename is given, log to a default file set at compile time
89
 
(normally /var/log/snmpd.log).
90
 
.br
91
 
This option is being deprecated, and '-Lf FILE' should be used instead.
 
80
(assuming debugging support has been compiled in).
92
81
.TP
93
82
.B -L[efos]
94
83
Specify where logging output should be directed (standard error or output,
95
84
to a file or via syslog).  See LOGGING OPTIONS in snmpcmd(5) for details.
96
 
.br
97
 
This option deprecates the
98
 
.B -l
99
 
.B -s
100
 
and
101
 
.B -S
102
 
options.
 
85
.TP
 
86
.BR -m " \fIMIBLIST"
 
87
Specifies a colon separated list of MIB modules to load for this
 
88
application.  This overrides the environment variable MIBS.
 
89
See \fIsnmpcmd(1)\fR for details.
 
90
.TP
 
91
.BR -M " \fIDIRLIST"
 
92
Specifies a colon separated list of directories to search for MIBs.
 
93
This overrides the environment variable MIBDIRS.
 
94
See \fIsnmpcmd(1)\fR for details.
 
95
.TP
 
96
.B -n \fINAME
 
97
Set an alternative application name (which will affect the
 
98
configuration files loaded).
 
99
By default this will be \fIsnmpd\fR, regardless of the name
 
100
of the actual binary.
103
101
.TP
104
102
.B -p \fIFILE
105
103
Save the process ID of the daemon in
106
104
.IR FILE "."
107
 
.br
108
 
This option deprecates the
109
 
.B -P
110
 
option.
111
 
.TP
112
 
.B -P \fIFILE
113
 
Save the process ID of the daemon in
114
 
.IR FILE "."
115
 
This option is being deprecated, and '-p FILE' should be used instead.
116
105
.TP 
117
106
.B -q
118
107
Print simpler output for easier automated parsing.
122
111
if files only accessible to root (such as /dev/kmem etc.) cannot be
123
112
opened.
124
113
.TP
125
 
.B -s
126
 
Use syslog for logging.
127
 
.br
128
 
This option is being deprecated, and '-Ls FACILITY' should be used instead.
129
 
.TP
130
 
.BR -S " d|0-7"
131
 
Specifies the syslog facility to use when logging to syslog.
132
 
.br
133
 
This option is being deprecated, and '-Ls FACILITY' should be used instead.
134
 
.TP
135
114
.B -u \fIUID
136
115
Change to the user ID
137
116
.I UID
170
149
file. See
171
150
.I snmpd.conf(5)
172
151
for the full list of tokens.
173
 
 
174
 
 
175
152
.SH LISTENING ADDRESSES
176
153
By default,
177
154
.B snmpd
178
 
listens for incoming SNMP requests only on UDP port 161.  However, it
179
 
is possible to modify this behaviour by specifying one or more
180
 
listening addresses as arguments to
181
 
.BR snmpd .
 
155
listens for incoming SNMP requests on UDP port 161 on all IPv4 interfaces.
 
156
However, it is possible to modify this behaviour by specifying one or more
 
157
listening addresses as arguments to \fBsnmpd\fR.
182
158
A listening address takes the form:
183
159
.IP
184
160
[<transport-specifier>:]<transport-address>
193
169
.TP 28
194
170
.BR "<transport-specifier>"
195
171
.BR "<transport-address> format"
196
 
.IP "udp" 28
 
172
.IP "udp \fI(default)\fR" 28
197
173
hostname[:port]
198
174
.I or
199
175
IPv4-address[:port]
228
204
listen on UDP port 161, but only on the loopback interface.  This
229
205
prevents
230
206
.B snmpd
231
 
being queried remotely (which is a bit pointless).  The ":161" is
232
 
redundant here since that is the default SNMP port in any case.
 
207
being queried remotely.  The  port specification ":161" is
 
208
not strictly necessary since that is the default SNMP port.
233
209
.TP 24
234
210
.IR "TCP:1161"
235
211
listen on TCP port 1161 on all IPv4 interfaces.
238
214
listen on IPX port 40000 on all IPX interfaces.
239
215
.TP 24
240
216
.IR "unix:/tmp/local-agent"
241
 
listen on the Unix domain socket 
242
 
.IR /tmp/local-agent .
 
217
listen on the Unix domain socket \fI/tmp/local-agent\fR.
243
218
.TP 24
244
219
.IR "/tmp/local-agent"
245
 
identical to the previous specification, since the Unix domain is the
246
 
default transport iff the first character of the <transport-address>
247
 
is a '/'.
 
220
is identical to the previous specification, since the Unix domain is
 
221
assumed if the first character of the <transport-address> is '/'.
248
222
.TP 24
249
223
.IR "PVC:161"
250
224
listen on the AAL5 permanent virtual circuit with VPI=0 and VCI=161
259
233
the error "Error opening specified endpoint".  Likewise, since AAL5
260
234
PVC support is only currently available on Linux, it will fail with
261
235
the same error on other platforms.
262
 
 
263
 
.RE
264
236
.SH CONFIGURATION FILES
265
237
.PP
266
238
.B snmpd