Client-side TLS stream More...

#include <cc/TlsClientStream>

Inheritance diagram for TlsClientStream:

Public Member Functions
	TlsClientStream ()=default
	Create a null client-side TLS stream.
	TlsClientStream (const Stream &stream, const TlsClientOptions &options=TlsClientOptions{})
	Open a new client-side TLS stream.
void	onTlsWarning (Function< void(const char *errorName)> &&f)
	Set TLS warning callback to f
Public Member Functions inherited from TlsStream
	TlsStream ()=default
	Create a null TLS stream.
Public Member Functions inherited from Stream
	Stream ()=default
	Create a null stream.
bool	waitEstablished (int timeout=-1)
	Wait until the connection is fully established.
bool	wait (IoEvent event, int timeout=-1)
	Wait for an I/O event.
long	read (Out< Bytes > buffer, long maxFill=-1)
	Read available bytes into buffer and return number of bytes read.
void	write (const Bytes &buffer, long fill=-1)
	Write fill bytes from buffer (if fill < 0 write all bytes from buffer).
void	write (const List< Bytes > &buffers)
	Write the contents of buffers in one go.
void	write (const List< String > &parts)
	Convenience method, equivalent to 'write(parts.join())'.
void	write (const struct iovec *iov, int iovcnt)
	Write the contents of the iov buffers in one go.
void	write (const char *s)
	Write C-string s.
bool	isDiscarding () const
	Return true if this stream is discarding all writes
long long	transferTo (const Stream &sink, long long count, const Bytes &buffer)
	Transfer a span of bytes.
long long	transferTo (const Stream &sink, long long count=-1)
	Transfer a span of bytes.
long	defaultTransferUnit () const
	Default I/O buffer size.
long long	skip (long long count)
	Read and discard count bytes.
void	drain (const Bytes &auxBuffer=Bytes{})
	Read everything that is left.
long	readSpan (Out< Bytes > buffer)
	Read fixed number of bytes.
String	readSpan (long count)
	Read a fixed number of bytes.
String	readAll ()
	Read the entire stream.
Public Member Functions inherited from Object
	Object ()=default
	Create a null object.
	operator bool () const
	Check if this is a non-null object.
bool	isNull () const
	Check if this is a null object.
int	useCount () const
	Reference count.
template<class T>
bool	is () const
	Check if this object is of type T.
template<class T>
T	as () const
	Cast this object to type T.
bool	isWeak () const
	Check if the underlying object reference is weak.
bool	operator== (const Object &other) const
	Equality operator.
std::strong_ordering	operator<=> (const Object &other) const
	Ordering operator.

Additional Inherited Members
Public Types inherited from Object
using	NullAccess = cc::NullAccess
	Error thrown when trying to access a null object.
using	VirginityTestFailed = cc::VirginityTestFailed
	Error thrown when trying to initialize an object with a non-virgin state.
Protected Member Functions inherited from TlsStream
	TlsStream (State *newState)
Protected Member Functions inherited from Stream
	Stream (State *newState)
State &	me ()
const State &	me () const
Protected Member Functions inherited from Object
template<class T>
T	weak () const
template<class T>
void	initOnce ()
	Create the object state when called the first time.
template<class T>
void	initOncePerThread ()
	Create a distinct object state for each thread when called the first time in that thread.
	Object (State *newState)
	Initialize object with newState.
	Object (State *state, Alias)
	Object (State *state, Weak)
Object &	operator= (std::nullptr_t)
Static Protected Member Functions inherited from Object
template<class T>
static T	alias (const State *state)
	Create an alias object for the given state.
template<class T>
static T	weak (const State *state)
Protected Attributes inherited from Object
Handle< State >	me
	Internal object state

Detailed Description

Client-side TLS stream

Exceptions

TlsError
TlsCertificateError
SystemError

Constructor & Destructor Documentation

◆ TlsClientStream() [1/2]

TlsClientStream ( )

default

Create a null client-side TLS stream.

◆ TlsClientStream() [2/2]

TlsClientStream	(	const Stream &	stream,
		const TlsClientOptions &	options = TlsClientOptions{} )

Open a new client-side TLS stream.

Parameters

stream	Underlying transport stream
options	Client credentials and connection parameters (optional)

Note: This constructor blocks until the stream becomes ready.

Member Function Documentation

◆ onTlsWarning()

void onTlsWarning ( Function< void(const char *errorName)> && f )

Set TLS warning callback to f