#clam-av #clamd #anitvirus

revolt_clamav-client

ClamAV client library

2 releases

0.1.5 Jun 5, 2023
0.1.4 Jun 5, 2023

#3 in #clamd

Download history 8/week @ 2024-04-08 5/week @ 2024-04-22 3/week @ 2024-04-29 8/week @ 2024-05-13 18/week @ 2024-05-20 13/week @ 2024-05-27 10/week @ 2024-06-03 12/week @ 2024-06-10 1/week @ 2024-06-17 129/week @ 2024-06-24 309/week @ 2024-07-01 312/week @ 2024-07-08 315/week @ 2024-07-15 29/week @ 2024-07-22

1,004 downloads per month

MIT license

7KB
114 lines

Rust ClamAV Client

A simple ClamAV client to stream files to clamd for antivirus scanning.

Please note: The functions ping_socket and scan_socket are only available on Unix platforms.

Installation

Add this to your Cargo.toml:

[dependencies]
clamav-client = "0.1.3"

Usage

Ensure ClamD is running by pinging the server for a response:

let clamd_host_address = "localhost:3310";

let clamd_available = match clamav_client::ping_tcp(clamd_host_address) {
    Ok(ping_response) => ping_response == b"PONG\0",
    Err(_) => false,
};

if !clamd_available {
    println!("Cannot ping clamd at {}", clamd_host_address);
    return;
}

Scan a file for detections:

let file_path = "virus.txt";
let scan_response = clamav_client::scan_tcp(file_path, clamd_host_address, None).unwrap();
let file_clean = clamav_client::clean(&scan_response).unwrap();
if file_clean {
    println!("No virus found in {}", file_path);
} else {
    println!("The file {} is infected!", file_path);
}

Scan a buffer from memory:

let buffer = "X5O!P%@AP[4\\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*"
    .bytes()
    .collect::<Vec<u8>>();

let scan_response = clamav_client::scan_buffer_tcp(buffer, clamd_host_address, None).unwrap();
let file_clean = clamav_client::clean(&scan_response).unwrap();
assert!(!file_clean);

No runtime deps