# port-scanner
A simple, yet fast, async port scanner library for Rust.  Built on [async-std](https://github.com/async-rs/async-std)

## Usage
A new Scanner only takes the timeout used for each port.  

To run a port scan against localhost.  This will return a vector of socket addresses that are listening on tcp:

```rust
  use async_std::task;
  use futures::future::join_all;
  use async_port_scanner::Scanner;
  let ps = Scanner::new(Duration::from_secs(4));

  let ftr = ps.run("127.0.0.1".to_string(), 1, 65535);
  let my_addrs: Vec<SocketAddr> = task::block_on(async { ftr.await });
  println!("{:?}", my_addrs);

```

It's easy to hit the open files limit on your system.  To get around this, limit the scanner to running in batches of ports at a time:

```rust
  let ftr = ps.run_batched("127.0.0.1".to_string(), 1, 65535, 10000);
  let my_addrs: Vec<SocketAddr> = task::block_on(async { ftr.await });
  println!("{:?}", my_addrs);
```

You can also schedule scans against multiple hosts.  This will return a vector of vectors of socket addresses.

```rust
  let my_ftr = ps.run_batched("127.0.0.1".to_string(), 1, 65535, 3000);
  let dev1_ftr = ps.run_batched("192.168.1.172".to_string(), 1, 65535, 3000);
  let dev2_ftr = ps.run_batched("192.168.1.137".to_string(), 1, 65535, 3000);
  let all_ftrs = vec![my_ftr, dev1_ftr, dev2_ftr];
  let results: Vec<Vec<SocketAddr>> = task::block_on(async move { join_all(all_ftrs).await });
  println!("{:?}", results);

```