RubyGems - lanet - Versions diffs - 0.4.0 → 0.5.1 - Mend

lanet 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1e22dfda5b58811a99f1d763c3ff32d84b2e8e291ab07b8f1ee90e3c1849446
-  data.tar.gz: 70a12c6ea35bd5981acc401f0a7dc482c2f2161c2a67a8b4ffcefc00ac1777a4
+  metadata.gz: 0fa5904938004f84fe7b8d599da632140a532925cd0a0c48d5986d44443c0987
+  data.tar.gz: f039a015dcd75704b7fe80f2a84afbd758505048e78bc86001b9821c1be7a353
 SHA512:
-  metadata.gz: e45f31e4dacefa4d0622f1fdfe8d8cb48dca0c4ad256481a06f8bf7d1dea2ef231be657db2b8c92c1e129faa8375bdc36221152fb7967cca15ae7bc3c5fce89b
-  data.tar.gz: 4cceff6bc76a51aeebb0bc0585ec9228d53151421927e8e8461e39a79f0208ed3a793455f8b9e0714364ce9cb169e987ab757a29e7ad4ab3acc908ab72f8a11f
+  metadata.gz: ac7892c9bd9179483ea9ebb796fb567a11f79aab6197b1c49a11d2797167e91c59be5da17e861a3e08069bc4ff745eae8534e8cdcda516739906a8011ab9ffc8
+  data.tar.gz: ef408dedc43f2461c69d0a00ae207f4bd139e06f171cb5cfd0fd6f40e58d2e0aa1bc59403428587f6982a378418ff241fecb1805254b37ea63d1a39ccc8116e3

data/CHANGELOG.md CHANGED Viewed

@@ -5,7 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-## [0.4.0] - 2023-11-15
+## [0.5.1] - 2025-03-20
+### Changed
+- Optimized traceroute implementation for better performance and code readability
+- Simplified protocol selection logic with dedicated methods
+- Improved error handling for socket operations
+- Enhanced hostname extraction in traceroute results
+- Reorganized code structure for better maintainability
+- Added Windows-specific socket handling optimizations
+### Fixed
+- Fixed redundant code in socket handling for different operating systems
+- Improved error messages for unprivileged traceroute attempts
+- Fixed potential memory leaks in socket resource management
+- Added proper handling for non-standard traceroute output formats
+## [0.5.0] - 2025-03-12
+### Added
+- Advanced traceroute functionality for network path analysis
+- Multiple protocol support for traceroute: ICMP, UDP, and TCP
+- Load balancing detection in traceroute results
+- CLI command: `traceroute` with protocol selection and customizable parameters
+- Ruby API for programmatic traceroute operations
+- Comprehensive documentation and examples for traceroute feature
+## [0.4.0] - 2025-03-10
 ### Added
 - Mesh networking functionality for decentralized communication

data/Gemfile.lock CHANGED Viewed

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lanet (0.4.0)
+    lanet (0.5.1)
       thor (~> 1.2)
 GEM

data/README.md CHANGED Viewed

@@ -20,6 +20,7 @@ A lightweight, powerful LAN communication tool that enables secure message excha
 - **Digital Signatures**: Ensure message authenticity and integrity
 - **File Transfers**: Securely send encrypted files over the LAN with progress tracking and integrity verification
 - **Mesh Networking**: Create resilient mesh networks for decentralized communication, enabling messages to be routed through multiple hops without central infrastructure
+- **Advanced Traceroute**: Analyze network paths using multiple protocols (ICMP, UDP, and TCP) with intelligent fallback mechanisms
 ## Security Features
@@ -334,6 +335,36 @@ View information about your mesh network:
 lanet mesh info
 ```
+#### Tracing the route to a target host
+Basic traceroute using UDP (default protocol):
+```bash
+# Simple format
+lanet traceroute google.com
+# Option format
+lanet traceroute --host google.com
+```
+Trace using ICMP protocol:
+```bash
+lanet traceroute --host google.com --protocol icmp
+```
+Trace using TCP protocol:
+```bash
+lanet traceroute --host google.com --protocol tcp --max-hops 15
+```
+Customize traceroute parameters:
+```bash
+lanet traceroute --host github.com --protocol tcp --max-hops 20 --timeout 2 --queries 4
+```
 ### Ruby API
 You can also use Lanet programmatically in your Ruby applications:
@@ -443,6 +474,17 @@ end
 # Properly stop the mesh node
 mesh.stop
+# Trace route to a host with different protocols
+tracer = Lanet.traceroute(protocol: :udp)
+hops = tracer.trace('github.com')
+hops.each do |hop|
+  puts "Hop #{hop[:ttl]}: #{hop[:ip]} - Response: #{hop[:avg_time]}ms"
+end
+# Use TCP protocol with custom parameters
+tcp_tracer = Lanet.traceroute(protocol: :tcp, max_hops: 15, timeout: 2)
+tcp_tracer.trace('google.com')
 ```
 ## Mesh Network

data/index.html CHANGED Viewed

