11# NetHex
22A small rust utility for dumping data-layer network traffic
33
4- [ ![ Build Status ] ( https://travis-ci.org /JackNewman12/NetHex. svg?branch=master )] ( https://travis-ci.org /JackNewman12/NetHex )
4+ [ ![ Rust ] ( https://github.com /JackNewman12/NetHex/actions/workflows/rust.yml/badge. svg )] ( https://github.com /JackNewman12/NetHex/actions/workflows/rust.yml )
55![ License: MIT] ( https://img.shields.io/badge/License-MIT-brightgreen.svg )
66
77```
8- ./net_hex --help
8+ ./nethex --help
99NetHex 0.8.0
1010A small utility for reading / writing directly to a network interface
1111
1212USAGE:
13- net_hex [FLAGS] [OPTIONS] [ARGS]
13+ nethex [FLAGS] [OPTIONS] [ARGS]
1414
1515FLAGS:
1616 -h, --help Prints help information
3535
3636## Sending a packet
3737```
38- ./net_hex eth0 112233445566778899AABBCCDDEEFF -c 0 -s 100 -r 50
38+ ./nethex eth0 112233445566778899AABBCCDDEEFF -c 0 -s 100 -r 50
3939100 / 100 [============================================] 100.00 % 50.49/s
4040Sending bytes: [11, 22, 33, 44, 55, 66, 77, 88, 99, AA, BB, CC, DD, EE, FF]
4141Sending bytes: [11, 22, 33, 44, 55, 66, 77, 88, 99, AA, BB, CC, DD, EE, FF]
@@ -48,19 +48,19 @@ Sending bytes: [11, 22, 33, 44, 55, 66, 77, 88, 99, AA, BB, CC, DD, EE, FF]
4848
4949### Sending from File or Stdin
5050```
51- cat mydata.txt | ./net_hex eth0 -c 0 --stdin
51+ cat mydata.txt | ./nethex eth0 -c 0 --stdin
5252```
5353* ` --stdin ` will pipe any hex strings into the network interface, newline seperated
5454Useful for fuzz testing a network interface / device
5555
5656```
57- ./net_hex eth0 -c 0 --file mydata.txt
57+ ./nethex eth0 -c 0 --file mydata.txt
5858```
5959* ` --file ` will pipe any hex strings from a file into the network interface, newline seperated
6060
6161## Monitoring an network interface
6262```
63- ./net_hex eth0 -c 1
63+ ./nethex eth0 -c 1
6464----- Recv Packet -----
656500000000 2A 1E 5F B3 8E E3 1A 8C 8C E9 2B 00 08 00 45 00 | *▲_│Ä∏→îîθ+.◘.E. |
666600000010 00 28 CB 09 40 00 31 06 2C 45 B9 15 D8 A5 C0 A8 | .(╦○@.1♠,E╣§╪Ñ└¿ |
@@ -76,8 +76,8 @@ Whitespace and newlines are ignored in the filter.
7676* ` --filter "77 77 88889999 AA" ` Must contain this hex data. Whitespace ignored. Notice how this match crosses both lines
7777* ` --blacklist "123456ABC" ` Must not contain this hex data
7878```
79- ./net_hex lo -f "77 77 88889999 AA" -c 1
80- [2019-06-30T08:17:24Z INFO net_hex ] Recv Packet
79+ ./nethex lo -f "77 77 88889999 AA" -c 1
80+ [2019-06-30T08:17:24Z INFO nethex ] Recv Packet
818100000000 11 11 22 22 33 33 44 44 55 55 66 66 77 77 88 88 | ◄◄""33DDUUffwwêê |
828200000010 99 99 AA AA BB BB CC CC DD DD EE EE FF FF | ÖÖ¬¬╗╗╠╠▌▌εε.. |
8383
0 commit comments