recv

#include <rtl.h>

int recv (
    int sock,          /* Socket descriptor */
    char *buf,         /* Pointer to a buffer for data */
    int len,           /* Size of data buffer in bytes */
    int flags);        /* Message flags */

The recv function receives incoming data that has been queued for the socket. This function can be used with both SOCK_STREAM and SOCK_DGRAM type sockets. It reads as much information as currently available up to the size of the buffer specified.

In blocking mode, which is enabled if the system detects RTX environment, this functions waits for received data. In non blocking mode, you must call the recv function again if the error code SCK_EWOULDBLOCK is returned.

The argument sock specifies a socket descriptor returned from a previous call to socket.

The argument buf is a pointer to the application data buffer for storing the data to. If the available data is too large to fit in the supplied application buffer buf, excess bytes are discarded in case of SOCK_DGRAM sockets. For socket types SOCK_STREAM, the data is buffered internally so the application can retrieve all data by multiple calls of recv function.

The argument len specifies the size of the application data buffer.

The argument flags specifies the message flags:

The recv function is in the RL-TCPnet library. The prototype is defined in rtl.h.

note

• You must call the socket function before any other function calls to the BSD socket.
• If a negative number is returned, it represents an error code.
• The number of bytes actually read can be less than len.

The recv function returns the following result:

• numbytes
  The number of bytes copied to application buffer buf (a positive number).
• SCK_EINVALID
  The socket identified with sock is invalid, or in invalid state.
• SCK_ECLOSED
  Remote end point has closed the connection.
• SCK_EWOULDBLOCK
  The function would block, and the socket is set to non blocking mode.
• SCK_ETIMEOUT
  The function wait for data timeout has expired in blocking mode.
• SCK_ELOCKED
  The socket is locked by another task in RTX environment.

ioctlsocket, recvfrom, send, sendto

#include <rtl.h>

__task void server (void *argv) {
  /* Server task runs in 2 instances. */
  SOCKADDR_IN addr;
  int sock, sd, res;
  int type = (int)argv;
  char dbuf[4];

  while (1) {
    sock = socket (AF_INET, type, 0);

    addr.sin_port        = htons(1001);
    addr.sin_family      = PF_INET;
    addr.sin_addr.s_addr = INADDR_ANY;

    bind (sock, (SOCKADDR *)&addr, sizeof(addr));

    if (type == SOCK_STREAM) {
      listen (sock, 1);
      sd = accept (sock, NULL, NULL);
      closesocket (sock);
      sock = sd;
    }

    while (1) {
      res = recv (sock, dbuf, sizeof (dbuf), 0);
      if (res <= 0) {
        break;
      }
      procrec ((U8 *)dbuf);
    }
    closesocket (sock);
  }
}