@@ -1,5 +1,6 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -7,188 +8,297 @@
     <style>
         body {
             font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            line-height: 1.7; /* Increased line height for better readability */
-            color: #34495e; /* Darker, more professional text color */
-            max-width: 980px; /* Slightly wider max width for content */
-            margin: 20px auto; /* Added top and bottom margin for better spacing */
+            line-height: 1.7;
+            /* Increased line height for better readability */
+            color: #34495e;
+            /* Darker, more professional text color */
+            max-width: 980px;
+            /* Slightly wider max width for content */
+            margin: 20px auto;
+            /* Added top and bottom margin for better spacing */
             padding: 20px;
-            background-color: #f4f6f9; /* Lighter background color */
+            background-color: #f4f6f9;
+            /* Lighter background color */
         }
         h1 {
-            color: #34495e; /* Darker heading color */
-            border-bottom: 3px solid #3498db; /* Thicker border */
-            padding-bottom: 12px; /* Increased padding */
-            letter-spacing: -0.5px; /* Slightly tighter letter spacing for headings */
+            color: #34495e;
+            /* Darker heading color */
+            border-bottom: 3px solid #3498db;
+            /* Thicker border */
+            padding-bottom: 12px;
+            /* Increased padding */
+            letter-spacing: -0.5px;
+            /* Slightly tighter letter spacing for headings */
         }
         h2 {
-            color: #3498db; /* Primary blue color for subheadings */
-            margin-top: 35px; /* Increased top margin */
-            margin-bottom: 10px; /* Added bottom margin */
+            color: #3498db;
+            /* Primary blue color for subheadings */
+            margin-top: 35px;
+            /* Increased top margin */
+            margin-bottom: 10px;
+            /* Added bottom margin */
         }
         h3 {
-            color: #2ecc71; /* Vibrant green for section titles */
+            color: #2ecc71;
+            /* Vibrant green for section titles */
             margin-top: 30px;
             margin-bottom: 8px;
         }
         h4 {
-            color: #34495e; /* Darker color for sub-subheadings */
+            color: #34495e;
+            /* Darker color for sub-subheadings */
             margin-top: 25px;
             margin-bottom: 5px;
         }
         p {
-            margin-bottom: 15px; /* Increased paragraph spacing */
-            color: #555; /* Slightly softer paragraph text color */
+            margin-bottom: 15px;
+            /* Increased paragraph spacing */
+            color: #555;
+            /* Slightly softer paragraph text color */
         }
