xref: /openbsd/usr.sbin/snmpd/snmpd.8 (revision 44e68d47)
1.\" $OpenBSD: snmpd.8,v 1.18 2013/07/16 11:13:34 schwarze 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: July 16 2013 $
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.Sh STANDARDS
85.Rs
86.%A U. Blumenthal
87.%A B. Wijnen
88.%D December 2002
89.%R RFC 3414
90.%T User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)
91.Re
92.Pp
93.Rs
94.%A R. Presuhn
95.%D December 2002
96.%R RFC 3416
97.%T Version 2 of the Protocol Operations for the Simple Network Management Protocol (SNMP)
98.Re
99.Pp
100.Rs
101.%A R. Presuhn
102.%D December 2002
103.%R RFC 3417
104.%T Transport Mappings for the Simple Network Management Protocol (SNMP)
105.Re
106.Pp
107.Rs
108.%A R. Presuhn
109.%D December 2002
110.%R RFC 3418
111.%T Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)
112.Re
113.Pp
114.Rs
115.%A U. Blumenthal
116.%D June 2004
117.%R RFC 3826
118.%T The Advanced Encryption Standard (AES) Cipher Algorithm in the SNMP User-based Security Model
119.Re
120.Sh HISTORY
121The
122.Nm
123program first appeared in
124.Ox 4.3 .
125.Sh AUTHORS
126The
127.Nm
128program was written by
129.An Reyk Floeter Aq Mt reyk@openbsd.org .
130.Sh CAVEATS
131.Nm
132does not fully work yet.
133