Class Poco::Net::SecureServerSocket
Author: Applied Informatics Software Engineering GmbH and Contributors

# Poco::Net

# class SecureServerSocket

Library: NetSSL_OpenSSL
Package: SSLSockets
Header: Poco/Net/SecureServerSocket.h

## Description

A server socket for secure SSL connections.

## Inheritance

Direct Base Classes: ServerSocket

All Base Classes: ServerSocket, Socket

## Member Summary

Member Functions: acceptConnection, context, operator =

Inherited Functions: acceptConnection, address, available, bind, bind6, close, getBlocking, getKeepAlive, getLinger, getNoDelay, getOOBInline, getOption, getReceiveBufferSize, getReceiveTimeout, getReuseAddress, getReusePort, getSendBufferSize, getSendTimeout, impl, init, listen, operator !=, operator <, operator <=, operator =, operator ==, operator >, operator >=, peerAddress, poll, secure, select, setBlocking, setKeepAlive, setLinger, setNoDelay, setOOBInline, setOption, setReceiveBufferSize, setReceiveTimeout, setReuseAddress, setReusePort, setSendBufferSize, setSendTimeout, sockfd, supportsIPv4, supportsIPv6

## Constructors

### SecureServerSocket

SecureServerSocket();

Creates a SSL server socket using the default SSL server context.

The server socket must be bound to an address and put into listening state.

### SecureServerSocket

explicit SecureServerSocket(
Context::Ptr pContext
);

Creates a SSL server socket, using the given SSL context object.

The server socket must be bound to an address and put into listening state.

### SecureServerSocket

SecureServerSocket(
const Socket & socket
);

Creates the SecureServerSocket with the SocketImpl from another socket. The SocketImpl must be a SecureServerSocketImpl, otherwise an InvalidArgumentException will be thrown.

### SecureServerSocket

SecureServerSocket(
const SocketAddress & address,
int backlog = 64
);

Creates a server socket using the default server SSL context, binds it to the given address and puts it in listening state.

After successful construction, the server socket is ready to accept connections.

### SecureServerSocket

SecureServerSocket(
Poco::UInt16 port,
int backlog = 64
);

Creates a server socket using the default server SSL context, binds it to the given port and puts it in listening state.

After successful construction, the server socket is ready to accept connections.

### SecureServerSocket

SecureServerSocket(
const SocketAddress & address,
int backlog,
Context::Ptr pContext
);

Creates a server socket using the given SSL context, binds it to the given address and puts it in listening state.

After successful construction, the server socket is ready to accept connections.

### SecureServerSocket

SecureServerSocket(
Poco::UInt16 port,
int backlog,
Context::Ptr pContext
);

Creates a server socket using the given SSL context, binds it to the given port and puts it in listening state.

After successful construction, the server socket is ready to accept connections.

## Destructor

### ~SecureServerSocket

virtual ~SecureServerSocket();

Destroys the StreamSocket.

## Member Functions

### acceptConnection

StreamSocket acceptConnection(
SocketAddress & clientAddr
);

Get the next completed connection from the socket's completed connection queue.

If the queue is empty, waits until a connection request completes.

Returns a new SSL socket for the connection with the client.

The client socket's address is returned in clientAddr.

No SSL handshake is performed on the new connection. The SSL handshake will be performed the first time sendBytes(), receiveBytes() or completeHandshake() is called on the returned SecureStreamSocket.

See also: Poco::Net::ServerSocket::acceptConnection()

### acceptConnection

StreamSocket acceptConnection();

Get the next completed connection from the socket's completed connection queue.

If the queue is empty, waits until a connection request completes.

Returns a new SSL socket for the connection with the client.

No SSL handshake is performed on the new connection. The SSL handshake will be performed the first time sendBytes(), receiveBytes() or completeHandshake() is called on the returned SecureStreamSocket.

See also: Poco::Net::ServerSocket::acceptConnection()

### context

Context::Ptr context() const;

Returns the SSL context used by this socket.

### operator =

SecureServerSocket & operator = (
const Socket & socket
);

Assignment operator.

Releases the socket's SocketImpl and attaches the SocketImpl from the other socket and increments the reference count of the SocketImpl.