-        ul, ol {
+        ul,
+        ol {
             margin-bottom: 15px;
             color: #555;
         }
         pre {
-            background-color: #f0f0f0; /* Slightly darker pre background */
-            border: 1px solid #ccc; /* Lighter border */
-            border-left: 5px solid #3498db; /* Thicker, more prominent left border */
-            padding: 16px; /* Increased padding */
+            background-color: #f0f0f0;
+            /* Slightly darker pre background */
+            border: 1px solid #ccc;
+            /* Lighter border */
+            border-left: 5px solid #3498db;
+            /* Thicker, more prominent left border */
+            padding: 16px;
+            /* Increased padding */
             overflow-x: auto;
-            border-radius: 6px; /* More rounded corners */
-            font-size: 0.95em; /* Slightly smaller font size in code blocks */
+            border-radius: 6px;
+            /* More rounded corners */
+            font-size: 0.95em;
+            /* Slightly smaller font size in code blocks */
         }
         code {
             font-family: 'Courier New', Courier, monospace;
-            color: #2c3e50; /* Darker code text color */
+            color: #2c3e50;
+            /* Darker code text color */
         }
         .container {
             background-color: #fff;
-            border-radius: 10px; /* More rounded container corners */
-            box-shadow: 0 3px 20px rgba(0, 0, 0, 0.08); /* Softer, more subtle shadow */
-            padding: 40px; /* Increased container padding */
+            border-radius: 10px;
+            /* More rounded container corners */
+            box-shadow: 0 3px 20px rgba(0, 0, 0, 0.08);
+            /* Softer, more subtle shadow */
+            padding: 40px;
+            /* Increased container padding */
         }
         .feature {
-            margin: 25px 0; /* Increased feature margin */
-            padding-left: 25px; /* Increased padding */
-            border-left: 5px solid #2ecc71; /* Thicker feature border */
+            margin: 25px 0;
+            /* Increased feature margin */
+            padding-left: 25px;
+            /* Increased padding */
+            border-left: 5px solid #2ecc71;
+            /* Thicker feature border */
         }
         .security-feature {
             background-color: #e8f4fc;
-            padding: 20px; /* Increased padding */
-            margin: 15px 0; /* Increased margin */
-            border-radius: 8px; /* More rounded corners */
+            padding: 20px;
+            /* Increased padding */
+            margin: 15px 0;
+            /* Increased margin */
+            border-radius: 8px;
+            /* More rounded corners */
         }
         .security-feature ul li {
-            margin-bottom: 8px; /* Spacing in security feature lists */
+            margin-bottom: 8px;
+            /* Spacing in security feature lists */
         }
         .cli-example {
             background-color: #2c3e50;
             color: #ecf0f1;
-            padding: 15px 20px; /* Increased padding */
-            margin: 15px 0; /* Increased margin */
-            border-radius: 8px; /* More rounded corners */
+            padding: 15px 20px;
+            /* Increased padding */
+            margin: 15px 0;
+            /* Increased margin */
+            border-radius: 8px;
+            /* More rounded corners */
             font-family: 'Courier New', Courier, monospace;
             position: relative;
-            font-size: 0.95em; /* Slightly smaller font size in CLI examples */
+            font-size: 0.95em;
+            /* Slightly smaller font size in CLI examples */
         }
         .cli-example::before {
             content: "$";
             color: #3498db;
-            margin-right: 12px; /* Increased margin */
+            margin-right: 12px;
+            /* Increased margin */
             font-weight: bold;
-            display: inline-block; /* Ensure proper spacing */
-            width: 15px; /* Fixed width for the dollar sign to align commands */
-            text-align: right; /* Align dollar sign to the right */
+            display: inline-block;
+            /* Ensure proper spacing */
+            width: 15px;
+            /* Fixed width for the dollar sign to align commands */
+            text-align: right;
+            /* Align dollar sign to the right */
         }
         .cli-section {
-            margin-bottom: 40px; /* Increased bottom margin */
+            margin-bottom: 40px;
+            /* Increased bottom margin */
             background-color: #f8f9fa;
-            padding: 25px; /* Increased padding */
-            border-radius: 8px; /* More rounded corners */
+            padding: 25px;
+            /* Increased padding */
+            border-radius: 8px;
+            /* More rounded corners */
         }
         .output-example {
             background-color: #f0f0f0;
-            padding: 15px; /* Increased padding */
-            margin: 15px 0; /* Increased margin */
-            border-radius: 8px; /* More rounded corners */
+            padding: 15px;
+            /* Increased padding */
+            margin: 15px 0;
+            /* Increased margin */
+            border-radius: 8px;
+            /* More rounded corners */
             font-family: 'Courier New', Courier, monospace;
             font-size: 0.9em;
-            border-left: 5px solid #9b59b6; /* Thicker border */
+            border-left: 5px solid #9b59b6;
+            /* Thicker border */
         }
         .tab-container {
             border: 1px solid #ddd;
-            border-radius: 8px; /* More rounded corners */
+            border-radius: 8px;
+            /* More rounded corners */
             overflow: hidden;
-            margin: 25px 0; /* Increased margin */
+            margin: 25px 0;
+            /* Increased margin */
         }
         .tab-buttons {
             display: flex;
             background-color: #f5f5f5;
-            border-bottom: 1px solid #ddd; /* Added bottom border to tab buttons container */
+            border-bottom: 1px solid #ddd;
+            /* Added bottom border to tab buttons container */
         }
         .tab-button {
-            padding: 12px 25px; /* Increased padding */
+            padding: 12px 25px;
+            /* Increased padding */
             background-color: transparent;
             border: none;
             cursor: pointer;
-            border-right: none; /* Removed right border */
+            border-right: none;
+            /* Removed right border */
             transition: background-color 0.3s;
-            font-weight: 500; /* Slightly bolder tab button text */
-            color: #777; /* Slightly muted tab button text color */
+            font-weight: 500;
+            /* Slightly bolder tab button text */
+            color: #777;
+            /* Slightly muted tab button text color */
         }
         .tab-button:hover {
-            background-color: #f0f0f0; /* Lighter hover background */
-            color: #555; /* Darker hover text color */
+            background-color: #f0f0f0;
+            /* Lighter hover background */
+            color: #555;
+            /* Darker hover text color */
         }
         .tab-button.active {
-            background-color: #fff; /* White background for active tab */
-            border-bottom: 3px solid #3498db; /* Underline for active tab */
-            color: #34495e; /* Darker text for active tab */
-            font-weight: bold; /* Bold text for active tab */
+            background-color: #fff;
+            /* White background for active tab */
+            border-bottom: 3px solid #3498db;
+            /* Underline for active tab */
+            color: #34495e;
+            /* Darker text for active tab */
+            font-weight: bold;
+            /* Bold text for active tab */
         }
         .tab-content {
             display: none;
-            padding: 20px; /* Increased padding */
-            background-color: #fff; /* White background for tab content */
+            padding: 20px;
+            /* Increased padding */
+            background-color: #fff;
+            /* White background for tab content */
         }
         .tab-content.active {
             display: block;
         }
         .badge {
             display: inline-block;
-            padding: 4px 10px; /* Increased badge padding */
-            border-radius: 6px; /* More rounded corners */
-            font-size: 13px; /* Slightly larger font size */
-            font-weight: 600; /* Bolder badge text */
-            letter-spacing: 0.5px; /* Added letter spacing */
+            padding: 4px 10px;
+            /* Increased badge padding */
+            border-radius: 6px;
+            /* More rounded corners */
+            font-size: 13px;
+            /* Slightly larger font size */
+            font-weight: 600;
+            /* Bolder badge text */
+            letter-spacing: 0.5px;
+            /* Added letter spacing */
         }
         .badge-new {
             background-color: #2ecc71;
             color: white;
         }
         .note {
             background-color: #fff8e1;
-            padding: 15px; /* Increased padding */
-            border-left: 5px solid #ffc107; /* Thicker border */
-            margin: 15px 0; /* Increased margin */
-            border-radius: 6px; /* More rounded corners */
+            padding: 15px;
+            /* Increased padding */
+            border-left: 5px solid #ffc107;
+            /* Thicker border */
+            margin: 15px 0;
+            /* Increased margin */
+            border-radius: 6px;
+            /* More rounded corners */
         }
         .note strong {
             font-weight: bold;
-            color: #333; /* Make "Note:" bold and slightly darker */
+            color: #333;
+            /* Make "Note:" bold and slightly darker */
         }
         footer {
-            margin-top: 50px; /* Increased footer margin */
+            margin-top: 50px;
+            /* Increased footer margin */
             text-align: center;
             color: #7f8c8d;
             padding-top: 20px;
-            border-top: 1px solid #ddd; /* Added top border to footer */
+            border-top: 1px solid #ddd;
+            /* Added top border to footer */
         }
         footer p {
-            color: #95a5a6; /* Softer footer text color */
-            font-size: 0.9em; /* Smaller footer font size */
+            color: #95a5a6;
+            /* Softer footer text color */
+            font-size: 0.9em;
+            /* Smaller footer font size */
         }
     </style>
 </head>
 <body>
     <div class="container">
         <h1>Lanet</h1>
-        <p>A secure network communication library that enables reliable and protected message exchange between devices on the same network.</p>
+        <p>A secure network communication library that enables reliable and protected message exchange between devices
+            on the same network.</p>
         <h2>Key Features</h2>
@@ -205,9 +315,11 @@
                 <h4>Benefits of Digital Signatures:</h4>
                 <ul>
                     <li><strong>Authentication</strong>: Verify that the message came from the claimed sender</li>
-                    <li><strong>Data Integrity</strong>: Ensure the message hasn't been tampered with during transit</li>
+                    <li><strong>Data Integrity</strong>: Ensure the message hasn't been tampered with during transit
+                    </li>
                     <li><strong>Non-repudiation</strong>: Senders cannot deny sending a message they signed</li>
-                    <li><strong>Protection against MITM attacks</strong>: Detect man-in-the-middle tampering attempts</li>
+                    <li><strong>Protection against MITM attacks</strong>: Detect man-in-the-middle tampering attempts
+                    </li>
                 </ul>
             </div>
         </div>
@@ -224,13 +336,15 @@
         <div class="feature">
             <h3>File Transfer <span class="badge badge-new">New in v0.3.0</span></h3>
-            <p>Securely transfer files between devices with encryption, digital signatures, and integrity verification.</p>
+            <p>Securely transfer files between devices with encryption, digital signatures, and integrity verification.
+            </p>
         </div>
         <div class="feature">
             <h3>Mesh Networking <span class="badge badge-new">New in v0.4.0</span></h3>
-            <p>Create resilient, decentralized mesh networks that enable communication between devices even without direct connectivity.</p>
+            <p>Create resilient, decentralized mesh networks that enable communication between devices even without
+                direct connectivity.</p>
             <div class="security-feature">
                 <h4>Benefits of Mesh Networking:</h4>
                 <ul>
@@ -243,10 +357,34 @@
             </div>
         </div>
+        <div class="feature">
+            <h3>Advanced Traceroute <span class="badge badge-new">New in v0.5.1</span></h3>
+            <p>Analyze network paths with multi-protocol traceroute capabilities to understand connectivity and
+                troubleshoot network issues.</p>
+            <div class="security-feature">
+                <h4>Features of Advanced Traceroute:</h4>
+                <ul>
+                    <li><strong>Multi-protocol support</strong>: Use ICMP, UDP, or TCP protocols for different network
+                        environments</li>
+                    <li><strong>Load balancing detection</strong>: Identify multi-path routing and load balancers in the
+                        network</li>
+                    <li><strong>Response time analysis</strong>: Measure latency at each hop in the network path</li>
+                    <li><strong>Customizable parameters</strong>: Adjust max hops, timeouts, and query count for
+                        different scenarios</li>
+                    <li><strong>Hostname resolution</strong>: Automatically resolve IP addresses to hostnames for easier
+                        identification</li>
+                    <li><strong>Fallback mechanism</strong>: Automatically uses system traceroute when elevated
+                        permissions aren't available</li>
+                </ul>
+            </div>
+        </div>
         <h2>Command Line Interface</h2>
         <div class="note">
-            <strong>Note:</strong> All Lanet commands have detailed help available. Try <code>lanet [command] --help</code> for more options.
+            <strong>Note:</strong> All Lanet commands have detailed help available. Try
+            <code>lanet [command] --help</code> for more options.
         </div>
         <div class="cli-section">
@@ -264,12 +402,12 @@
             </div>
             <div class="output-example">
-Key pair generated!
-Private key saved to: /home/user/.lanet_keys/lanet_private.key
-Public key saved to: /home/user/.lanet_keys/lanet_public.key
+                Key pair generated!
+                Private key saved to: /home/user/.lanet_keys/lanet_private.key
+                Public key saved to: /home/user/.lanet_keys/lanet_public.key
-IMPORTANT: Keep your private key secure and never share it.
-Share your public key with others who need to verify your messages.
+                IMPORTANT: Keep your private key secure and never share it.
+                Share your public key with others who need to verify your messages.
             </div>
             <h4>Send a Signed Message</h4>
@@ -279,7 +417,8 @@ Share your public key with others who need to verify your messages.
             <h4>Send a Signed & Encrypted Message</h4>
             <div class="cli-example">
-                lanet send --target 192.168.1.5 --message "Secure signed message" --key "my_secret_key" --private-key-file lanet_private.key
+                lanet send --target 192.168.1.5 --message "Secure signed message" --key "my_secret_key"
+                --private-key-file lanet_private.key
             </div>
             <h4>Broadcast a Signed Message</h4>
@@ -299,10 +438,10 @@ Share your public key with others who need to verify your messages.
             <p>Example output when receiving a signed message:</p>
             <div class="output-example">
-Message from 192.168.1.5:
-Content: Hello, this is a signed message
-Signature: ✓ VERIFIED
-----------------------------------------
+                Message from 192.168.1.5:
+                Content: Hello, this is a signed message
+                Signature: ✓ VERIFIED
+                ----------------------------------------
             </div>
         </div>
@@ -375,7 +514,8 @@ Signature: ✓ VERIFIED
             <p>Send a file with encryption and digital signature:</p>
             <div class="cli-example">
-                lanet send-file --target 192.168.1.5 --file document.pdf --key "my_secret_key" --private-key-file lanet_private.key
+                lanet send-file --target 192.168.1.5 --file document.pdf --key "my_secret_key" --private-key-file
+                lanet_private.key
             </div>
             <h4>Receive Files</h4>
@@ -385,15 +525,16 @@ Signature: ✓ VERIFIED
             <p>With signature verification:</p>
             <div class="cli-example">
-                lanet receive-file --output ./downloads --encryption-key "my_secret_key" --public-key-file lanet_public.key
+                lanet receive-file --output ./downloads --encryption-key "my_secret_key" --public-key-file
+                lanet_public.key
             </div>
             <p>Example output during file transfer:</p>
             <div class="output-example">
-Receiving file: document.pdf from 192.168.1.5
-Size: 1048576 bytes
-Transfer ID: 8a7b6c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p
-Progress: 75% (786432/1048576 bytes)
+                Receiving file: document.pdf from 192.168.1.5
+                Size: 1048576 bytes
+                Transfer ID: 8a7b6c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p
+                Progress: 75% (786432/1048576 bytes)
             </div>
         </div>
@@ -427,13 +568,55 @@ Progress: 75% (786432/1048576 bytes)
             <p>Example output when viewing mesh info:</p>
             <div class="output-example">
-Mesh Node ID: 4f9a8b7c-6d5e-4f3e-2d1c-0b9a8b7c6d5e
+                Mesh Node ID: 4f9a8b7c-6d5e-4f3e-2d1c-0b9a8b7c6d5e
-Connected nodes:
-  b1c2d3e4-f5g6-7h8i-9j0k-l1m2n3o4p5q6 (192.168.1.5, last seen 12s ago)
-  c5d4e3f2-g1h0-i9j8-k7l6-m5n4o3p2q1r0 (192.168.1.10, last seen 5s ago)
+                Connected nodes:
+                b1c2d3e4-f5g6-7h8i-9j0k-l1m2n3o4p5q6 (192.168.1.5, last seen 12s ago)
+                c5d4e3f2-g1h0-i9j8-k7l6-m5n4o3p2q1r0 (192.168.1.10, last seen 5s ago)
-Message cache: 24 messages
+                Message cache: 24 messages
+            </div>
+        </div>
+        <div class="cli-section">
+            <h3>Traceroute Commands <span class="badge badge-new">New in v0.5.0</span></h3>
+            <h4>Basic Traceroute (UDP protocol)</h4>
+            <div class="cli-example">
+                lanet traceroute --host google.com
+            </div>
+            <h4>Traceroute with ICMP Protocol</h4>
+            <div class="cli-example">
+                lanet traceroute --host google.com --protocol icmp
+            </div>
+            <h4>Traceroute with TCP Protocol</h4>
+            <div class="cli-example">
+                lanet traceroute --host github.com --protocol tcp
+            </div>
+            <h4>Customize Traceroute Parameters</h4>
+            <div class="cli-example">
+                lanet traceroute --host cloudflare.com --protocol tcp --max-hops 20 --timeout 2 --queries 4
+            </div>
+            <p>Example output of a traceroute:</p>
+            <div class="output-example">
+                Tracing route to github.com using UDP protocol
+                Maximum hops: 30, Timeout: 1s, Queries: 3
+                ======================================================================
+                TTL IP Address Hostname Response Time
+                ----------------------------------------------------------------------
+                1 192.168.1.1 router.home 2.34ms
+                2 172.16.42.1 isp-gateway.net 8.72ms
+                3 216.58.223.14 15.35ms
+                4 172.217.170.78 edge-router.google.com 22.89ms
+                5 * * Request timed out
+                6 140.82.121.4 github.com 45.23ms
+                Destination unreachable
+                ======================================================================
+                Trace complete.
             </div>
         </div>
@@ -446,6 +629,7 @@ Message cache: 24 messages
                 <button class="tab-button" onclick="openTab(event, 'tab-advanced')">Advanced Usage</button>
                 <button class="tab-button" onclick="openTab(event, 'tab-filetransfer')">File Transfer</button>
                 <button class="tab-button" onclick="openTab(event, 'tab-mesh')">Mesh Network</button>
+                <button class="tab-button" onclick="openTab(event, 'tab-traceroute')">Traceroute</button>
             </div>
             <div id="tab-basic" class="tab-content active">
@@ -626,6 +810,51 @@ end
 # Always stop the mesh node when done
 mesh.stop</code></pre>
             </div>
+            <div id="tab-traceroute" class="tab-content">
+                <pre><code>require 'lanet'
+# Create a traceroute instance with UDP protocol (default)
+tracer = Lanet.traceroute
+results = tracer.trace('github.com')
+# Display the results
+puts "Path to github.com:"
+results.each do |hop|
+  if hop[:ip].nil?
+    puts "Hop #{hop[:ttl]}: * * * Request timed out"
+  else
+    hostname = hop[:hostname] ? hop[:hostname] : ""
+    time = hop[:avg_time] ? "#{hop[:avg_time]}ms" : "*"
+    puts "Hop #{hop[:ttl]}: #{hop[:ip]} (#{hostname}) #{time}"
+    # Check for load balancing (multiple IPs at the same hop)
+    if hop[:all_ips] && hop[:all_ips].size > 1
+      puts "  Multiple IPs detected (load balancing):"
+      hop[:all_ips].each { |ip| puts "  - #{ip}" }
+    end
+  end
+end
+# Use ICMP protocol (may require root/admin privileges)
+begin
+  icmp_tracer = Lanet.traceroute(protocol: :icmp, max_hops: 10)
+  icmp_tracer.trace('google.com')
+rescue StandardError => e
+  puts "Error with ICMP traceroute: #{e.message}"
+end
+# Use TCP protocol with custom parameters
+tcp_tracer = Lanet.traceroute(protocol: :tcp, max_hops: 15,
+                             timeout: 2, queries: 4)
+tcp_results = tcp_tracer.trace('cloudflare.com')
+# Analyze a specific hop
+interesting_hop = tcp_results[5] # Sixth hop
+if interesting_hop && interesting_hop[:unreachable]
+  puts "Destination unreachable at hop #{interesting_hop[:ttl]}"
+end</code></pre>
+            </div>
         </div>
         <h2>Installation</h2>
@@ -637,10 +866,11 @@ mesh.stop</code></pre>
         <pre><code>gem install lanet</code></pre>
         <h2>Documentation</h2>
-        <p>For complete documentation, please visit the <a href="https://github.com/davidesantangelo/lanet">GitHub repository</a>.</p>
+        <p>For complete documentation, please visit the <a href="https://github.com/davidesantangelo/lanet">GitHub
+                repository</a>.</p>
         <footer style="margin-top: 40px; text-align: center; color: #7f8c8d;">
-            <p>Lanet v0.4.0 - Secure Network Communications Library</p>
+            <p>Lanet v0.5.1 - Secure Network Communications Library</p>
         </footer>
     </div>
@@ -663,4 +893,5 @@ mesh.stop</code></pre>
         }
     </script>
 </body>
 </html>

