xref: /openbsd/usr.sbin/snmpd/snmpd.8 (revision 3cab2bb3)
1.\" $OpenBSD: snmpd.8,v 1.23 2020/07/01 13:00:51 martijn 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 1 2020 $
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.Sh DESCRIPTION
29.Nm
30is a daemon which implements the SNMP protocol.
31.Pp
32The options are as follows:
33.Bl -tag -width Ds
34.It Fl D Ar macro Ns = Ns Ar value
35Define
36.Ar macro
37to be set to
38.Ar value
39on the command line.
40Overrides the definition of
41.Ar macro
42in the configuration file.
43.It Fl d
44Do not daemonize and log to
45.Em stderr .
46.It Fl f Ar file
47Use
48.Ar file
49as the configuration file, instead of the default
50.Pa /etc/snmpd.conf .
51.It Fl N
52Show numeric OID values instead of their symbolic names.
53.It Fl n
54Configtest mode.
55Only check the configuration file for validity.
56.It Fl v
57Produce more verbose output.
58.El
59.Sh FILES
60.Bl -tag -width "/usr/share/snmp/mibs/XXXX" -compact
61.It Pa /etc/snmpd.conf
62default
63.Nm
64configuration file
65.It Pa /usr/share/snmp/mibs/*
66.Nm
67Management Information Base definitions
68.El
69.Sh SEE ALSO
70.Xr snmp 1 ,
71.Xr snmpd.conf 5
72.Sh STANDARDS
73.Rs
74.%A U. Blumenthal
75.%A B. Wijnen
76.%D December 2002
77.%R RFC 3414
78.%T User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)
79.Re
80.Pp
81.Rs
82.%A R. Presuhn
83.%D December 2002
84.%R RFC 3416
85.%T Version 2 of the Protocol Operations for the Simple Network Management Protocol (SNMP)
86.Re
87.Pp
88.Rs
89.%A R. Presuhn
90.%D December 2002
91.%R RFC 3417
92.%T Transport Mappings for the Simple Network Management Protocol (SNMP)
93.Re
94.Pp
95.Rs
96.%A R. Presuhn
97.%D December 2002
98.%R RFC 3418
99.%T Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)
100.Re
101.Pp
102.Rs
103.%A U. Blumenthal
104.%D June 2004
105.%R RFC 3826
106.%T The Advanced Encryption Standard (AES) Cipher Algorithm in the SNMP User-based Security Model
107.Re
108.Sh HISTORY
109The
110.Nm
111program first appeared in
112.Ox 4.3 .
113.Sh AUTHORS
114The
115.Nm
116program was written by
117.An Reyk Floeter Aq Mt reyk@openbsd.org .
118