Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jacknewman12/nethex

A small rust utility for dumping and sending data-layer network traffic
https://github.com/jacknewman12/nethex

data-layer datalayer hex network networking networkingtool rust rust-lang

Last synced: 1 day ago
JSON representation

A small rust utility for dumping and sending data-layer network traffic

Host: GitHub
URL: https://github.com/jacknewman12/nethex
Owner: JackNewman12
License: mit
Created: 2019-06-15T03:04:56.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2023-03-01T09:57:14.000Z (over 1 year ago)
Last Synced: 2023-03-06T03:29:16.141Z (over 1 year ago)
Topics: data-layer, datalayer, hex, network, networking, networkingtool, rust, rust-lang
Language: Rust
Homepage:
Size: 55.7 KB
Stars: 2
Watchers: 0
Forks: 1
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # NetHex

A small rust utility for dumping data-layer network traffic

[![Rust](https://github.com/JackNewman12/NetHex/actions/workflows/rust.yml/badge.svg)](https://github.com/JackNewman12/NetHex/actions/workflows/rust.yml)

![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)

```

./nethex --help

NetHex 0.8.0

A small utility for reading / writing directly to a network interface

USAGE:

    nethex [FLAGS] [OPTIONS] [ARGS]

FLAGS:

    -h, --help       Prints help information

    -R, --raw        Raw Hex Printing

    -S, --stdin      Inject Hex Packets from File

    -V, --version    Prints version information

OPTIONS:

    -b, --blacklist     Only print Rx packets that do NOT match this regex filter

    -c, --count                    Number of packet to receive before exiting [default: -1]

    -f, --filter                  Only print Rx packets that match this regex filter

    -t, --timeout                Time to receive for before exiting

    -F, --file                      Inject Hex Packets from File

    -r, --rate                      Rate to transmit (Packets Per Second)

    -s, --send                      Number of packet to transmit [default: 1]

ARGS:

        The network interface to use

            The hex bytes to send over the network

```

## Sending a packet

```

./nethex eth0 112233445566778899AABBCCDDEEFF -c 0 -s 100 -r 50

100 / 100 [============================================] 100.00 % 50.49/s 

Sending bytes: [11, 22, 33, 44, 55, 66, 77, 88, 99, AA, BB, CC, DD, EE, FF]

Sending bytes: [11, 22, 33, 44, 55, 66, 77, 88, 99, AA, BB, CC, DD, EE, FF]

Sending bytes: [11, 22, 33, 44, 55, 66, 77, 88, 99, AA, BB, CC, DD, EE, FF]

.. etc ..

```

* `--count 0` to not listen after transmitting

* `--send 100` send 100 of these packets

* `--rate 50` send 50 per second

### Sending from File or Stdin

```

cat mydata.txt | ./nethex eth0 -c 0 --stdin

```

* `--stdin` will pipe any hex strings into the network interface, newline seperated

Useful for fuzz testing a network interface / device

```

./nethex eth0 -c 0 --file mydata.txt

```

* `--file` will pipe any hex strings from a file into the network interface, newline seperated

## Monitoring an network interface

```

./nethex eth0 -c 1

----- Recv Packet -----

00000000  2A 1E 5F B3 8E E3 1A 8C 8C E9 2B 00 08 00 45 00  | *▲_│Ä∏→îîθ+.◘.E. |

00000010  00 28 CB 09 40 00 31 06 2C 45 B9 15 D8 A5 C0 A8  | .(╦○@.1♠,E╣§╪Ñ└¿ |

00000020  00 1E F3 B1 D5 CD A7 29 7E 51 D6 F6 B7 DE 50 10  | .▲≤▒╒═º)~Q╕÷╖▐P► |

00000030  00 80 DF 02 00 00       

```

* `--count 1` only grab one packet before exiting

### Filtering

Whitelist and blacklist filtering can be applied to the hex data. The filter is performed on the hex string only, not the ASCII area.

Whitespace and newlines are ignored in the filter.

* `--filter "77 77 88889999 AA"` Must contain this hex data. Whitespace ignored. Notice how this match crosses both lines

* `--blacklist "123456ABC"` Must not contain this hex data

```

 ./nethex lo -f "77 77 88889999 AA" -c 1

[2019-06-30T08:17:24Z INFO  nethex] Recv Packet

00000000  11 11 22 22 33 33 44 44 55 55 66 66 77 77 88 88  | ◄◄""33DDUUffwwêê |

00000010  99 99 AA AA BB BB CC CC DD DD EE EE FF FF        | ÖÖ¬¬╗╗╠╠▌▌εε..   |

```

## Logging

As of v0.5.0 most of the printing has been turned into an env_logger. While the debugging features are nice, disabling prints allows for a large 20x performance bonus. Logging can be enabled/disable using an enviroment variable. 

```

LOG=DEBUG ./nethex .........

LOG=WARN  ./nethex .........

```