Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fdncred/nu_plugin_pnet
A nushell plugin to list system network interfaces
https://github.com/fdncred/nu_plugin_pnet
Last synced: about 1 month ago
JSON representation
A nushell plugin to list system network interfaces
- Host: GitHub
- URL: https://github.com/fdncred/nu_plugin_pnet
- Owner: fdncred
- Created: 2022-12-07T15:31:35.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-22T12:58:08.000Z (3 months ago)
- Last Synced: 2024-08-22T14:31:38.527Z (3 months ago)
- Language: Rust
- Size: 187 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-nu - nu_plugin_pnet - in. (Plugins)
README
# nu_plugin_pnet
This is taken from https://github.com/fennewald/nu_plugin_net and modernized a tiny bit. Thanks! Be sure to read the changelog for tips for Windows users.
A nushell plugin to list system network interfaces
A simple and straightforward plugin. All of the heavy lifting is done by pnet. This package just translates the datatypes into a nu-accepatble format.
Format may be subject to change.
# Examples
```
~> net
╭───┬──────────┬─────────────┬───────────────────┬────────────────┬───────────────────╮
│ # │ name │ description │ mac │ ips │ flags │
├───┼──────────┼─────────────┼───────────────────┼────────────────┼───────────────────┤
│ 1 │ lo │ │ 00:00:00:00:00:00 │ [table 2 rows] │ {record 5 fields} │
│ 2 │ enp2s0f0 │ │ 8c:8c:aa:1f:a5:2a │ [table 2 rows] │ {record 5 fields} │
│ 3 │ wlp3s0 │ │ c8:e2:65:c3:09:42 │ [table 2 rows] │ {record 5 fields} │
╰───┴──────────┴─────────────┴───────────────────┴────────────────┴───────────────────╯
```
```
~> net | flatten flags
╭───┬──────────┬─────────────┬───────────────────┬────────────────┬───────┬──────────────┬─────────────┬───────────────────┬──────────────╮
│ # │ name │ description │ mac │ ips │ is_up │ is_broadcast │ is_loopback │ is_point_to_point │ is_multicast │
├───┼──────────┼─────────────┼───────────────────┼────────────────┼───────┼──────────────┼─────────────┼───────────────────┼──────────────┤
│ 1 │ lo │ │ 00:00:00:00:00:00 │ [table 2 rows] │ true │ false │ true │ false │ false │
│ 2 │ enp2s0f0 │ │ 8c:8c:aa:1f:a5:2a │ [table 2 rows] │ true │ true │ false │ false │ true │
│ 3 │ wlp3s0 │ │ c8:e2:65:c3:09:42 │ [table 2 rows] │ true │ true │ false │ false │ true │
╰───┴──────────┴─────────────┴───────────────────┴────────────────┴───────┴──────────────┴─────────────┴───────────────────┴──────────────╯
```
```
~> net | select ips | flatten | flatten
╭───┬──────┬──────────────────────────────┬────────╮
│ # │ type │ addr │ prefix │
├───┼──────┼──────────────────────────────┼────────┤
│ 0 │ v4 │ 127.0.0.1/8 │ 8 │
│ 1 │ v6 │ ::1/128 │ 128 │
│ 2 │ v4 │ 192.168.1.232/24 │ 24 │
│ 3 │ v6 │ fe80::8e8c:aaff:fe1f:a52a/64 │ 64 │
│ 4 │ v4 │ 192.168.4.189/24 │ 24 │
│ 5 │ v6 │ fe80::cae2:65ff:fec3:942/64 │ 64 │
╰───┴──────┴──────────────────────────────┴────────╯
```
# Installing
This plugin uses the `msgpack` encoding. To register:
```
register
```
# Changelog
Version 1.1.0
Use `if_index` instead of `index`, fixing the way table indexes are displayed
Version 1.2.0
Renamed from `net` to `pnet` as to not cause a conflict on Windows.
The biggest mistake I made was not realizing that:
1. You have to download Packet.lib from Winpcap Developers Pack from https://www.winpcap.org/devel.htm, making sure to use the x64 version vs the x86 version. You have to put Packet.lib in the root of the nu_plugin_pnet folder for linking.
2. You have to install npcap installer from https://npcap.com/#download
Otherwise you get these errors when trying to register
```
register c:\CarTar\debug\nu_plugin_pnet.exe
× Error getting signatures
╭─[entry #1:1:1]
1 │ register c:\CarTar\debug\nu_plugin_pnet.exe
· ────┬───
· ╰── Plugin failed to load: unable to get encoding from plugin: failed to fill whole buffer
╰────
```