net-io 0.5.0

Network IO substrate for Rust: TCP, UDP and local-socket listeners, connection lifecycle, limits, graceful drain, PROXY protocol, and a TLS seam. Protocol-free and dependency-free.
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

//! Started by a FastCGI process manager (Apache `mod_fcgid`, `spawn-fcgi`)?
//! Then descriptor 0 is the listening socket to serve; otherwise bind an
//! address. This example only detects and accepts: the FastCGI protocol itself
//! is fcgi-net's job.
//!
//! ```text
//! cargo run --example fastcgi_detect -- 127.0.0.1:7005
//! ```

#[cfg(unix)]
fn main() -> Result<(), Box<dyn std::error::Error>> {
    use net_io::{AllowAll, ListenerSpec, ServerBuilder};

    let spec = match net_io::fastcgi_listener()? {
        Some(handle) => {
            println!("started by a FastCGI manager; serving {}", handle.local());
            ListenerSpec::adopt(handle)
        }
        None => {
            let addr = std::env::args()
                .nth(1)
                .unwrap_or_else(|| "127.0.0.1:7005".to_string());
            println!("descriptor 0 is not a listening socket; binding {addr}");
            ListenerSpec::tcp(addr.as_str())
        }
    };
    let server = ServerBuilder::new()
        .listener(spec)
        .handler(|conn| conn.send_all(b"accepted\n"))
        .gate(AllowAll)
        .build()?;
    server.open_door()?;
    let report = server.wait_for_stop();
    println!("stopped: {report:?}");
    Ok(())
}

#[cfg(not(unix))]
fn main() {
    eprintln!("the FastCGI descriptor 0 convention is Unix only (Windows: open decision OD-26)");
}