libkrb5 0.0.3

[UNMAINTAINED] Rust bindings for MIT Kerberos 5
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

use std::error::Error;
use std::ffi::IntoStringError;
use std::fmt::{Display, Formatter};

use libkrb5_sys::*;

use crate::context::Krb5Context;

#[derive(Debug)]
pub enum Krb5Error {
    LibraryError { message: String },
    NullPointerDereference,
    StringConversion { error: Option<IntoStringError> },
    MaxVarArgsExceeded,
}

impl Display for Krb5Error {
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), std::fmt::Error> {
        use Krb5Error::*;

        match self {
            LibraryError { message } => write!(f, "Library error: {}", message),
            NullPointerDereference => write!(f, "NULL Pointer dereference error"),
            StringConversion { error } => match error {
                Some(error) => write!(f, "String conversion / UTF8 error: {}", error),
                None => write!(f, "String conversion / UTF8 error"),
            },
            MaxVarArgsExceeded => write!(
                f,
                "Maximum number of supported arguments for a variadic function exceeded."
            ),
        }
    }
}

impl Error for Krb5Error {}

impl From<IntoStringError> for Krb5Error {
    fn from(error: IntoStringError) -> Self {
        Krb5Error::StringConversion { error: Some(error) }
    }
}

#[must_use]
pub(crate) fn krb5_error_code_escape_hatch(context: &Krb5Context, code: krb5_error_code) -> Result<(), Krb5Error> {
    if code == 0 {
        Ok(())
    } else {
        Err(Krb5Error::LibraryError {
            message: context.error_code_to_message(code),
        })
    }
}