19 stable releases

new 1.2.24 Mar 18, 2025
1.2.22 Dec 30, 2024
1.2.21 Sep 25, 2024
1.2.19 May 22, 2024
1.2.5 Mar 30, 2022

#898 in Network programming

Download history 4/week @ 2024-12-04 6/week @ 2024-12-11 97/week @ 2024-12-25 23/week @ 2025-01-01 7/week @ 2025-01-08 63/week @ 2025-02-12

63 downloads per month

Apache-2.0

350KB
10K SLoC

The nispor(Network Inspector) project is designed to providing unified interface for Linux network state querying.

Currently providing:

  • Rust crate
  • Python binding
  • C binding
  • Command line tool -- npc

Install

make
sudo PREFIX=/usr make install

Usage

Print all network status

npc

Print network status of certain NIC

npc bond99

Print route entries

npc route

Supported features

  • IPv4/IPv6 address
  • Bond
  • Linux Bridge
  • Linux Bridge VLAN filtering
  • VLAN
  • VxLAN
  • Route
  • Dummy
  • TUN/TAP
  • Veth
  • VRF(Virtual Routing and Forwarding)
  • SR-IOV
  • MacVlan
  • MacVtap

TODO:

  • Error handling instead of unwrap()/panic!/etc
  • SR-IOV VF-PF relation is possible
  • VLAN QoS
  • Route rule
  • Traffic control
  • Manpage for npc/npd
  • pkgconfig file for nispor C library

What should nispor not do

To make nispor only to small good things, this is the list of things could be done by nispor but should not do:

  • Ordering the network interface configuration base on child/parent, controller/port relationships.
  • Wrapping of multiple kernel options into simple ones.
  • User space networking.
  • Notification on network change.

Dependencies

~10–17MB
~237K SLoC