/**\r
Establish the known port to listen for network connections.\r
\r
- The ::listen routine places the port into a state that enables connection\r
+ The listen routine places the port into a state that enables connection\r
attempts. Connections are placed into FIFO order in a queue to be serviced\r
by the application. The application calls the ::accept routine to remove\r
- the next connection from the queue and get the associated socket. The\r
+ the next connection from the queue and get the associated socket.\r
+\r
+ The\r
<a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/listen.html">POSIX</a>\r
- documentation for the bind routine is available online for reference.\r
+ documentation is available online.\r
\r
@param [in] s Socket file descriptor returned from ::socket.\r
\r
@param [in] backlog backlog specifies the maximum FIFO depth for the connections\r
- waiting for the application to call accept. Connection attempts\r
+ waiting for the application to call ::accept. Connection attempts\r
received while the queue is full are refused.\r
\r
- @returns The listen routine returns zero (0) if successful and -1 upon failure.\r
+ @return This routine returns zero (0) if successful or -1 when an error occurs.\r
+ In the case of an error, ::errno contains more details.\r
\r
**/\r
int\r