docs/modbus_tcp_pi_accept.md

   1 # modbus_tcp_pi_accept
   2
   3 ## Name
   4
   5 modbus_tcp_pi_accept - accept a new connection on a TCP PI Modbus socket (IPv6)
   6
   7 ## Synopsis
   8
   9 ```c
  10 int modbus_tcp_pi_accept(modbus_t *ctx, int *s);
  11 ```
  12
  13 ## Description
  14
  15 The *modbus_tcp_pi_accept()* function shall extract the first connection on the
  16 queue of pending connections, create a new socket and store it in libmodbus
  17 context given in argument. If available, `accept4()` with `SOCK_CLOEXEC` will be
  18 called instead of `accept()`.
  19
  20 ## Return value
  21
  22 The function shall return a new socket if successful.
  23 Otherwise it shall return -1 and set errno.
  24
  25 ## Example
  26
  27 For detailed example, see unit-test-server.c source file in tests directory.
  28
  29 ```c
  30 ...
  31
  32 ctx = modbus_new_tcp_pi("::0", 502);
  33 s = modbus_tcp_pi_listen(ctx, 1);
  34 modbus_tcp_pi_accept(ctx, &s);
  35
  36 ...
  37
  38 close(s)
  39 modbus_free(ctx);
  40 ```
  41
  42 ## See also
  43
  44 - [modbus_tcp_pi_accept](modbus_tcp_pi_accept.md)
  45 - [modbus_tcp_listen](modbus_tcp_listen.md)
  46 - [modbus_tcp_pi_listen](modbus_tcp_pi_listen.md)