ioctlsocket

#include <rtl.h>

int ioctlsocket (
    int sock,              /* Socket descriptor */
    long cmd,              /* A command to perform */
    unsigned long *argp);  /* Pointer to a parameter */

The ioctlsocket function controls the I/O mode of a socket. It can be used on any socket in any state to set or retrieve some operating parameters of the socket.

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

The argument cmd specifies a command to perform on a socket. The following commands are supported:

The argument argp specifies a pointer to the command's parameter.

For the command FIONBIO the argument values are:

For the command FIO_DELAY_ACK the argument values are:

For the command FIO_KEEP_ALIVE the argument values are:

For the command FIO_FLOW_CTRL the argument values are:

The ioctlsocket 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.
• In RTX environment the blocking mode is enabled by default.

The ioctlsocket function returns the following result:

• SCK_SUCCESS
  The function call is successful.
• SCK_EINVALID
  The socket identified with sock is invalid.
• SCK_EINVALIDPARA
  The function parameters are invalid or not supported.
• SCK_ERROR
  The socket is not created.

accept, connect, recv, recvfrom

#include <rtl.h>

__task void server (void) {
  int sock,res;
  unsigned long sck_mode;

  sock = socket (AF_INET, SOCK_STREAM, IPPROTO_TCP);

  /* 0= blocking, 1= non-blocking */
  sck_mode = 1;
  res = ioctlsocket (sock, FIONBIO, &sck_mode);
  if (res == SCK_SUCCESS) {
    printf ("Nonblocking mode enabled.\n");
  }
  else {
    printf ("ioctlsocket() error\n!");
  }
  ..
}