data/lib/lanet/cli.rb CHANGED Viewed

@@ -6,6 +6,7 @@ require "lanet/receiver"
 require "lanet/scanner"
 require "lanet/ping"
 require "lanet/encryptor"
+require "lanet/traceroute"
 module Lanet
   class CLI < Thor
@@ -366,6 +367,62 @@ module Lanet
       mesh.stop
     end
+    desc "traceroute [HOST]", "Trace the route to a target host using different protocols"
+    method_option :host, type: :string, desc: "Target host to trace route"
+    method_option :protocol, type: :string, default: "udp", desc: "Protocol to use (icmp, udp, tcp)"
+    method_option :max_hops, type: :numeric, default: 30, desc: "Maximum number of hops"
+    method_option :timeout, type: :numeric, default: 1, desc: "Timeout in seconds for each probe"
+    method_option :queries, type: :numeric, default: 3, desc: "Number of queries per hop"
+    def traceroute(single_host = nil)
+      # Use the positional parameter if provided, otherwise use the --host option
+      target_host = single_host || options[:host]
+      # Ensure we have a host to trace
+      unless target_host
+        puts "Error: No host specified. Please provide a host as an argument or use --host option."
+        return
+      end
+      tracer = Lanet::Traceroute.new(
+        protocol: options[:protocol].to_sym,
+        max_hops: options[:max_hops],
+        timeout: options[:timeout],
+        queries: options[:queries]
+      )
+      puts "Tracing route to #{target_host} using #{options[:protocol].upcase} protocol"
+      puts "Maximum hops: #{options[:max_hops]}, Timeout: #{options[:timeout]}s, Queries: #{options[:queries]}"
+      puts "=" * 70
+      puts format("%3s  %-15s  %-30s  %-10s", "TTL", "IP Address", "Hostname", "Response Time")
+      puts "-" * 70
+      tracer.trace(target_host).each do |hop|
+        if hop[:ip].nil?
+          puts format("%3d  %-15s  %-30s  %-10s", hop[:ttl], "*", "*", "Request timed out")
+        else
+          hostname = hop[:hostname] || ""
+          time_str = hop[:avg_time] ? "#{hop[:avg_time]}ms" : "*"
+          puts format("%3d  %-15s  %-30s  %-10s", hop[:ttl], hop[:ip], hostname, time_str)
+          # Show all IPs if there are multiple (for load balancing detection)
+          if hop[:all_ips] && hop[:all_ips].size > 1
+            puts "     Multiple IPs detected (possible load balancing):"
+            hop[:all_ips].each do |ip|
+              puts "     - #{ip}"
+            end
+          end
+          # Show unreachable marker
+          puts "     Destination unreachable" if hop[:unreachable]
+        end
+      end
+      puts "=" * 70
+      puts "Trace complete."
+    rescue StandardError => e
+      puts "Error performing traceroute: #{e.message}"
+      puts e.backtrace if options[:verbose]
+    end
     private
     def display_ping_details(host, result)

