3 unstable releases
Uses old Rust 2015
0.7.0 | Oct 27, 2018 |
---|---|
0.6.2 | Oct 12, 2018 |
0.6.1 | Oct 11, 2018 |
0.6.0 |
|
#21 in #retrieve
192 downloads per month
Used in lopxy
64KB
1.5K
SLoC
netstat
Cross-platform library to retrieve network sockets information. Aims to be optimal by using low-level OS APIs instead of command line utilities. Provides unified interface and returns data structures which may have additional fields depending on platform.
Example
extern crate netstat;
use netstat::*;
fn main() {
let af_flags = AddressFamilyFlags::IPV4 | AddressFamilyFlags::IPV6;
let proto_flags = ProtocolFlags::TCP | ProtocolFlags::UDP;
let sockets_info = get_sockets_info(af_flags, proto_flags).unwrap();
for si in sockets_info {
match si.protocol_socket_info {
ProtocolSocketInfo::Tcp(tcp_si) => println!(
"TCP {}:{} -> {}:{} {:?} - {}",
tcp_si.local_addr,
tcp_si.local_port,
tcp_si.remote_addr,
tcp_si.remote_port,
si.associated_pids,
tcp_si.state
),
ProtocolSocketInfo::Udp(udp_si) => println!(
"UDP {}:{} -> *:* {:?}",
udp_si.local_addr, udp_si.local_port, si.associated_pids
),
}
}
}
Details
- On Windows, library uses GetExtendedTcpTable & GetExtendedUdpTable (iphlpapi)
- On Linux, it uses NETLINK_INET_DIAG protocol and performs pid lookup by traversing
procfs
- On OS X, it should ideally use
sysctls
, but currently just parses netstat output (proper impletemention is mostly done in unused modules undersrc/integrations/osx
folder, it waits for contributors with mac to finish it)
License
Licensed under either of:
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~145KB