netsem 0.1.5

Standardized, pure-functional IP address validation and port checking utilities.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

/* examples/os_check.rs */

//! Requires the `check` feature: `cargo run --example os_check --features check`

use netsem::{check_bind_tcp, check_bind_udp, check_connect_tcp, check_connect_udp};
#[cfg(feature = "check")]
use std::time::Duration;

fn main() {
	#[cfg(not(feature = "check"))]
	{
		println!("This example requires the 'check' feature to perform OS operations.");
		println!("Please run with: cargo run --example os_check --features check");
	}

	#[cfg(feature = "check")]
	{
		let localhost = "127.0.0.1".parse().unwrap();

		// 1. Check if we can bind to a port (Port 0 lets OS pick a free one)
		println!("Checking if we can bind TCP to 127.0.0.1:0...");
		match check_bind_tcp(localhost, 0) {
			Ok(_) => println!("Successfully verified TCP bind capability on an ephemeral port."),
			Err(e) => eprintln!("TCP Bind check failed: {e}"),
		}

		println!("Checking if we can bind UDP to 127.0.0.1:0...");
		match check_bind_udp(localhost, 0) {
			Ok(_) => println!("Successfully verified UDP bind capability on an ephemeral port."),
			Err(e) => eprintln!("UDP Bind check failed: {e}"),
		}

		// 2. Check if something is listening on a port (e.g., DNS on 53)
		let dns_ip = "8.8.8.8".parse().unwrap();
		println!("\nChecking TCP connection to Google DNS (8.8.8.8:53) with 2s timeout...");
		match check_connect_tcp(dns_ip, 53, Some(Duration::from_secs(2))) {
			Ok(_) => println!("Successfully connected to 8.8.8.8:53."),
			Err(e) => eprintln!("TCP Connection check failed (this is normal if offline): {e}"),
		}

		println!("\nChecking UDP 'connection' to Google DNS (8.8.8.8:53)...");
		// Note: UDP connect is just setting default address, not a handshake.
		match check_connect_udp(dns_ip, 53) {
			Ok(_) => println!("Successfully set default UDP destination to 8.8.8.8:53."),
			Err(e) => eprintln!("UDP Connect check failed: {e}"),
		}
	}
}