AF_INET AF_INET6 AF_SUPPORTED AF_UNSPEC fnet_address_family_t FNET_HTONL fnet_htonl FNET_HTONS fnet_htons fnet_inet_aton fnet_inet_ntoa fnet_inet_ntop fnet_inet_pton fnet_inet_ptos FNET_IP4_ADDR_INIT FNET_IP4_ADDR_STR_SIZE fnet_ip4_addr_t FNET_IP6_ADDR_STR_SIZE FNET_IP_ADDR_STR_SIZE fnet_msg_flags_t FNET_NTOHL fnet_ntohl FNET_NTOHS fnet_ntohs fnet_protocol_t FNET_SA_DATA_SIZE fnet_scope_id_t fnet_sd_flags_t fnet_socket fnet_socket_accept fnet_socket_addr_are_equal fnet_socket_addr_is_multicast fnet_socket_addr_is_unspecified fnet_socket_bind fnet_socket_close fnet_socket_connect fnet_socket_getname fnet_socket_getopt fnet_socket_getpeername fnet_socket_listen fnet_socket_options_t fnet_socket_recv fnet_socket_recvfrom fnet_socket_send fnet_socket_sendto fnet_socket_set_callback_on_rx fnet_socket_setopt fnet_socket_shutdown fnet_socket_state_t fnet_socket_t fnet_socket_type_t INADDR_ANY INADDR_BROADCAST

fnet_return_t fnet_socket_listen ( fnet_socket_t  s, fnet_size_t  backlog  ) Places the socket into a state, where it is listening for an incoming connection. Parameters s Descriptor identifying a socket that will be used for listening. backlog Maximum length of the queue of pending connections. Returns This function returns: FNET_OK if no error occurs. FNET_ERR if an error occurs. The specific error code can be retrieved using the fnet_error_get(). See also fnet_socket(), fnet_socket_bind(), fnet_socket_accept() Only connection-oriented sockets (SOCK_STREAM) are used with the fnet_socket_listen(). The socket is put into passive mode, where the incoming connection requests are acknowledged and queued pending acceptance by the listening socket. The fnet_socket_listen() function is typically used by servers that can have more than one connection request at a time. An application can call fnet_socket_listen() more than once on the same socket. If there are more pending connections than the new backlog value, the excess pending connections will be reset and dropped. Once pending connections accepted by application using fnet_socket_accept(), they are removed from backlog.