tUpdate README for clarity - icmphop - Add hops in ipv6 traceroute
(HTM) git clone git://git.z3bra.org/icmphop.git
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
---
(DIR) commit 0eca802c92d2838b2424c11d3925bbe3e0296e7b
(DIR) parent 9c46a1508a8cf426905bee8a7df7bd38f81cfb47
(HTM) Author: Willy Goiffon <dev@z3bra.org>
Date: Thu, 13 Oct 2022 17:56:51 +0200
Update README for clarity
Diffstat:
M README | 40 +++++++++++++++++++-------------
1 file changed, 24 insertions(+), 16 deletions(-)
---
(DIR) diff --git a/README b/README
t@@ -2,35 +2,43 @@ icmphop
=======
Insert hops in ipv6 traceroute
-The program will craft ICMP timeout exceeded error messages to effectively
-add hops between a client and the target ipv6 address.
+Traceroute send many packets to its destination, increasing the TTL
+(time to live) value everytime it receives a "time exceeed" message.
-This is of no use, besides printing funny stuff in traceroutes using
-reverse DNS entries.
+icmphop sniffs a virtual interface, and send "time exceeded" messages
+until the TTL match a specified number, effectively adding "hops" to
+a traceroute.
+The source ipv6 of the error messages is changed so the traceroute
+appears to be incrementing, up to the requested destination.
+
+Note: if the last byte of the requested address is lower than the number
+of hops, the packet will be ignored
Features
-----
- IPv6 only
-- Insert up to 15 hops
+- Insert up to 254 hops
+- Hops respond to ping
+- BSD, Linux, Windows, Mac
Usage
-----
- # icmphop -n 5 -i hop0 &
- # ip -6 addr add fd00:c001:dad::1/96 dev hop0
- # ip link set hop0 up
- % tracepath -6 fd00:c001:dad::5
+ # interface setup
+ icmphop -n 5 -i hop0 &
+ ip -6 addr add fd00:c001:dad::1/96 dev hop0
+ ip link set hop0 up
+
+ tracepath -6 fd00:c001:dad::9
1?: [LOCALHOST] 0.014ms pmtu 1500
1: fd00:c001:dad::1 0.108ms
- 1: fd00:c001:dad::1 0.081ms
- 2: fd00:c001:dad::2 0.091ms asymm 1
- 3: fd00:c001:dad::3 0.087ms asymm 1
- 4: fd00:c001:dad::4 0.082ms asymm 1
- 5: fd00:c001:dad::5 0.078ms reached
+ 1: fd00:c001:dad::5 0.081ms
+ 2: fd00:c001:dad::6 0.091ms asymm 1
+ 3: fd00:c001:dad::7 0.087ms asymm 1
+ 4: fd00:c001:dad::8 0.082ms asymm 1
+ 5: fd00:c001:dad::9 0.078ms reached
Resume: pmtu 1500 hops 5 back 1
-The requested ipv6 address last byte must be the same as the number of
-hops. For example, with 10 hops, use fd00:c001:dad:a.
Installation
-----