<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Class Poco::Net::SecureServerSocket</title> <meta http-equiv="content-type" content="text/html; charset=utf-8"/> <meta name="author" content="Applied Informatics Software Engineering GmbH and Contributors"/> <meta name="publisher" content="Applied Informatics Software Engineering GmbH and Contributors"/> <meta name="copyright" content="Copyright (c) 2009, Applied Informatics Software Engineering GmbH and Contributors"/> <meta name="language" content="en"/> <meta name="date" content="2009-11-24"/> <meta name="generator" content="PocoDoc"/> <link rel="stylesheet" href="css/styles.css" type="text/css"/> </head> <body bgcolor="#ffffff" leftmargin="0" topmargin="0"> <div class="header"> <h1 class="namespace"><a href="Poco.Net.html" class="namespace">Poco::Net</a></h1> <h1 class="symbol">class SecureServerSocket</h1> </div> <div class="body"> <p> <b>Library:</b> NetSSL_OpenSSL<br /> <b>Package:</b> SSLSockets<br /> <b>Header:</b> Poco/Net/SecureServerSocket.h</p> <h2>Description</h2> <div class="description"> <p>A server socket for secure SSL connections. </p> </div> <h2>Inheritance</h2> <p><b>Direct Base Classes: </b><a href="Poco.Net.ServerSocket.html" title="class Poco::Net::ServerSocket">ServerSocket</a></p> <p><b>All Base Classes: </b><a href="Poco.Net.ServerSocket.html" title="class Poco::Net::ServerSocket">ServerSocket</a>, <a href="Poco.Net.Socket.html" title="class Poco::Net::Socket">Socket</a></p> <h2>Member Summary</h2> <p><b>Member Functions: </b><a href="Poco.Net.SecureServerSocket.html#16035" title="Poco::Net::SecureServerSocket::acceptConnection()">acceptConnection</a>, <a href="Poco.Net.SecureServerSocket.html#16038" title="Poco::Net::SecureServerSocket::context()">context</a>, <a href="Poco.Net.SecureServerSocket.html#16033" title="Poco::Net::SecureServerSocket::operator =()">operator =</a></p> <p><b>Inherited Functions: </b><a href="Poco.Net.ServerSocket.html#14958" title="Poco::Net::ServerSocket::acceptConnection()">acceptConnection</a>, <a href="Poco.Net.Socket.html#15077" title="Poco::Net::Socket::address()">address</a>, <a href="Poco.Net.Socket.html#15000" title="Poco::Net::Socket::available()">available</a>, <a href="Poco.Net.ServerSocket.html#14950" title="Poco::Net::ServerSocket::bind()">bind</a>, <a href="Poco.Net.Socket.html#14991" title="Poco::Net::Socket::close()">close</a>, <a href="Poco.Net.Socket.html#15076" title="Poco::Net::Socket::getBlocking()">getBlocking</a>, <a href="Poco.Net.Socket.html#15064" title="Poco::Net::Socket::getKeepAlive()">getKeepAlive</a>, <a href="Poco.Net.Socket.html#15056" title="Poco::Net::Socket::getLinger()">getLinger</a>, <a href="Poco.Net.Socket.html#15061" title="Poco::Net::Socket::getNoDelay()">getNoDelay</a>, <a href="Poco.Net.Socket.html#15073" title="Poco::Net::Socket::getOOBInline()">getOOBInline</a>, <a href="Poco.Net.Socket.html#15033" title="Poco::Net::Socket::getOption()">getOption</a>, <a href="Poco.Net.Socket.html#15006" title="Poco::Net::Socket::getReceiveBufferSize()">getReceiveBufferSize</a>, <a href="Poco.Net.Socket.html#15012" title="Poco::Net::Socket::getReceiveTimeout()">getReceiveTimeout</a>, <a href="Poco.Net.Socket.html#15067" title="Poco::Net::Socket::getReuseAddress()">getReuseAddress</a>, <a href="Poco.Net.Socket.html#15070" title="Poco::Net::Socket::getReusePort()">getReusePort</a>, <a href="Poco.Net.Socket.html#15003" title="Poco::Net::Socket::getSendBufferSize()">getSendBufferSize</a>, <a href="Poco.Net.Socket.html#15009" title="Poco::Net::Socket::getSendTimeout()">getSendTimeout</a>, <a href="Poco.Net.Socket.html#15079" title="Poco::Net::Socket::impl()">impl</a>, <a href="Poco.Net.ServerSocket.html#14956" title="Poco::Net::ServerSocket::listen()">listen</a>, <a href="Poco.Net.Socket.html#14981" title="Poco::Net::Socket::operator !=()">operator !=</a>, <a href="Poco.Net.Socket.html#14983" title="Poco::Net::Socket::operator <()">operator <</a>, <a href="Poco.Net.Socket.html#14985" title="Poco::Net::Socket::operator <=()">operator <=</a>, <a href="Poco.Net.ServerSocket.html#14948" title="Poco::Net::ServerSocket::operator =()">operator =</a>, <a href="Poco.Net.Socket.html#14979" title="Poco::Net::Socket::operator ==()">operator ==</a>, <a href="Poco.Net.Socket.html#14987" title="Poco::Net::Socket::operator >()">operator ></a>, <a href="Poco.Net.Socket.html#14989" title="Poco::Net::Socket::operator >=()">operator >=</a>, <a href="Poco.Net.Socket.html#15078" title="Poco::Net::Socket::peerAddress()">peerAddress</a>, <a href="Poco.Net.Socket.html#14997" title="Poco::Net::Socket::poll()">poll</a>, <a href="Poco.Net.Socket.html#14992" title="Poco::Net::Socket::select()">select</a>, <a href="Poco.Net.Socket.html#15074" title="Poco::Net::Socket::setBlocking()">setBlocking</a>, <a href="Poco.Net.Socket.html#15062" title="Poco::Net::Socket::setKeepAlive()">setKeepAlive</a>, <a href="Poco.Net.Socket.html#15053" title="Poco::Net::Socket::setLinger()">setLinger</a>, <a href="Poco.Net.Socket.html#15059" title="Poco::Net::Socket::setNoDelay()">setNoDelay</a>, <a href="Poco.Net.Socket.html#15071" title="Poco::Net::Socket::setOOBInline()">setOOBInline</a>, <a href="Poco.Net.Socket.html#15013" title="Poco::Net::Socket::setOption()">setOption</a>, <a href="Poco.Net.Socket.html#15004" title="Poco::Net::Socket::setReceiveBufferSize()">setReceiveBufferSize</a>, <a href="Poco.Net.Socket.html#15010" title="Poco::Net::Socket::setReceiveTimeout()">setReceiveTimeout</a>, <a href="Poco.Net.Socket.html#15065" title="Poco::Net::Socket::setReuseAddress()">setReuseAddress</a>, <a href="Poco.Net.Socket.html#15068" title="Poco::Net::Socket::setReusePort()">setReusePort</a>, <a href="Poco.Net.Socket.html#15001" title="Poco::Net::Socket::setSendBufferSize()">setSendBufferSize</a>, <a href="Poco.Net.Socket.html#15007" title="Poco::Net::Socket::setSendTimeout()">setSendTimeout</a>, <a href="Poco.Net.Socket.html#15084" title="Poco::Net::Socket::sockfd()">sockfd</a>, <a href="Poco.Net.Socket.html#15080" title="Poco::Net::Socket::supportsIPv4()">supportsIPv4</a>, <a href="Poco.Net.Socket.html#15081" title="Poco::Net::Socket::supportsIPv6()">supportsIPv6</a></p> <h2>Constructors</h2> <h3><a name="16013">SecureServerSocket</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>();</p> <div class="description"> <p>Creates a SSL server socket using the default SSL server context. </p> <p>The server socket must be bound to an address and put into listening state. </p> </div> <h3><a name="16014">SecureServerSocket</a></h3> <p class="decl">explicit <a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>(<br /> <a href="Poco.Net.Context.html#15711" title="Poco::Net::Context::Ptr">Context::Ptr</a> pContext<br />);</p> <div class="description"> <p>Creates a SSL server socket, using the given SSL context object. </p> <p>The server socket must be bound to an address and put into listening state. </p> </div> <h3><a name="16016">SecureServerSocket</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>(<br /> const <a href="Poco.Net.Socket.html" title="class Poco::Net::Socket">Socket</a> & socket<br />);</p> <div class="description"> <p>Creates the <a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a> with the <a href="Poco.Net.SocketImpl.html" title="class Poco::Net::SocketImpl">SocketImpl</a> from another socket. The <a href="Poco.Net.SocketImpl.html" title="class Poco::Net::SocketImpl">SocketImpl</a> must be a <a href="Poco.Net.SecureServerSocketImpl.html" title="class Poco::Net::SecureServerSocketImpl">SecureServerSocketImpl</a>, otherwise an <a href="Poco.InvalidArgumentException.html" title="class Poco::InvalidArgumentException">InvalidArgumentException</a> will be thrown. </p> </div> <h3><a name="16018">SecureServerSocket</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>(<br /> const <a href="Poco.Net.SocketAddress.html" title="class Poco::Net::SocketAddress">SocketAddress</a> & address,<br /> int backlog = 64<br />);</p> <div class="description"> <p>Creates a server socket using the default server SSL context, binds it to the given address and puts it in listening state. </p> <p>After successful construction, the server socket is ready to accept connections. </p> </div> <h3><a name="16025">SecureServerSocket</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>(<br /> <a href="Poco.html#11352" title="Poco::UInt16">Poco::UInt16</a> port,<br /> int backlog = 64<br />);</p> <div class="description"> <p>Creates a server socket using the default server SSL context, binds it to the given port and puts it in listening state. </p> <p>After successful construction, the server socket is ready to accept connections. </p> </div> <h3><a name="16021">SecureServerSocket</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>(<br /> const <a href="Poco.Net.SocketAddress.html" title="class Poco::Net::SocketAddress">SocketAddress</a> & address,<br /> int backlog,<br /> <a href="Poco.Net.Context.html#15711" title="Poco::Net::Context::Ptr">Context::Ptr</a> pContext<br />);</p> <div class="description"> <p>Creates a server socket using the given SSL context, binds it to the given address and puts it in listening state. </p> <p>After successful construction, the server socket is ready to accept connections. </p> </div> <h3><a name="16028">SecureServerSocket</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>(<br /> <a href="Poco.html#11352" title="Poco::UInt16">Poco::UInt16</a> port,<br /> int backlog,<br /> <a href="Poco.Net.Context.html#15711" title="Poco::Net::Context::Ptr">Context::Ptr</a> pContext<br />);</p> <div class="description"> <p>Creates a server socket using the given SSL context, binds it to the given port and puts it in listening state. </p> <p>After successful construction, the server socket is ready to accept connections. </p> </div> <h2>Destructor</h2> <h3><a name="16032">~SecureServerSocket</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl">virtual ~<a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a>();</p> <div class="description"> <p>Destroys the <a href="Poco.Net.StreamSocket.html" title="class Poco::Net::StreamSocket">StreamSocket</a>. </p> </div> <h2>Member Functions</h2> <h3><a name="16035">acceptConnection</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl"><a href="Poco.Net.StreamSocket.html" title="class Poco::Net::StreamSocket">StreamSocket</a> acceptConnection(<br /> <a href="Poco.Net.SocketAddress.html" title="class Poco::Net::SocketAddress">SocketAddress</a> & clientAddr<br />);</p> <div class="description"> <p>Get the next completed connection from the socket's completed connection queue. </p> <p>If the queue is empty, waits until a connection request completes. </p> <p>Returns a new SSL socket for the connection with the client. </p> <p>The client socket's address is returned in clientAddr. </p> <p>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 <a href="Poco.Net.SecureStreamSocket.html" title="class Poco::Net::SecureStreamSocket">SecureStreamSocket</a>. </p> </div> <div class="description"><p><b>See also:</b> <a href="Poco.Net.ServerSocket.html#14958" title="Poco::Net::ServerSocket::acceptConnection()">Poco::Net::ServerSocket::acceptConnection()</a></p></div> <h3><a name="16037">acceptConnection</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3> <p class="decl"><a href="Poco.Net.StreamSocket.html" title="class Poco::Net::StreamSocket">StreamSocket</a> acceptConnection();</p> <div class="description"> <p>Get the next completed connection from the socket's completed connection queue. </p> <p>If the queue is empty, waits until a connection request completes. </p> <p>Returns a new SSL socket for the connection with the client. </p> <p>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 <a href="Poco.Net.SecureStreamSocket.html" title="class Poco::Net::SecureStreamSocket">SecureStreamSocket</a>. </p> </div> <div class="description"><p><b>See also:</b> <a href="Poco.Net.ServerSocket.html#14960" title="Poco::Net::ServerSocket::acceptConnection()">Poco::Net::ServerSocket::acceptConnection()</a></p></div> <h3><a name="16038">context</a></h3> <p class="decl"><a href="Poco.Net.Context.html#15711" title="Poco::Net::Context::Ptr">Context::Ptr</a> context() const;</p> <div class="description"> <p>Returns the SSL context used by this socket. </p> </div> <h3><a name="16033">operator =</a></h3> <p class="decl"><a href="Poco.Net.SecureServerSocket.html" title="class Poco::Net::SecureServerSocket">SecureServerSocket</a> & operator = (<br /> const <a href="Poco.Net.Socket.html" title="class Poco::Net::Socket">Socket</a> & socket<br />);</p> <div class="description"> <p>Assignment operator. </p> <p>Releases the socket's <a href="Poco.Net.SocketImpl.html" title="class Poco::Net::SocketImpl">SocketImpl</a> and attaches the <a href="Poco.Net.SocketImpl.html" title="class Poco::Net::SocketImpl">SocketImpl</a> from the other socket and increments the reference count of the <a href="Poco.Net.SocketImpl.html" title="class Poco::Net::SocketImpl">SocketImpl</a>. </p> </div> <p class="footer">POCO C++ Libraries 1.3.6-all<br /> Copyright © 2009, <a href="http://pocoproject.org/" target="_blank">Applied Informatics Software Engineering GmbH and Contributors</a></p> </div> </body> </html>
