pub use self::SslError::*; pub use self::OpensslError::*; use libc::c_ulong; use std::error; use std::fmt; use std::ffi::CStr; use std::io; use ffi; /// An SSL error #[derive(Debug)] pub enum SslError { /// The underlying stream reported an error StreamError(io::Error), /// The SSL session has been closed by the other end SslSessionClosed, /// An error in the OpenSSL library OpenSslErrors(Vec), } /// An error on a nonblocking stream. #[derive(Debug)] pub enum NonblockingSslError { /// A standard SSL error occurred. SslError(SslError), /// The OpenSSL library wants data from the remote socket; /// the caller should wait for read readiness. WantRead, /// The OpenSSL library wants to send data to the remote socket; /// the caller should wait for write readiness. WantWrite, } impl fmt::Display for SslError { fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result { try!(fmt.write_str(error::Error::description(self))); if let OpenSslErrors(ref errs) = *self { let mut first = true; for err in errs { if first { try!(fmt.write_str(": ")); first = false; } else { try!(fmt.write_str(", ")); } match *err { UnknownError { ref reason, .. } => try!(fmt.write_str(reason)), } } } Ok(()) } } impl error::Error for SslError { fn description(&self) -> &str { match *self { StreamError(_) => "The underlying stream reported an error", SslSessionClosed => "The SSL session has been closed by the other end", OpenSslErrors(_) => "An error in the OpenSSL library", } } fn cause(&self) -> Option<&error::Error> { match *self { StreamError(ref err) => Some(err as &error::Error), _ => None } } } impl fmt::Display for NonblockingSslError { fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result { fmt.write_str(error::Error::description(self)) } } impl error::Error for NonblockingSslError { fn description(&self) -> &str { match *self { NonblockingSslError::SslError(ref e) => e.description(), NonblockingSslError::WantRead => "The OpenSSL library wants data from the remote socket", NonblockingSslError::WantWrite => "The OpenSSL library want to send data to the remote socket", } } fn cause(&self) -> Option<&error::Error> { match *self { NonblockingSslError::SslError(ref e) => e.cause(), _ => None } } } impl From for NonblockingSslError { fn from(e: SslError) -> NonblockingSslError { NonblockingSslError::SslError(e) } } /// An error from the OpenSSL library #[derive(Debug, Clone, PartialEq, Eq)] pub enum OpensslError { /// An unknown error UnknownError { /// The library reporting the error library: String, /// The function reporting the error function: String, /// The reason for the error reason: String } } fn get_lib(err: c_ulong) -> String { unsafe { let bytes = CStr::from_ptr(ffi::ERR_lib_error_string(err)).to_bytes().to_vec(); String::from_utf8(bytes).unwrap() } } fn get_func(err: c_ulong) -> String { unsafe { let bytes = CStr::from_ptr(ffi::ERR_func_error_string(err)).to_bytes().to_vec(); String::from_utf8(bytes).unwrap() } } fn get_reason(err: c_ulong) -> String { unsafe { let bytes = CStr::from_ptr(ffi::ERR_reason_error_string(err)).to_bytes().to_vec(); String::from_utf8(bytes).unwrap() } } impl SslError { /// Creates a new `OpenSslErrors` with the current contents of the error /// stack. pub fn get() -> SslError { let mut errs = vec!(); loop { match unsafe { ffi::ERR_get_error() } { 0 => break, err => errs.push(SslError::from_error_code(err)) } } OpenSslErrors(errs) } /// Creates an `SslError` from the raw numeric error code. pub fn from_error(err: c_ulong) -> SslError { OpenSslErrors(vec![SslError::from_error_code(err)]) } fn from_error_code(err: c_ulong) -> OpensslError { ffi::init(); UnknownError { library: get_lib(err), function: get_func(err), reason: get_reason(err) } } } #[test] fn test_uknown_error_should_have_correct_messages() { let errs = match SslError::from_error(336032784) { OpenSslErrors(errs) => errs, _ => panic!("This should always be an `OpenSslErrors` variant.") }; let UnknownError { ref library, ref function, ref reason } = errs[0]; assert_eq!(&library[..], "SSL routines"); assert_eq!(&function[..], "SSL23_GET_SERVER_HELLO"); assert_eq!(&reason[..], "sslv3 alert handshake failure"); }