19 stable releases

1.2.18 Mar 19, 2024
1.2.16 Dec 22, 2023
1.2.14 Sep 18, 2023
1.2.12 Jul 10, 2023
0.1.0 Jul 3, 2020

#501 in Operating systems

Download history 599/week @ 2023-12-21 922/week @ 2023-12-28 1785/week @ 2024-01-04 1392/week @ 2024-01-11 1189/week @ 2024-01-18 1547/week @ 2024-01-25 1094/week @ 2024-02-01 830/week @ 2024-02-08 1304/week @ 2024-02-15 1024/week @ 2024-02-22 1147/week @ 2024-02-29 1199/week @ 2024-03-07 1703/week @ 2024-03-14 2208/week @ 2024-03-21 1344/week @ 2024-03-28 1005/week @ 2024-04-04

6,579 downloads per month
Used in 7 crates

Apache-2.0

305KB
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

~9MB
~172K SLoC