https://github.com/thepacketgeek/rust-network-tools

https://github.com/thepacketgeek/rust-network-tools

Last synced: about 10 hours ago
JSON representation

• Host: GitHub
• URL: https://github.com/thepacketgeek/rust-network-tools
• Owner: thepacketgeek
• Created: 2020-08-22T23:46:44.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-08-11T23:23:38.000Z (about 2 years ago)
• Last Synced: 2023-08-04T12:29:31.941Z (about 1 year ago)
• Language: Rust
• Size: 62.5 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Rust Network Tools

A small collection of example network tools based off of similar examples with [Scapy](https://scapy.net/) from this blog series: [Building Network Tools with Scapy](https://thepacketgeek.com/scapy/)

# Library Tools

- `ArpMonitor`

  - View sniffed ARP Requests & Replies on a network interface

- `ArpRequest`

  - Send an ARP request for a given IP and print out the replied MAC address

- `ArpCache`

  - Ipv4 ARP cache with ARP request capabilities

- `NdpMonitor`

  - View sniffed NDP Solicitations & Acknowledgements on a network interface

- `NdpRequest`

  - Send an NDP solicitation for a given IP and print out the replied MAC address

- `NdpCache`

  - Ipv6 NDP cache with NDP request capabilities

- `Routes`

  - Ipv4/v6 Route Table with destination lookup (parsed from netstat)

# Running the CLI

```sh

cargo run -- --help

network-tools 0.1.0

USAGE:

    network-tools [OPTIONS] 

FLAGS:

    -h, --help       Prints help information

    -V, --version    Prints version information

OPTIONS:

    -i, --interface     Interface name to bind to

SUBCOMMANDS:

    help           Prints this message or the help of the given subcommand(s)

    interfaces     List available Interfaces

    monitor-arp    Monitor for ARP Request/Replies

    monitor-ndp    Monitor for IPv6 NDP (Neighbor/Router Solicitations & Advertisements)

    request-arp    Send an ARP request for a given IPv4 Address

    request-ndp    Send an NDP request for a given IPv6 Address

    route          List available Routes (or route for given destination host)

```

## Permissions

In order to create a `Channel` for Tx/Rx on an interface, you'll need sudo permissions:

```rust

cargo build

sudo ./target/debug/build monitor-arp -i eth0

```