#port #check #networking #local #free #remote #ipv4

dev port_check

Get a free local port or check if a port somewhere is reachable

8 releases

0.2.1 Apr 1, 2024
0.2.0 Mar 22, 2024
0.1.5 Jan 16, 2020
0.1.3 Dec 28, 2019
0.1.0 Mar 21, 2019

#209 in Network programming

Download history 4860/week @ 2024-05-17 4555/week @ 2024-05-24 3411/week @ 2024-05-31 4122/week @ 2024-06-07 3046/week @ 2024-06-14 3439/week @ 2024-06-21 3445/week @ 2024-06-28 3715/week @ 2024-07-05 4653/week @ 2024-07-12 3938/week @ 2024-07-19 4163/week @ 2024-07-26 4928/week @ 2024-08-02 4851/week @ 2024-08-09 3860/week @ 2024-08-16 4503/week @ 2024-08-23 3432/week @ 2024-08-30

17,468 downloads per month
Used in 8 crates

MIT license

21KB
390 lines

port_check

crates.io Build Status codecov

A simple rust library to get a free local port or to check if a port somewhere is reachable

Example:

use port_check::*;
use std::time::Duration;

// --------------------------------------------------------------------
// If not specified, all port checks are performed for IPv4 addresses.
// --------------------------------------------------------------------

// get a free local port
let free_port = free_local_port().unwrap();

// get a free local port between 10000 and 15000
let free_port_in_range = free_local_port_in_range(10000..=15000);

// check whether a remote port is reachable
let is_reachable = is_port_reachable("192.0.2.0:8080");
// or
let is_reachable = is_port_reachable_with_timeout("192.0.2.0:8080", Duration::from_millis(10_000));



// --------------------------------------------------------------------
// IPv6 checks are supported too
// --------------------------------------------------------------------

let free_ipv6_port = free_local_ipv6_port().unwrap();

let is_ipv6_port_free = is_local_port_free(Port::ipv6(free_ipv6_port));
// or
let is_ipv6_port_free = is_local_ipv6_port_free(free_ipv6_port);

No runtime deps