indymilter 0.0.2

Asynchronous milter library
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
49
50
51
52
53
54
55

# indymilter

(in development)

Stand-alone asynchronous milter library.

* pure safe Rust, no dependency on C library
* asynchronous paradigm, implementation based on Tokio
* free software

## Example

Here is a simple but complete milter program that logs client IP addresses:

```rust
use indymilter::{Callbacks, Context, SocketInfo, Status};
use tokio::{net::UnixListener, signal};

#[tokio::main]
async fn main() {
    let config = Default::default();

    let callbacks = Callbacks::new()
        .on_connect(|context, _, socket_info| {
            Box::pin(handle_connect(context, socket_info))
        });

    let listener = UnixListener::bind("/run/ipmilter.sock")
        .expect("cannot open milter socket");

    indymilter::run(listener, callbacks, config, signal::ctrl_c())
        .await
        .expect("milter execution failed");
}

async fn handle_connect(
    _: &mut Context<()>,
    socket_info: Option<SocketInfo>,
) -> Status {
    if let Some(SocketInfo::Inet(addr)) = socket_info {
        println!("connect from {}", addr.ip());
    }

    Status::Continue
}
```

## Licence

Copyright © 2021 David Bürgin

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.