| bsnmpd.1 (133211) | bsnmpd.1 (142810) |
|---|---|
| 1.\" 2.\" Copyright (c) 2001-2003 3.\" Fraunhofer Institute for Open Communication Systems (FhG Fokus). 4.\" All rights reserved. 5.\" 6.\" Author: Harti Brandt <harti@freebsd.org> 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 12 unchanged lines hidden (view full) --- 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" | 1.\" 2.\" Copyright (c) 2001-2003 3.\" Fraunhofer Institute for Open Communication Systems (FhG Fokus). 4.\" All rights reserved. 5.\" 6.\" Author: Harti Brandt <harti@freebsd.org> 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 12 unchanged lines hidden (view full) --- 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" |
| 29.\" $Begemot: bsnmp/snmpd/bsnmpd.1,v 1.4 2004/08/06 08:47:10 brandt Exp $ | 29.\" $Begemot: bsnmp/snmpd/bsnmpd.1,v 1.6 2005/02/25 11:56:01 brandt_h Exp $ |
| 30.\" 31.Dd August 15, 2002 32.Dt SNMPD 1 33.Os 34.Sh NAME 35.Nm snmpd 36.Nd "simple and extendable SNMP daemon" 37.Sh SYNOPSIS --- 4 unchanged lines hidden (view full) --- 42.Op Fl I Ar paths 43.Op Fl l Ar prefix 44.Op Fl m Ar variable Ns Op = Ns Ar value 45.Op Fl p Ar file 46.Sh DESCRIPTION 47The 48.Nm 49daemon servers the internet SNMP (Simple Network Managment Protocol). | 30.\" 31.Dd August 15, 2002 32.Dt SNMPD 1 33.Os 34.Sh NAME 35.Nm snmpd 36.Nd "simple and extendable SNMP daemon" 37.Sh SYNOPSIS --- 4 unchanged lines hidden (view full) --- 42.Op Fl I Ar paths 43.Op Fl l Ar prefix 44.Op Fl m Ar variable Ns Op = Ns Ar value 45.Op Fl p Ar file 46.Sh DESCRIPTION 47The 48.Nm 49daemon servers the internet SNMP (Simple Network Managment Protocol). |
| 50It is intended to server only the absolute basic MIBs and implement all other | 50It is intended to serve only the absolute basic MIBs and implement all other |
| 51MIBs through loadable modules. In this way the 52.Nm 53can be used in unexpected ways. 54.Pp 55The options are as follows: 56.Bl -tag -width ".It Fl D Ar options" 57.It Fl d 58This option is used for debugging --- 20 unchanged lines hidden (view full) --- 79.It Cm trace Ns Cm = Ns Cm level 80This option causes the snmp library trace flag to be set to the specified 81value. The value can be specified in the usual C-syntax for numbers. 82.El 83.It Fl I Ar paths 84This option specifies a colon separated list of directories to search for 85configuration include files. The default is 86.Pa /etc:/usr/etc/:/usr/local/etc . | 51MIBs through loadable modules. In this way the 52.Nm 53can be used in unexpected ways. 54.Pp 55The options are as follows: 56.Bl -tag -width ".It Fl D Ar options" 57.It Fl d 58This option is used for debugging --- 20 unchanged lines hidden (view full) --- 79.It Cm trace Ns Cm = Ns Cm level 80This option causes the snmp library trace flag to be set to the specified 81value. The value can be specified in the usual C-syntax for numbers. 82.El 83.It Fl I Ar paths 84This option specifies a colon separated list of directories to search for 85configuration include files. The default is 86.Pa /etc:/usr/etc/:/usr/local/etc . |
| 87These paths are only searched for include specified within <> parantheses. | 87These paths are only searched for include specified within <> parentheses. |
| 88.It Fl l Ar prefix 89The 90.Ar prefix 91is used as the default basename for the pid and the configuration files. 92.It Fl m Ar variable Ns Op = Ns Ar value 93Define a configuration variable. 94.It Fl p Ar file 95Specify an alternate pid file instead of the default one. --- 11 unchanged lines hidden (view full) --- 107section separators 108.It 109include directives 110.It 111MIB variable assignments 112.El 113.Pp 114If a line is too long it can be continued on the next line by ending it with | 88.It Fl l Ar prefix 89The 90.Ar prefix 91is used as the default basename for the pid and the configuration files. 92.It Fl m Ar variable Ns Op = Ns Ar value 93Define a configuration variable. 94.It Fl p Ar file 95Specify an alternate pid file instead of the default one. --- 11 unchanged lines hidden (view full) --- 107section separators 108.It 109include directives 110.It 111MIB variable assignments 112.El 113.Pp 114If a line is too long it can be continued on the next line by ending it with |
| 115a backslash. Empty lines and lines who's first non-blank character is a | 115a backslash. Empty lines and lines in which the first non-blank character is a |
| 116.Dq # 117sign are ignored. 118.Pp 119All MIB variable assignments of the entire configuration (including nested 120configuration files) are handled as one transaction, i.e. as if they arrived 121in a single SET PDU. Any failure during the initial configuration read causes 122.Nm 123to exit. A failure during the configuration read caused by a module load 124causes the loading of the module to fail. 125.Pp | 116.Dq # 117sign are ignored. 118.Pp 119All MIB variable assignments of the entire configuration (including nested 120configuration files) are handled as one transaction, i.e. as if they arrived 121in a single SET PDU. Any failure during the initial configuration read causes 122.Nm 123to exit. A failure during the configuration read caused by a module load 124causes the loading of the module to fail. 125.Pp |
| 126The configuration is red during initialisation of | 126The configuration is read during initialisation of |
| 127.Nm , 128when a module is loaded and when 129.Nm 130receives a SIGHUP. 131.Ss VARIABLE ASSIGNMENTS 132Variable assignments can take one of two forms: 133.Bd -unfilled -offset indent 134variable := string --- 37 unchanged lines hidden (view full) --- 172include directive that takes one of two forms: 173.Bd -unfilled -offset indent 174\&.include "file" 175\&.include <"file"> 176.Ed 177.Pp 178The first form causes the file to be searched in the current directory, the 179second form causes the file to be searched in the directories specified in | 127.Nm , 128when a module is loaded and when 129.Nm 130receives a SIGHUP. 131.Ss VARIABLE ASSIGNMENTS 132Variable assignments can take one of two forms: 133.Bd -unfilled -offset indent 134variable := string --- 37 unchanged lines hidden (view full) --- 172include directive that takes one of two forms: 173.Bd -unfilled -offset indent 174\&.include "file" 175\&.include <"file"> 176.Ed 177.Pp 178The first form causes the file to be searched in the current directory, the 179second form causes the file to be searched in the directories specified in |
| 180the system include path. Nesting depths is only restricted by available | 180the system include path. Nesting depth is only restricted by available |
| 181memory. 182.Ss MIB VARIABLE ASSIGNMENTS 183A MIB variable is assigned with the syntax 184.Bd -unfilled -offset indent 185oid [ suboids ] = value 186.Ed 187.Pp 188.Va oid 189is the name of the variable to be set. Only the last component of the entire 190name is used here. If the variable is a scalar, the index (.0) is automatically 191appended and need not to be specified. If the variable is a table column, | 181memory. 182.Ss MIB VARIABLE ASSIGNMENTS 183A MIB variable is assigned with the syntax 184.Bd -unfilled -offset indent 185oid [ suboids ] = value 186.Ed 187.Pp 188.Va oid 189is the name of the variable to be set. Only the last component of the entire 190name is used here. If the variable is a scalar, the index (.0) is automatically 191appended and need not to be specified. If the variable is a table column, |
| 192the index ( 193.Va suboids ) | 192the index 193.Pq Va suboids |
| 194must be specified. The index consist of elements each seperated from the | 194must be specified. The index consist of elements each seperated from the |
| 195previous one by a dot. Elements may be either numbers, strings or hostnames | 195previous one by a dot. Elements may be either numbers, strings or hostnames |
| 196enclosed in [] brackets. If the element is a number it is appended 197to the current oid. If the element is a string, its length and the 198.Tn ASCII 199code of each of its characters are appended to the current oid. If the 200element is a hostname, the IP address of the host is looked up and the four 201elements of the IP address are appended to the oid. 202.Pp 203For example a oid of --- 49 unchanged lines hidden --- | 196enclosed in [] brackets. If the element is a number it is appended 197to the current oid. If the element is a string, its length and the 198.Tn ASCII 199code of each of its characters are appended to the current oid. If the 200element is a hostname, the IP address of the host is looked up and the four 201elements of the IP address are appended to the oid. 202.Pp 203For example a oid of --- 49 unchanged lines hidden --- |