/**\r
Receive data from a network connection and return the remote system's address.\r
\r
- The ::recvfrom routine waits for receive data from a remote network\r
- connection. The\r
+ The recvfrom routine waits for receive data from a remote network\r
+ connection. This routine is typically called for SOCK_DGRAM sockets\r
+ when the socket is being shared by multiple remote systems and it is\r
+ important to get the remote system address for a response.\r
+\r
+ The\r
<a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/recv.html">POSIX</a>\r
documentation is available online.\r
\r
\r
@param [in] address_len Length of the remote network address structure\r
\r
- @return ::recvfrom returns the number of valid bytes in the buffer,\r
+ @return This routine returns the number of valid bytes in the buffer,\r
zero if no data was received, and -1 when an error occurs.\r
- In the case of an error, errno contains more details.\r
+ In the case of an error, ::errno contains more details.\r
\r
**/\r
ssize_t\r