aboutsummaryrefslogtreecommitdiff
path: root/docs/doxygen/nel/listen__sock_8cpp-source.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/doxygen/nel/listen__sock_8cpp-source.html')
-rw-r--r--docs/doxygen/nel/listen__sock_8cpp-source.html245
1 files changed, 245 insertions, 0 deletions
diff --git a/docs/doxygen/nel/listen__sock_8cpp-source.html b/docs/doxygen/nel/listen__sock_8cpp-source.html
new file mode 100644
index 00000000..bee903e5
--- /dev/null
+++ b/docs/doxygen/nel/listen__sock_8cpp-source.html
@@ -0,0 +1,245 @@
+<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
+<HTML>
+<HEAD>
+ <TITLE>nevrax.org : docs</TITLE>
+ <LINK REL=stylesheet TYPE="text/css" HREF="http://www.nevrax.org/inc/css/nevrax.css">
+ <link href="doxygen.css" rel="stylesheet" type="text/css">
+</HEAD>
+<BODY MARGINHEIGHT="0" MARGINWIDTH="0">
+
+<!-- uplinks -->
+<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
+ <TR>
+ <TD WIDTH=16><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD WIDTH=140 BGCOLOR=#dddddd><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="140" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD WIDTH=16><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD><IMG width=6 height=14 SRC="http://www.nevrax.org/inc/img/reddots.gif" ALT="#" VSPACE=2 HSPACE=2 BORDER=0 ></TD><TD VALIGN=middle>&nbsp;<A CLASS=uplinks HREF=http://www.nevrax.org><b>Home</B></FONT></A>&nbsp;&nbsp;&nbsp;</TD>
+ <TD><IMG width=6 height=14 SRC="http://www.nevrax.org/inc/img/reddots.gif" ALT="#" VSPACE=2 HSPACE=2 BORDER=0 ></TD><TD VALIGN=middle>&nbsp;<A CLASS=uplinks HREF=http://www.nevrax.com><b>nevrax.com</B></FONT></A>&nbsp;&nbsp;&nbsp;</TD>
+ </TR>
+</TABLE>
+
+<!-- banner Nevrax -->
+<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0 WIDTH=100%>
+ <TR><TD BGCOLOR="#000000" BACKGROUND="http://www.nevrax.org/inc/img/black_banner.jpg"><A HREF="http://www.nevrax.org"><IMG SRC="http://www.nevrax.org/inc/img/nevrax.gif" WIDTH="170" HEIGHT="45" BORDER=0 ALT="Nevrax" ></A></TD></TR>
+</TABLE>
+
+<!-- main table -->
+<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0 height=100%>
+ <TR>
+ <TD WIDTH=16><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="10" BORDER=0 ALT=""></TD>
+ <TD WIDTH=140 BGCOLOR=#dddddd VALIGN=TOP ALIGN=middle><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="140" HEIGHT="10" BORDER=0 ALT="">
+
+ <!------ Begin Box ------>
+ <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=black><TR><TD><TABLE border=0 cellspacing=2 cellpadding=0 width=120><tr><TD ALIGN=middle bgcolor=black>
+ <FONT COLOR=white FACE="sans-serif"><B>Nevrax.org</B></FONT></TD></TR><tr><td colspan=2 bgcolor=#FFFFFF>
+ <TABLE cellspacing=0 cellpadding=1 border=0>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/news/" TITLE="Rubrique news"><img width=13 height=15 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-news.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/news/" TITLE="News">News</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/mail/" TITLE="Rubrique mail"><img width=15 height=11 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-mail.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/mail/" TITLE="Mailing list archive">Mailing-list</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/docs/" TITLE="Rubrique docs"><img width=14 height=16 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-docs.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/docs/" TITLE="Documentation">Documentation</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/cvs/" TITLE="Rubrique cvs"><img width=13 height=17 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-cvs.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/cvs/" TITLE="CVS Web">CVS</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/bugs/" TITLE="Rubrique bugs"><img width=20 height=16 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-bugs.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/bugs/" TITLE="Bugtracking">Bugs</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/GPL.php3" TITLE="Rubrique license"><img width=18 height=12 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-gpl.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/GPL.php3" TITLE="License">License</a></td></tr>
+ </TABLE>
+ </TD></TR></TABLE></TD></TR></TABLE>
+ <!------ End Box ------>
+
+ </TD>
+ <TD WIDTH=15><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD ALIGN=left valign=top><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="140" HEIGHT="10" BORDER=0 ALT="">
+
+<!-- title -->
+<TABLE background="http://www.nevrax.org/inc/img/redline.gif" CELLSPACING=0 CELLPADDING=0 BORDER=0 width=100%><tr><td>
+<A HREF="http://www.nevrax.org/docs/"><img src="http://www.nevrax.org/inc/img/t_docs.gif" ALT="Docs" HEIGHT=20 BORDER=0></A>
+</td><td><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="1" HEIGHT="1" BORDER=0 ALT="">
+</td></tr></table>
+&nbsp;
+
+<!-- block -->
+<TABLE bgcolor="#dddddd" CELLSPACING=0 CELLPADDING=0 BORDER=0 width=100%><tr><td width=1% valign=middle><img width=6 height=14 hspace=2 vspace=2 src="http://www.nevrax.org/inc/img/reddots.gif"></TD>
+ <TD><B>Documentation</B></TD>
+ <TD ALIGN=RIGHT>&nbsp;</td>
+</tr></table>
+<!-- Generated by Doxygen 1.2.14 -->
+<center>
+<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="namespaces.html">Namespace List</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="namespacemembers.html">Namespace Members</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; <a class="qindex" href="pages.html">Related Pages</a> &nbsp; <a class="qindexRef" doxygen="_cgi:http://www.nevrax.org/cgi-bin/nel-search.cgi" href="http://www.nevrax.org/cgi-bin/nel-search.cgi">Search</a> &nbsp; </center>
+<hr><h1>listen_sock.cpp</h1><a href="listen__sock_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><pre>00001
+00007 <font class="comment">/* Copyright, 2000 Nevrax Ltd.</font>
+00008 <font class="comment"> *</font>
+00009 <font class="comment"> * This file is part of NEVRAX NEL.</font>
+00010 <font class="comment"> * NEVRAX NEL is free software; you can redistribute it and/or modify</font>
+00011 <font class="comment"> * it under the terms of the GNU General Public License as published by</font>
+00012 <font class="comment"> * the Free Software Foundation; either version 2, or (at your option)</font>
+00013 <font class="comment"> * any later version.</font>
+00014 <font class="comment"></font>
+00015 <font class="comment"> * NEVRAX NEL is distributed in the hope that it will be useful, but</font>
+00016 <font class="comment"> * WITHOUT ANY WARRANTY; without even the implied warranty of</font>
+00017 <font class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</font>
+00018 <font class="comment"> * General Public License for more details.</font>
+00019 <font class="comment"></font>
+00020 <font class="comment"> * You should have received a copy of the GNU General Public License</font>
+00021 <font class="comment"> * along with NEVRAX NEL; see the file COPYING. If not, write to the</font>
+00022 <font class="comment"> * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,</font>
+00023 <font class="comment"> * MA 02111-1307, USA.</font>
+00024 <font class="comment"> */</font>
+00025
+00026 <font class="preprocessor">#include "<a class="code" href="stdnet_8h.html">stdnet.h</a>"</font>
+00027
+00028 <font class="preprocessor">#include "<a class="code" href="listen__sock_8h.html">nel/net/listen_sock.h</a>"</font>
+00029
+00030 <font class="preprocessor">#ifdef NL_OS_WINDOWS</font>
+00031 <font class="preprocessor"></font>
+00032 <font class="preprocessor">#include &lt;winsock2.h&gt;</font>
+00033 <font class="keyword">typedef</font> <a class="code" href="types__nl_8h.html#a13">sint</a> socklen_t;
+00034
+00035 <font class="preprocessor">#elif defined NL_OS_UNIX</font>
+00036 <font class="preprocessor"></font>
+00037 <font class="preprocessor">#include &lt;<a class="code" href="unistd_8h.html">unistd.h</a>&gt;</font>
+00038 <font class="preprocessor">#include &lt;sys/types.h&gt;</font>
+00039 <font class="preprocessor">#include &lt;sys/socket.h&gt;</font>
+00040 <font class="preprocessor">#include &lt;netinet/in.h&gt;</font>
+00041 <font class="preprocessor">#include &lt;arpa/inet.h&gt;</font>
+00042 <font class="preprocessor">#include &lt;netdb.h&gt;</font>
+00043 <font class="preprocessor">#include &lt;errno.h&gt;</font>
+00044 <font class="preprocessor">#include &lt;fcntl.h&gt;</font>
+00045 <font class="preprocessor">#define SOCKET_ERROR -1</font>
+00046 <font class="preprocessor"></font><font class="preprocessor">#define INVALID_SOCKET -1</font>
+00047 <font class="preprocessor"></font><font class="keyword">typedef</font> <font class="keywordtype">int</font> SOCKET;
+00048
+00049 <font class="preprocessor">#endif</font>
+00050 <font class="preprocessor"></font>
+00051
+00052 <font class="keyword">using</font> <font class="keyword">namespace </font>std;
+00053
+00054
+00055 <font class="keyword">namespace </font>NLNET
+00056 {
+00057
+00058
+00059 <font class="comment">/*</font>
+00060 <font class="comment"> * Constructor</font>
+00061 <font class="comment"> */</font>
+<a name="l00062"></a><a class="code" href="classNLNET_1_1CListenSock.html#a0">00062</a> CListenSock::CListenSock() : CTcpSock(), _Bound( false )
+00063 {
+00064 <font class="comment">// Create socket</font>
+00065 <a class="code" href="classNLNET_1_1CSock.html#b2">createSocket</a>( SOCK_STREAM, IPPROTO_TCP );
+00066
+00068 <a class="code" href="classNLNET_1_1CListenSock.html#z341_2">setBacklog</a>( -1 );
+00069 }
+00070
+00071
+00072 <font class="comment">/*</font>
+00073 <font class="comment"> * Prepares to receive connections on a specified port</font>
+00074 <font class="comment"> */</font>
+<a name="l00075"></a><a class="code" href="classNLNET_1_1CListenSock.html#z341_0">00075</a> <font class="keywordtype">void</font> CListenSock::init( <a class="code" href="types__nl_8h.html#a8">uint16</a> port )
+00076 {
+00077 <font class="comment">// Use any address</font>
+00078 CInetAddress localaddr; <font class="comment">// By default, INETADDR_ANY (useful for gateways that have several ip addresses)</font>
+00079 localaddr.setPort( port );
+00080 <a class="code" href="classNLNET_1_1CListenSock.html#z341_0">init</a>( localaddr );
+00081
+00082 <font class="comment">// Now set the address visible from outside</font>
+00083 <a class="code" href="classNLNET_1_1CSock.html#n1">_LocalAddr</a> = CInetAddress::localHost();
+00084 <a class="code" href="classNLNET_1_1CSock.html#n1">_LocalAddr</a>.setPort( port );
+00085 <a class="code" href="debug_8h.html#a0">nldebug</a>( <font class="stringliteral">"LNETL0: Socket %d listen socket is at %s"</font>, <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, <a class="code" href="classNLNET_1_1CSock.html#n1">_LocalAddr</a>.asString().c_str() );
+00086 }
+00087
+00088
+00089 <font class="comment">/*</font>
+00090 <font class="comment"> * Prepares to receive connections on a specified address/port (useful when the host has several addresses)</font>
+00091 <font class="comment"> */</font>
+<a name="l00092"></a><a class="code" href="classNLNET_1_1CListenSock.html#z341_1">00092</a> <font class="keywordtype">void</font> CListenSock::init( <font class="keyword">const</font> CInetAddress&amp; addr )
+00093 {
+00094 <font class="keywordflow">if</font> ( ! addr.isValid() )
+00095 {
+00096 <a class="code" href="debug_8h.html#a0">nldebug</a>( <font class="stringliteral">"LNETL0: Binding listen socket to any address, port %hu"</font>, addr.port() );
+00097 }
+00098
+00099 <font class="preprocessor">#ifndef NL_OS_WINDOWS</font>
+00100 <font class="preprocessor"></font> <font class="comment">// Set Reuse Address On (does not work on Win98 and is useless on Win2000)</font>
+00101 <font class="keywordtype">int</font> value = <font class="keyword">true</font>;
+00102 <font class="keywordflow">if</font> ( setsockopt( <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, SOL_SOCKET, SO_REUSEADDR, &amp;value, <font class="keyword">sizeof</font>(value) ) == SOCKET_ERROR )
+00103 {
+00104 <font class="keywordflow">throw</font> ESocket( <font class="stringliteral">"ReuseAddr failed"</font> );
+00105 }
+00106 <font class="preprocessor">#endif</font>
+00107 <font class="preprocessor"></font>
+00108 <font class="comment">// Bind socket to port </font>
+00109 <font class="keywordflow">if</font> ( ::bind( <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, (<font class="keyword">const</font> sockaddr *)addr.sockAddr(), <font class="keyword">sizeof</font>(sockaddr_in) ) != 0 )
+00110 {
+00111 <font class="keywordflow">throw</font> ESocket( <font class="stringliteral">"Unable to bind listen socket to port"</font> );
+00112 }
+00113 <a class="code" href="classNLNET_1_1CSock.html#n1">_LocalAddr</a> = addr;
+00114 <a class="code" href="classNLNET_1_1CListenSock.html#o0">_Bound</a> = <font class="keyword">true</font>;
+00115
+00116 <font class="comment">// Listen</font>
+00117 <font class="keywordflow">if</font> ( ::listen( <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, <a class="code" href="classNLNET_1_1CListenSock.html#o1">_BackLog</a> ) != 0 ) <font class="comment">// SOMAXCONN = maximum length of the queue of pending connections</font>
+00118 {
+00119 <font class="keywordflow">throw</font> ESocket( <font class="stringliteral">"Unable to listen on specified port"</font> );
+00120 }
+00121 <font class="comment">// nldebug( "LNETL0: Socket %d listening at %s", _Sock, _LocalAddr.asString().c_str() );</font>
+00122 }
+00123
+00124
+00125 <font class="comment">/*</font>
+00126 <font class="comment"> * Accepts an incoming connection, and creates a new socket</font>
+00127 <font class="comment"> */</font>
+<a name="l00128"></a><a class="code" href="classNLNET_1_1CListenSock.html#a1">00128</a> CTcpSock *CListenSock::accept()
+00129 {
+00130 <font class="comment">// Accept connection</font>
+00131 sockaddr_in saddr;
+00132 socklen_t saddrlen = <font class="keyword">sizeof</font>(saddr);
+00133 SOCKET newsock = ::accept( <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, (sockaddr*)&amp;saddr, &amp;saddrlen );
+00134 <font class="keywordflow">if</font> ( newsock == INVALID_SOCKET )
+00135 {
+00136 <font class="comment">/*nlinfo( "LNETL0: Error accepting a connection");</font>
+00137 <font class="comment"> // See accept() man on Linux</font>
+00138 <font class="comment"> newsock = ::accept( _Sock, (sockaddr*)&amp;saddr, &amp;saddrlen );</font>
+00139 <font class="comment"> if ( newsock == INVALID_SOCKET )*/</font>
+00140 {
+00141 <font class="keywordflow">throw</font> ESocket( <font class="stringliteral">"Accept returned an invalid socket"</font>);
+00142 }
+00143 }
+00144
+00145 <font class="comment">// Construct and save a CTcpSock object</font>
+00146 CInetAddress addr;
+00147 addr.setSockAddr( &amp;saddr );
+00148 <a class="code" href="debug_8h.html#a0">nldebug</a>( <font class="stringliteral">"LNETL0: Socket %d accepted an incoming connection from %s, opening socket %d"</font>, <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, addr.asString().c_str(), newsock );
+00149 <a class="code" href="classNLNET_1_1CTcpSock.html#z352_0">CTcpSock</a> *connection = <font class="keyword">new</font> <a class="code" href="classNLNET_1_1CTcpSock.html#z352_0">CTcpSock</a>( newsock, addr );
+00150 <font class="keywordflow">return</font> connection;
+00151 }
+00152
+00153
+00154 <font class="comment">/*</font>
+00155 <font class="comment"> * Sets the number of the pending connections queue. -1 for the maximum possible value.</font>
+00156 <font class="comment"> */</font>
+<a name="l00157"></a><a class="code" href="classNLNET_1_1CListenSock.html#z341_2">00157</a> <font class="keywordtype">void</font> CListenSock::setBacklog( <a class="code" href="types__nl_8h.html#a13">sint</a> backlog )
+00158 {
+00159 <font class="keywordflow">if</font> ( <a class="code" href="classNLNET_1_1CListenSock.html#z341_3">backlog</a> == -1 )
+00160 {
+00161 <a class="code" href="classNLNET_1_1CListenSock.html#o1">_BackLog</a> = SOMAXCONN; <font class="comment">// SOMAXCONN = maximum length of the queue of pending connections</font>
+00162 }
+00163 <font class="keywordflow">else</font>
+00164 {
+00165 <a class="code" href="classNLNET_1_1CListenSock.html#o1">_BackLog</a> = <a class="code" href="classNLNET_1_1CListenSock.html#z341_3">backlog</a>;
+00166 }
+00167 <font class="keywordflow">if</font> ( _Bound )
+00168 {
+00169 <font class="keywordflow">if</font> ( ::listen( <a class="code" href="classNLNET_1_1CSock.html#n0">_Sock</a>, <a class="code" href="classNLNET_1_1CListenSock.html#o1">_BackLog</a> ) != 0 )
+00170 {
+00171 <font class="keywordflow">throw</font> ESocket( <font class="stringliteral">"Unable to listen on specified port, while changing backlog"</font> );
+00172 }
+00173 }
+00174 }
+00175
+00176
+00177 } <font class="comment">// NLNET</font>
+</pre></div>
+
+<!-- footer -->
+<BR><FONT Size=+5>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </FONT>
+</TD>
+<TD WIDTH=15><IMG SRC=http://www.nevrax.org/inc/img/pixel.gif WIDTH=15 HEIGHT=15 BORDER=0 ALT=""></TD>
+</TR>
+</TABLE>
+</BODY>
+</HTML>