#clam-av #antivirus #sockets #clam-d

clam-client

A simple Rust implementation for talking to ClamD

2 releases

Uses old Rust 2015

0.1.1 Aug 14, 2018
0.1.0 Aug 4, 2018

#8 in #antivirus

21 downloads per month
Used in 2 crates

MIT license

32KB
441 lines

clam-client

clam-client is a simple rust interface for talking to a ClamAV server over a TCP socket.

Example:

extern crate clam_client;

use clam_client::client::ClamClient;
use clam_client::response::ClamScanResult;

fn main() {
    let client = ClamClient::new("127.0.0.1", 3310).unwrap();

    if let Ok(results) = client.scan_path("/tmp/", true) {
        for scan_result in results.iter() {
            match scan_result {
                ClamScanResult::Found(location, virus) => {
                    println!("Found virus: '{}' in {}", virus, location)
                },
                _ => {}
            }
        }
    }
}

Streaming is also supported:

let client = ClamClient::new("127.0.0.1", 3310).unwrap();
let file = File::open(some_path).unwrap();

match client.scan_stream(file) {
    Ok(result) => match result {
        ClamScanResult::Ok => println!("File {} is OK!", some_path,
        ClamScanResult::Found(_, virus) => {
            println!("Found virus: '{}' in {}", virus, some_path)
        }
        ClamScanResult::Error(err) => println!("Received error from ClamAV: {}", err),
    },
    Err(e) => println!("A network error occurred whilst talking to ClamAV:\n{}", e),
}

Todo

  • Add support for sessions: IDSESSION / END
  • Decide whether to implement VERSIONCOMMANDS
  • Decide whether to implement FILDES

Dependencies

~2.5MB
~41K SLoC