pub struct SslStream<S> { /* private fields */ }
Expand description
A TLS session over a stream.
Implementations§
source§impl<S: Read + Write> SslStream<S>
impl<S: Read + Write> SslStream<S>
sourcepub unsafe fn from_raw_parts(ssl: *mut SSL, stream: S) -> Self
pub unsafe fn from_raw_parts(ssl: *mut SSL, stream: S) -> Self
Constructs an SslStream
from a pointer to the underlying OpenSSL SSL
struct.
This is useful if the handshake has already been completed elsewhere.
Safety
The caller must ensure the pointer is valid.
sourcepub fn ssl_read(&mut self, buf: &mut [u8]) -> Result<usize, Error>
pub fn ssl_read(&mut self, buf: &mut [u8]) -> Result<usize, Error>
Like read
, but returns an ssl::Error
rather than an io::Error
.
It is particularly useful with a nonblocking socket, where the error value will identify if OpenSSL is waiting on read or write readiness.
This corresponds to SSL_read
.
sourcepub fn ssl_write(&mut self, buf: &[u8]) -> Result<usize, Error>
pub fn ssl_write(&mut self, buf: &[u8]) -> Result<usize, Error>
Like write
, but returns an ssl::Error
rather than an io::Error
.
It is particularly useful with a nonblocking socket, where the error value will identify if OpenSSL is waiting on read or write readiness.
This corresponds to SSL_write
.
sourcepub fn shutdown(&mut self) -> Result<ShutdownResult, Error>
pub fn shutdown(&mut self) -> Result<ShutdownResult, Error>
Shuts down the session.
The shutdown process consists of two steps. The first step sends a close notify message to
the peer, after which ShutdownResult::Sent
is returned. The second step awaits the receipt
of a close notify message from the peer, after which ShutdownResult::Received
is returned.
While the connection may be closed after the first step, it is recommended to fully shut the session down. In particular, it must be fully shut down if the connection is to be used for further communication in the future.
This corresponds to SSL_shutdown
.
sourcepub fn get_shutdown(&mut self) -> ShutdownState
pub fn get_shutdown(&mut self) -> ShutdownState
Returns the session’s shutdown state.
This corresponds to SSL_get_shutdown
.
sourcepub fn set_shutdown(&mut self, state: ShutdownState)
pub fn set_shutdown(&mut self, state: ShutdownState)
Sets the session’s shutdown state.
This can be used to tell OpenSSL that the session should be cached even if a full two-way shutdown was not completed.
This corresponds to SSL_set_shutdown
.
source§impl<S> SslStream<S>
impl<S> SslStream<S>
sourcepub fn into_inner(self) -> S
pub fn into_inner(self) -> S
Converts the SslStream to the underlying data stream.
Trait Implementations§
source§impl<S: Read + Write> Read for SslStream<S>
impl<S: Read + Write> Read for SslStream<S>
source§fn read(&mut self, buf: &mut [u8]) -> Result<usize>
fn read(&mut self, buf: &mut [u8]) -> Result<usize>
1.36.0 · source§fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>
fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>
read
, except that it reads into a slice of buffers. Read moresource§fn is_read_vectored(&self) -> bool
fn is_read_vectored(&self) -> bool
can_vector
)1.0.0 · source§fn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>
fn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>
buf
. Read more1.0.0 · source§fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
buf
. Read more1.6.0 · source§fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
buf
. Read moresource§fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>
fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>
read_buf
)source§fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>
fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>
read_buf
)cursor
. Read more1.0.0 · source§fn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
fn by_ref(&mut self) -> &mut Selfwhere Self: Sized,
Read
. Read moresource§impl<S: Read + Write> Write for SslStream<S>
impl<S: Read + Write> Write for SslStream<S>
source§fn write(&mut self, buf: &[u8]) -> Result<usize>
fn write(&mut self, buf: &[u8]) -> Result<usize>
source§fn flush(&mut self) -> Result<()>
fn flush(&mut self) -> Result<()>
source§fn is_write_vectored(&self) -> bool
fn is_write_vectored(&self) -> bool
can_vector
)1.0.0 · source§fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
source§fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
write_all_vectored
)