24 stable releases

1.2.24 Mar 18, 2025
1.2.22 Dec 30, 2024
1.2.21 Sep 25, 2024
1.2.19 May 22, 2024
0.1.0 Jul 3, 2020

#106 in Network programming

Download history 1379/week @ 2025-01-06 1309/week @ 2025-01-13 1455/week @ 2025-01-20 1098/week @ 2025-01-27 1515/week @ 2025-02-03 1992/week @ 2025-02-10 1717/week @ 2025-02-17 1591/week @ 2025-02-24 2094/week @ 2025-03-03 2105/week @ 2025-03-10 2981/week @ 2025-03-17 2686/week @ 2025-03-24 2847/week @ 2025-03-31 2664/week @ 2025-04-07 2015/week @ 2025-04-14 1798/week @ 2025-04-21

9,572 downloads per month
Used in 8 crates (7 directly)

Apache-2.0

320KB
9K 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

~7–14MB
~186K SLoC