nicinfo

Display information about a network interface controller

---

If you aren't root, specify the full path: /usr/sbin/nicinfo.

---

Syntax:

nicinfo [-c|g|s] [-rv] [interface|device...]

Runs on:

Neutrino

Options:

-c

Display information about the configuration only.

-g

Display general statistics only.

-r

The specified devices are relative to /dev/io-net/. This option is for compatibility with older io-net drivers.

-s

Display statistics only.

-v

Be verbose.

device

The device (e.g. /dev/io-net/en0) to display information about. This is for compatibility with older io-net drivers; native io-pkt drivers don't create entries in /dev.

interface

The network interface (e.g. fxp0) to display information about. If you don't specify an interface, nicinfo displays information about all interfaces.

---

You should specify at most one of the -c, -g, and -s options.

---

Description:

This utility displays information about the given network interface connection, or all interfaces if you don't specify one. The information includes the number of packets transmitted and received, collisions, and other errors.

---

The output from nicinfo depends on what the driver supports; not all fields are included for all drivers. However, the output always includes information about the bytes and packets that were transmitted and received. NetBSD drivers don't support nicinfo.

---

Examples:

# nicinfo en0

SMC9432 EPIC Ethernet Controller

  Physical Node ID ........................... 00E029 3820EE
  Current Physical Node ID ................... 00E029 3820EE
  Current Operation Rate ..................... 100.00 Mb/s half-duplex
  Active Interface Type ...................... MII
    Active PHY address ....................... 3
  Maximum Transmittable data Unit ............ 1514
  Maximum Receivable data Unit ............... 1514
  Hardware Interrupt ......................... 0x9
  I/O Aperture ............................... 0xb000 - 0xb0ff
  Memory Aperture ............................ 0xf1800000 - 0xf1800fff
  Promiscuous Mode ........................... Off
  Multicast Support .......................... Enabled

  Packets Transmitted OK ..................... 1096267
  Bytes Transmitted OK ....................... 1096353794
  Memory Allocation Failures on Transmit ..... 0

  Packets Received OK ........................ 1132010
  Bytes Received OK .......................... 1201171760
  Memory Allocation Failures on Receive ...... 0

  Single Collisions on Transmit .............. 744536
  Deferred Transmits ......................... 262485
  Late Collision on Transmit errors .......... 0
  Transmits aborted (excessive collisions) ... 0
  Transmit Underruns ......................... 0
  No Carrier on Transmit ..................... 0
  Receive Alignment errors ................... 0
  Received packets with CRC errors ........... 0
  Packets Dropped on receive ................. 0

Get statistics on legacy io-net drivers running with the shim:

# nicinfo -r en0

Another way to do the same thing:

# nicinfo /dev/io-net/en0

Get statistics on a particular native driver:

# nicinfo wm0

Exit status:

0

Successful completion.

1

An error occurred.

See also:

devn-*, devnp-*,

Connecting Hardware in the Neutrino User's Guide