4  * SPDX-License-Identifier: Apache-2.0
36 static inline int32_t timeout_to_int32(k_timeout_t timeout)  in timeout_to_int32()  argument
38 	if (K_TIMEOUT_EQ(timeout, K_NO_WAIT)) {  in timeout_to_int32()
40 	} else if (K_TIMEOUT_EQ(timeout, K_FOREVER)) {  in timeout_to_int32()
41 		return -1;  in timeout_to_int32()
43 		return k_ticks_to_ms_floor32(timeout.ticks);  in timeout_to_int32()
82 		       int32_t timeout,
91 		      int32_t timeout,
95 	 * This function is called when user wants to send data to peer host.
99 		    int32_t timeout,
103 	 * This function is called when user wants to send data to peer host.
109 		      int32_t timeout,
113 	 * This function is called when user wants to receive data from peer
118 		    int32_t timeout,
131  * 5-tuple (protocol, remote address, remote port, source
152 	NET_ASSERT(net_if_offload(iface)->get);  in net_offload_get()
154 	return net_if_offload(iface)->get(family, type, ip_proto, context);  in net_offload_get()
177 	NET_ASSERT(net_if_offload(iface)->bind);  in net_offload_bind()
179 	return net_if_offload(iface)->bind(context, addr, addrlen);  in net_offload_bind()
200 	NET_ASSERT(net_if_offload(iface)->listen);  in net_offload_listen()
202 	return net_if_offload(iface)->listen(context, backlog);  in net_offload_listen()
210  *                   connection is established, the user-supplied callback (cb)
211  *                   is executed. cb is called even if the timeout was set to
212  *                   K_FOREVER. cb is not called if the timeout expires.
223  * @param timeout    The timeout value for the connection. Possible values:
228  * @param user_data  Data passed to the callback function.
231  * @return           -EINVAL if an invalid parameter is passed as an argument.
232  * @return           -ENOTSUP if the operation is not supported or implemented.
239 				      k_timeout_t timeout,  in net_offload_connect()  argument
244 	NET_ASSERT(net_if_offload(iface)->connect);  in net_offload_connect()
246 	return net_if_offload(iface)->connect(  in net_offload_connect()
248 		timeout_to_int32(timeout),  in net_offload_connect()
256  * will return immediately if the timeout is set to K_NO_WAIT.
260  * If the timeout is set to K_FOREVER, the function will wait
261  * until the connection is established. Timeout value > 0, will wait as
263  * After the connection is established a caller-supplied callback is called.
264  * The callback is called even if timeout was set to K_FOREVER, the
266  * The callback is not called if the timeout expires.
272  * @param cb Caller-supplied callback function.
273  * @param timeout Timeout for the connection. Possible values
275  * @param user_data Caller-supplied user data.
282 				     k_timeout_t timeout,  in net_offload_accept()  argument
287 	NET_ASSERT(net_if_offload(iface)->accept);  in net_offload_accept()
289 	return net_if_offload(iface)->accept(  in net_offload_accept()
291 		timeout_to_int32(timeout),  in net_offload_accept()
298  * @details This function can be used to send network data to a peer
299  * connection. This function will return immediately if the timeout
300  * is set to K_NO_WAIT. If the timeout is set to K_FOREVER, the function
301  * will wait until the network packet is sent. Timeout value > 0 will
303  * a caller-supplied callback is called. The callback is called even
304  * if timeout was set to K_FOREVER, the callback is called
306  * called if the timeout expires. For context of type SOCK_DGRAM,
314  * @param cb Caller-supplied callback function.
315  * @param timeout Timeout for the connection. Possible values
317  * @param user_data Caller-supplied user data.
324 				   k_timeout_t timeout,  in net_offload_send()  argument
329 	NET_ASSERT(net_if_offload(iface)->send);  in net_offload_send()
331 	return net_if_offload(iface)->send(  in net_offload_send()
333 		timeout_to_int32(timeout),  in net_offload_send()
340  * @details This function can be used to send network data to a peer
343  * if the timeout is set to K_NO_WAIT. If the timeout is set to K_FOREVER,
344  * the function will wait until the network packet is sent. Timeout
346  * is sent, a caller-supplied callback is called. The callback is called
347  * even if timeout was set to K_FOREVER, the callback is called
349  * timeout expires.
358  * @param cb Caller-supplied callback function.
359  * @param timeout Timeout for the connection. Possible values
361  * @param user_data Caller-supplied user data.
370 				     k_timeout_t timeout,  in net_offload_sendto()  argument
375 	NET_ASSERT(net_if_offload(iface)->sendto);  in net_offload_sendto()
377 	return net_if_offload(iface)->sendto(  in net_offload_sendto()
379 		timeout_to_int32(timeout),  in net_offload_sendto()
384  * @brief Receive network data from a peer specified by context.
387  * that is called by the network stack when network data has been received
389  * is no need to call this function multiple times if timeout is set to
391  * If callback function or user data changes, then the function can be called
393  * This function will return immediately if the timeout is set to K_NO_WAIT.
394  * If the timeout is set to K_FOREVER, the function will wait until the
395  * network packet is received. Timeout value > 0 will wait as many ms.
396  * After the network packet is received, a caller-supplied callback is
397  * called. The callback is called even if timeout was set to K_FOREVER,
399  * The callback is not called if the timeout expires. The timeout functionality
402  * used. If CONFIG_NET_CONTEXT_SYNC_RECV is not set, then the timeout parameter
409  * @param cb Caller-supplied callback function.
410  * @param timeout Caller-supplied timeout. Possible values
412  * @param user_data Caller-supplied user data.
419 				   k_timeout_t timeout,  in net_offload_recv()  argument
424 	NET_ASSERT(net_if_offload(iface)->recv);  in net_offload_recv()
426 	return net_if_offload(iface)->recv(  in net_offload_recv()
428 		timeout_to_int32(timeout),  in net_offload_recv()
436  * send or receive data via this context after this call.
450 	NET_ASSERT(net_if_offload(iface)->put);  in net_offload_put()
452 	return net_if_offload(iface)->put(context);  in net_offload_put()
488 				      k_timeout_t timeout,
497 				     k_timeout_t timeout,
506 				   k_timeout_t timeout,
517 				     k_timeout_t timeout,
526 				   k_timeout_t timeout,