xref: /openbsd/usr.sbin/snmpd/snmpd.8 (revision 21349241)
1.\" $OpenBSD: snmpd.8,v 1.16 2012/09/18 10:40:20 reyk Exp $
2.\"
3.\" Copyright (c) 2007, 2008 Reyk Floeter <reyk@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: September 18 2012 $
18.Dt SNMPD 8
19.Os
20.Sh NAME
21.Nm snmpd
22.Nd Simple Network Management Protocol daemon
23.Sh SYNOPSIS
24.Nm snmpd
25.Op Fl dNnv
26.Op Fl D Ar macro Ns = Ns Ar value
27.Op Fl f Ar file
28.Op Fl r Ar path
29.Sh DESCRIPTION
30.Nm
31is a daemon which implements the SNMP protocol.
32.Pp
33The options are as follows:
34.Bl -tag -width Ds
35.It Fl D Ar macro Ns = Ns Ar value
36Define
37.Ar macro
38to be set to
39.Ar value
40on the command line.
41Overrides the definition of
42.Ar macro
43in the configuration file.
44.It Fl d
45Do not daemonize and log to
46.Em stderr .
47.It Fl f Ar file
48Use
49.Ar file
50as the configuration file, instead of the default
51.Pa /etc/snmpd.conf .
52.It Fl N
53Show numeric OID values instead of their symbolic names.
54.It Fl n
55Configtest mode.
56Only check the configuration file for validity.
57.It Fl r Ar path
58Open a second, restricted, control socket that
59.Xr snmpctl 8
60can use.
61Only
62.Em trap
63requests are allowed on this socket.
64.It Fl v
65Produce more verbose output.
66.El
67.Sh FILES
68.Bl -tag -width "/usr/share/snmp/mibs/XXXX" -compact
69.It Pa /etc/snmpd.conf
70default
71.Nm
72configuration file
73.It Pa /var/run/snmpd.sock
74default
75.Nm
76control socket
77.It Pa /usr/share/snmp/mibs/*
78.Nm
79Management Information Base definitions
80.El
81.Sh SEE ALSO
82.Xr snmpd.conf 5 ,
83.Xr snmpctl 8
84.Rs
85.%A R. Presuhn
86.%R STD 62
87.%R RFC 3418
88.%T Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)
89.%D December 2002
90.Re
91.Rs
92.%A R. Presuhn
93.%R STD 62
94.%R RFC 3417
95.%T Transport Mappings for the Simple Network Management Protocol (SNMP)
96.%D December 2002
97.Re
98.Rs
99.%A R. Presuhn
100.%R STD 62
101.%R RFC 3416
102.%T Version 2 of the Protocol Operations for the Simple Network Management Protocol (SNMP)
103.%D December 2002
104.Re
105.Rs
106.%A U. Blumenthal
107.%A B. Wijnen
108.%R STD 62
109.%R RFC 3414
110.%T User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)
111.%D December 2002
112.Re
113.Rs
114.%A U. Blumenthal
115.%R RFC 3826
116.%T The Advanced Encryption Standard (AES) Cipher Algorithm in the SNMP User-based Security Model
117.%D June 2004
118.Re
119.Sh HISTORY
120The
121.Nm
122program first appeared in
123.Ox 4.3 .
124.Sh AUTHORS
125The
126.Nm
127program was written by
128.An Reyk Floeter Aq reyk@openbsd.org .
129.Sh CAVEATS
130.Nm
131does not fully work yet.
132