rad 0.5.0

A type-safe, high-level interface to librados using the low-level C bindings from ceph-rust.
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
56
57
58
59
60
61
62

use std::ffi::CStr;

use libc;


error_chain! {
    types {
        Error, ErrorKind, ResultExt, Result;
    }

    links {}

    foreign_links {
        Nul(::ffi_pool::NulError);
        NulStd(::std::ffi::NulError);
        FromBytesWithNul(::std::ffi::FromBytesWithNulError);
        IntoString(::std::ffi::IntoStringError);
        Utf8(::std::str::Utf8Error);
        IO(::std::io::Error);
    }

    errors {
        Rados(e: u32) {
            description("RADOS error")
            display("RADOS error code {}: `{}`", e, get_error_string(*e).unwrap())
        }
    }
}


/// Convert the integer output of a librados API function into a `Result<()>`.
pub fn librados(err: i32) -> Result<()> {
    if err < 0 {
        bail!(ErrorKind::Rados(-err as u32));
    } else {
        Ok(())
    }
}


/// Convert the integer output of a librados API function into a `Result<u32>`, returning the error
/// value casted to a `u32` if it's positive and returning `Err` otherwise.
pub fn librados_res(err: i32) -> Result<u32> {
    if err < 0 {
        bail!(ErrorKind::Rados(-err as u32));
    } else {
        Ok(err as u32)
    }
}


/// Get the registered error string for a given error number.
pub fn get_error_string(err: u32) -> Result<String> {
    let error = unsafe {
        let err_str = libc::strerror(err as i32);
        try!(CStr::from_ptr(err_str).to_str().chain_err(
            || "while decoding error string",
        ))
    };

    Ok(error.to_string())
}