data/lib/lanet/traceroute.rb ADDED Viewed

@@ -0,0 +1,400 @@
+# frozen_string_literal: true
+require "socket"
+require "timeout"
+require "resolv"
+module Lanet
+  class Traceroute
+    # Supported protocols
+    PROTOCOLS = %i[icmp udp tcp].freeze
+    # Default settings
+    DEFAULT_MAX_HOPS = 30
+    DEFAULT_TIMEOUT = 1
+    DEFAULT_QUERIES = 3
+    DEFAULT_PORT = 33_434 # Starting port for UDP traceroute
+    attr_reader :results, :protocol, :max_hops, :timeout, :queries
+    def initialize(protocol: :udp, max_hops: DEFAULT_MAX_HOPS, timeout: DEFAULT_TIMEOUT, queries: DEFAULT_QUERIES)
+      @protocol = protocol.to_sym
+      @max_hops = max_hops
+      @timeout = timeout
+      @queries = queries
+      @results = []
+      return if PROTOCOLS.include?(@protocol)
+      raise ArgumentError, "Protocol must be one of #{PROTOCOLS.join(", ")}"
+    end
+    def trace(destination)
+      @results = []
+      destination_ip = resolve_destination(destination)
+      begin
+        trace_protocol(destination_ip)
+      rescue StandardError => e
+        raise e unless e.message.include?("Must run as root/administrator")
+        # Fall back to system traceroute command if we don't have root privileges
+        trace_using_system_command(destination)
+      end
+      @results
+    end
+    private
+    def trace_protocol(destination_ip)
+      case @protocol
+      when :icmp then trace_icmp(destination_ip)
+      when :udp then trace_udp(destination_ip)
+      when :tcp then trace_tcp(destination_ip)
+      end
+    end
+    def trace_using_system_command(destination)
+      # Build the appropriate system traceroute command
+      system_cmd = case @protocol
+                   when :icmp then "traceroute -I"
+                   when :tcp then "traceroute -T"
+                   else "traceroute" # UDP is the default
+                   end
+      # Add options for max hops, timeout, and queries/retries
+      system_cmd += " -m #{@max_hops} -w #{@timeout} -q #{@queries} #{destination}"
+      # Execute the command and capture output
+      output = `#{system_cmd}`
+      # Parse the output to build our results
+      parse_system_traceroute_output(output)
+    end
+    def parse_system_traceroute_output(output)
+      lines = output.split("\n")
+      # Skip only the header line which typically starts with "traceroute to..."
+      lines.shift if lines.any? && lines.first.start_with?("traceroute to")
+      # Process each line of output
+      lines.each do |line|
+        # Extract hop number and details
+        next unless line =~ /^\s*(\d+)\s+(.+)$/
+        hop_num = Regexp.last_match(1).to_i
+        hop_details = Regexp.last_match(2)
+        # Parse the hop details
+        if ["* * *", "*"].include?(hop_details.strip)
+          # All timeouts at this hop
+          @results << { ttl: hop_num, ip: nil, hostname: nil, avg_time: nil, timeouts: @queries }
+          next
+        end
+        # Extract IP, hostname, and timing info
+        all_ips = extract_multiple_ips(hop_details)
+        ip = all_ips&.first
+        hostname = extract_hostname(hop_details)
+        times = hop_details.scan(/(\d+\.\d+)\s*ms/).flatten.map(&:to_f)
+        avg_time = times.any? ? (times.sum / times.size).round(2) : nil
+        # Add to results
+        @results << {
+          ttl: hop_num,
+          ip: ip,
+          hostname: hostname,
+          avg_time: avg_time,
+          timeouts: @queries - times.size,
+          all_ips: all_ips&.size && all_ips.size > 1 ? all_ips : nil
+        }
+      end
+    end
+    def extract_hostname(hop_details)
+      hop_details =~ /([^\s(]+)\s+\(([0-9.]+)\)/ ? Regexp.last_match(1) : nil
+    end
+    def extract_multiple_ips(hop_details)
+      # Match all IP addresses in the hop details
+      ips = hop_details.scan(/\b(?:\d{1,3}\.){3}\d{1,3}\b/).uniq
+      # If no IPs were found in a non-timeout line, try alternate format
+      if ips.empty? && !hop_details.include?("*")
+        potential_ips = hop_details.split(/\s+/).select { |part| part =~ /\b(?:\d{1,3}\.){3}\d{1,3}\b/ }
+        ips = potential_ips unless potential_ips.empty?
+      end
+      ips
+    end
+    def resolve_destination(destination)
+      # If destination is already an IPv4 address, return it
+      return destination if destination =~ /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/
+      # Otherwise, resolve the hostname to an IPv4 address
+      begin
+        addresses = Resolv.getaddresses(destination)
+        raise Resolv::ResolvError, "no address for #{destination}" if addresses.empty?
+        # Find the first IPv4 address
+        ipv4_address = addresses.find { |addr| addr =~ /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/ }
+        raise "No IPv4 address found for hostname: #{destination}" if ipv4_address.nil?
+        ipv4_address
+      rescue Resolv::ResolvError => e
+        raise "Unable to resolve hostname: #{e.message}"
+      end
+    end
+    def get_hostname(ip)
+      Timeout.timeout(1) { Resolv.getname(ip) }
+    rescue StandardError
+      nil
+    end
+    def trace_icmp(destination_ip)
+      # ICMP traceroute implementation
+      1.upto(@max_hops) do |ttl|
+        hop_info = trace_hop_icmp(destination_ip, ttl)
+        @results << hop_info
+        # Stop if we've reached the destination or hit unreachable
+        break if hop_info[:ip] == destination_ip || hop_info[:unreachable]
+      end
+    end
+    def trace_hop_icmp(destination_ip, ttl)
+      hop_info = { ttl: ttl, responses: [] }
+      # Use ping with increasing TTL values
+      @queries.times do
+        cmd = ping_command_with_ttl(destination_ip, ttl)
+        ip = nil
+        response_time = nil
+        # Execute the ping command and parse the output
+        begin
+          output = `#{cmd}`
+          # Parse the response to get the responding IP
+          if output =~ /from (\d+\.\d+\.\d+\.\d+).*time=(\d+\.?\d*)/
+            ip = ::Regexp.last_match(1)
+            response_time = ::Regexp.last_match(2).to_f
+          end
+        rescue StandardError
+          # Handle errors
+        end
+        hop_info[:responses] << {
+          ip: ip,
+          response_time: response_time,
+          timeout: ip.nil?
+        }
+      end
+      # Process the responses
+      process_hop_responses(hop_info)
+    end
+    def ping_command_with_ttl(ip, ttl)
+      case RbConfig::CONFIG["host_os"]
+      when /mswin|mingw|cygwin/
+        "ping -n 1 -i #{ttl} -w #{@timeout * 1000} #{ip}"
+      when /darwin/
+        "ping -c 1 -m #{ttl} -t #{@timeout} #{ip}"
+      else
+        "ping -c 1 -t #{ttl} -W #{@timeout} #{ip}"
+      end
+    end
+    def trace_udp(destination_ip)
+      1.upto(@max_hops) do |ttl|
+        hop_info = trace_hop_udp(destination_ip, ttl)
+        @results << hop_info
+        # Stop if we've reached the destination or hit a destination unreachable
+        break if hop_info[:ip] == destination_ip || hop_info[:unreachable]
+      end
+    end
+    def trace_hop_udp(destination_ip, ttl)
+      hop_info = { ttl: ttl, responses: [] }
+      icmp_socket = create_icmp_socket
+      @queries.times do |i|
+        start_time = Time.now
+        port = DEFAULT_PORT + i + (ttl * @queries)
+        begin
+          # Create and configure the sending socket
+          sender = UDPSocket.new
+          sender.setsockopt(Socket::IPPROTO_IP, Socket::IP_TTL, ttl)
+          # Send the UDP packet
+          Timeout.timeout(@timeout) do
+            sender.send("TRACE", 0, destination_ip, port)
+            # Wait for ICMP response
+            data, addr = icmp_socket.recvfrom(512)
+            response_time = ((Time.now - start_time) * 1000).round(2)
+            # The responding IP is in addr[2]
+            ip = addr[2]
+            # Check if we've received an ICMP destination unreachable message
+            unreachable = data.bytes[20] == 3 # ICMP Type 3 is Destination Unreachable
+            hop_info[:responses] << {
+              ip: ip,
+              response_time: response_time,
+              timeout: false,
+              unreachable: unreachable
+            }
+          end
+        rescue Timeout::Error
+          hop_info[:responses] << { ip: nil, response_time: nil, timeout: true }
+        rescue StandardError => e
+          hop_info[:responses] << { ip: nil, response_time: nil, timeout: true, error: e.message }
+        ensure
+          sender&.close
+        end
+      end
+      icmp_socket.close
+      process_hop_responses(hop_info)
+    end
+    def create_icmp_socket
+      socket = Socket.new(Socket::AF_INET, Socket::SOCK_RAW, Socket::IPPROTO_ICMP)
+      socket.setsockopt(Socket::SOL_SOCKET, Socket::SO_REUSEADDR, true) unless windows?
+      socket
+    rescue Errno::EPERM, Errno::EACCES
+      raise "Must run as root/administrator to create raw sockets for traceroute"
+    end
+    def windows?
+      RbConfig::CONFIG["host_os"] =~ /mswin|mingw|cygwin/
+    end
+    def trace_tcp(destination_ip)
+      1.upto(@max_hops) do |ttl|
+        hop_info = trace_hop_tcp(destination_ip, ttl)
+        @results << hop_info
+        # Stop if we've reached the destination or hit unreachable
+        break if hop_info[:ip] == destination_ip || hop_info[:unreachable]
+      end
+    end
+    def trace_hop_tcp(destination_ip, ttl)
+      hop_info = { ttl: ttl, responses: [] }
+      @queries.times do |i|
+        # Use different ports for each query
+        port = 80 + i
+        start_time = Time.now
+        socket = nil
+        begin
+          # Create TCP socket with specific TTL
+          socket = Socket.new(Socket::AF_INET, Socket::SOCK_STREAM, 0)
+          socket.setsockopt(Socket::IPPROTO_IP, Socket::IP_TTL, ttl)
+          sockaddr = Socket.sockaddr_in(port, destination_ip)
+          # Attempt to connect with timeout
+          Timeout.timeout(@timeout) do
+            socket.connect_nonblock(sockaddr)
+          end
+          # If we get here, we successfully connected (likely at the final hop)
+          response_time = ((Time.now - start_time) * 1000).round(2)
+          hop_info[:responses] << {
+            ip: destination_ip,
+            response_time: response_time,
+            timeout: false
+          }
+        rescue IO::WaitWritable
+          # Connection in progress - need to use select for non-blocking socket
+          handle_wait_writable(socket, sockaddr, start_time, destination_ip, hop_info)
+        rescue SystemCallError, Timeout::Error
+          hop_info[:responses] << { ip: nil, response_time: nil, timeout: true }
+        ensure
+          socket&.close
+        end
+      end
+      process_hop_responses(hop_info)
+    end
+    def handle_wait_writable(socket, sockaddr, start_time, destination_ip, hop_info)
+      response_time = nil
+      ip = nil
+      begin
+        Timeout.timeout(@timeout) do
+          _, writable, = IO.select(nil, [socket], nil, @timeout)
+          if writable&.any?
+            begin
+              socket.connect_nonblock(sockaddr) # Will raise Errno::EISCONN if connected
+            rescue Errno::EISCONN
+              # Successfully connected
+              response_time = ((Time.now - start_time) * 1000).round(2)
+              ip = destination_ip
+            rescue SystemCallError
+              # Get the intermediary IP from the error - would need raw sockets to do properly
+              ip = nil
+            end
+          end
+        end
+      rescue Timeout::Error
+        hop_info[:responses] << { ip: nil, response_time: nil, timeout: true }
+      end
+      return unless ip
+      hop_info[:responses] << {
+        ip: ip,
+        response_time: response_time,
+        timeout: false
+      }
+    end
+    def process_hop_responses(hop_info)
+      # Count timeouts
+      timeouts = hop_info[:responses].count { |r| r[:timeout] }
+      # If all queries timed out
+      return { ttl: hop_info[:ttl], ip: nil, hostname: nil, avg_time: nil, timeouts: timeouts } if timeouts == @queries
+      # Get all responding IPs (could be different if load balancing is in effect)
+      ips = hop_info[:responses].map { |r| r[:ip] }.compact.uniq
+      # Most common responding IP
+      ip = ips.max_by { |i| hop_info[:responses].count { |r| r[:ip] == i } }
+      # Calculate average response time for responses from the most common IP
+      valid_times = hop_info[:responses].select { |r| r[:ip] == ip && r[:response_time] }.map { |r| r[:response_time] }
+      avg_time = valid_times.empty? ? nil : (valid_times.sum / valid_times.size).round(2)
+      # Check if any responses indicated "unreachable"
+      unreachable = hop_info[:responses].any? { |r| r[:unreachable] }
+      # Get hostname for the IP
+      hostname = get_hostname(ip)
+      {
+        ttl: hop_info[:ttl],
+        ip: ip,
+        hostname: hostname,
+        avg_time: avg_time,
+        timeouts: timeouts,
+        unreachable: unreachable,
+        # Include all IPs if there are different ones (for load balancing detection)
+        all_ips: ips.size > 1 ? ips : nil
+      }
+    end
+  end
+end

data/lib/lanet/version.rb CHANGED Viewed

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 module Lanet
-  VERSION = "0.4.0"
+  VERSION = "0.5.1"
 end

data/lib/lanet.rb CHANGED Viewed

@@ -9,6 +9,7 @@ require "lanet/cli"
 require "lanet/ping"
 require "lanet/file_transfer"
 require "lanet/mesh"
+require "lanet/traceroute"
 module Lanet
   class Error < StandardError; end
@@ -56,5 +57,10 @@ module Lanet
     def mesh_network(port = 5050, max_hops = 10)
       Mesh.new(port, max_hops)
     end
+    # Create a new traceroute instance
+    def traceroute(protocol: :udp, max_hops: 30, timeout: 1, queries: 3)
+      Traceroute.new(protocol: protocol, max_hops: max_hops, timeout: timeout, queries: queries)
+    end
   end
 end

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lanet
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Davide Santangelo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-10 00:00:00.000000000 Z
+date: 2025-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -100,6 +100,7 @@ files:
 - lib/lanet/scanner.rb
 - lib/lanet/sender.rb
 - lib/lanet/signer.rb
+- lib/lanet/traceroute.rb
 - lib/lanet/version.rb
 - sig/lanet.rbs
 homepage: https://github.com/davidesantangelo/lanet