| ifmib.4 (102610) | ifmib.4 (117011) |
|---|---|
| 1.\" Copyright 1996 Massachusetts Institute of Technology 2.\" 3.\" Permission to use, copy, modify, and distribute this software and 4.\" its documentation for any purpose and without fee is hereby 5.\" granted, provided that both the above copyright notice and this 6.\" permission notice appear in all copies, that both the above 7.\" copyright notice and this permission notice appear in all 8.\" supporting documentation, and that the name of M.I.T. not be used --- 11 unchanged lines hidden (view full) --- 20.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 21.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 22.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 23.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 25.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" | 1.\" Copyright 1996 Massachusetts Institute of Technology 2.\" 3.\" Permission to use, copy, modify, and distribute this software and 4.\" its documentation for any purpose and without fee is hereby 5.\" granted, provided that both the above copyright notice and this 6.\" permission notice appear in all copies, that both the above 7.\" copyright notice and this permission notice appear in all 8.\" supporting documentation, and that the name of M.I.T. not be used --- 11 unchanged lines hidden (view full) --- 20.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 21.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 22.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 23.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 25.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" |
| 28.\" $FreeBSD: head/share/man/man4/ifmib.4 102610 2002-08-30 10:52:17Z johan $ | 28.\" $FreeBSD: head/share/man/man4/ifmib.4 117011 2003-06-28 23:53:39Z ru $ |
| 29.\" 30.Dd November 15, 1996 31.Dt IFMIB 4 32.Os 33.Sh NAME 34.Nm ifmib 35.Nd Management Information Base for network interfaces 36.Sh SYNOPSIS --- 9 unchanged lines hidden (view full) --- 46facility is an application of the 47.Xr sysctl 3 48interface to provide management information about network interfaces 49to client applications such as 50.Xr netstat 1 , 51.Xr slstat 8 , 52and 53.Tn SNMP | 29.\" 30.Dd November 15, 1996 31.Dt IFMIB 4 32.Os 33.Sh NAME 34.Nm ifmib 35.Nd Management Information Base for network interfaces 36.Sh SYNOPSIS --- 9 unchanged lines hidden (view full) --- 46facility is an application of the 47.Xr sysctl 3 48interface to provide management information about network interfaces 49to client applications such as 50.Xr netstat 1 , 51.Xr slstat 8 , 52and 53.Tn SNMP |
| 54management agents. This information is structured as a table, where | 54management agents. 55This information is structured as a table, where |
| 55each row in the table represents a logical network interface (either a 56hardware device or a software pseudo-device like 57.Xr lo 4 ) . 58There are two columns in the table, each containing a single 59structure: one column contains generic information relevant to all 60interfaces, and the other contains information specific to the | 56each row in the table represents a logical network interface (either a 57hardware device or a software pseudo-device like 58.Xr lo 4 ) . 59There are two columns in the table, each containing a single 60structure: one column contains generic information relevant to all 61interfaces, and the other contains information specific to the |
| 61particular class of interface. (Generally the latter will implement | 62particular class of interface. 63(Generally the latter will implement |
| 62the 63.Tn SNMP 64.Tn MIB 65defined for that particular interface class, if one exists and can be 66implemented in the kernel.) 67.Pp 68The 69.Nm 70facility is accessed via the 71.Dq Li net.link.generic 72branch of the 73.Xr sysctl 3 | 64the 65.Tn SNMP 66.Tn MIB 67defined for that particular interface class, if one exists and can be 68implemented in the kernel.) 69.Pp 70The 71.Nm 72facility is accessed via the 73.Dq Li net.link.generic 74branch of the 75.Xr sysctl 3 |
| 74MIB. The manifest constants for each level in the | 76MIB. 77The manifest constants for each level in the |
| 75.Xr sysctl 3 76.Ar name 77are defined in 78.Aq Pa net/if_mib.h . 79The index of the last row in the table is given by 80.Dq Li net.link.generic.system.ifcount 81(or, using the manifest constants, 82.Dv CTL_NET , --- 59 unchanged lines hidden (view full) --- 142more information from a structure defined in 143.Aq Pa net/if.h 144(see 145.Xr if_data 9 ) 146.El 147.Pp 148Class-specific information can be retrieved by examining the 149.Dv IFDATA_LINKSPECIFIC | 78.Xr sysctl 3 79.Ar name 80are defined in 81.Aq Pa net/if_mib.h . 82The index of the last row in the table is given by 83.Dq Li net.link.generic.system.ifcount 84(or, using the manifest constants, 85.Dv CTL_NET , --- 59 unchanged lines hidden (view full) --- 145more information from a structure defined in 146.Aq Pa net/if.h 147(see 148.Xr if_data 9 ) 149.El 150.Pp 151Class-specific information can be retrieved by examining the 152.Dv IFDATA_LINKSPECIFIC |
| 150column instead. Note that the form and length of the structure will 151depend on the class of interface. For | 153column instead. 154Note that the form and length of the structure will 155depend on the class of interface. 156For |
| 152.Dv IFT_ETHER , 153.Dv IFT_ISO88023 , 154and 155.Dv IFT_STARLAN 156interfaces, the structure is called 157.Dq Li struct ifmib_iso_8802_3 158(defined in 159.Aq Pa net/if_mib.h ) , --- 32 unchanged lines hidden --- | 157.Dv IFT_ETHER , 158.Dv IFT_ISO88023 , 159and 160.Dv IFT_STARLAN 161interfaces, the structure is called 162.Dq Li struct ifmib_iso_8802_3 163(defined in 164.Aq Pa net/if_mib.h ) , --- 32 unchanged lines hidden --- |