2014-01-14 00:11:01 +01:00
|
|
|
/****************************************************************************
|
2014-06-18 18:18:53 +02:00
|
|
|
* net/tcp/tcp_wrbuffer.c
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
* Copyright (C) 2007-2009, 2013-2014 Gregory Nutt. All rights reserved.
|
|
|
|
* Author: Gregory Nutt <gnutt@nuttx.org>
|
|
|
|
* Jason Jiang <jasonj@live.cn>
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
*
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in
|
|
|
|
* the documentation and/or other materials provided with the
|
|
|
|
* distribution.
|
|
|
|
* 3. Neither the name NuttX nor the names of its contributors may be
|
|
|
|
* used to endorse or promote products derived from this software
|
|
|
|
* without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Included Files
|
|
|
|
****************************************************************************/
|
|
|
|
|
2014-06-24 16:53:28 +02:00
|
|
|
#include <nuttx/net/netconfig.h>
|
2014-01-14 00:11:01 +01:00
|
|
|
#if defined(CONFIG_NET) && defined(CONFIG_NET_TCP) && defined(CONFIG_NET_TCP_WRITE_BUFFERS)
|
|
|
|
|
2016-06-11 22:14:08 +02:00
|
|
|
#if defined(CONFIG_DEBUG_FEATURES) && defined(CONFIG_NET_TCP_WRBUFFER_DEBUG)
|
2014-06-18 19:45:55 +02:00
|
|
|
/* Force debug output (from this file only) */
|
|
|
|
|
|
|
|
# undef CONFIG_DEBUG_NET
|
|
|
|
# define CONFIG_DEBUG_NET 1
|
|
|
|
#endif
|
|
|
|
|
2014-01-14 00:11:01 +01:00
|
|
|
#include <queue.h>
|
2014-06-22 19:27:57 +02:00
|
|
|
#include <string.h>
|
|
|
|
#include <assert.h>
|
2014-01-14 00:11:01 +01:00
|
|
|
#include <debug.h>
|
|
|
|
|
2017-10-04 23:22:27 +02:00
|
|
|
#include <nuttx/semaphore.h>
|
2015-01-28 18:56:11 +01:00
|
|
|
#include <nuttx/net/net.h>
|
2017-05-09 15:34:59 +02:00
|
|
|
#include <nuttx/mm/iob.h>
|
2014-06-25 02:12:49 +02:00
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
#include "tcp/tcp.h"
|
2014-01-14 00:11:01 +01:00
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Private Types
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/* Package all globals used by this logic into a structure */
|
|
|
|
|
|
|
|
struct wrbuffer_s
|
|
|
|
{
|
|
|
|
/* The semaphore to protect the buffers */
|
|
|
|
|
|
|
|
sem_t sem;
|
|
|
|
|
|
|
|
/* This is the list of available write buffers */
|
|
|
|
|
|
|
|
sq_queue_t freebuffers;
|
|
|
|
|
|
|
|
/* These are the pre-allocated write buffers */
|
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
struct tcp_wrbuffer_s buffers[CONFIG_NET_TCP_NWRBCHAINS];
|
2014-01-14 00:11:01 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Private Data
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/* This is the state of the global write buffer resource */
|
|
|
|
|
|
|
|
static struct wrbuffer_s g_wrbuffer;
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Public Functions
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
2017-04-22 00:33:14 +02:00
|
|
|
* Name: tcp_wrbuffer_initialize
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Initialize the list of free write buffers
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
* Called once early initialization.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2014-06-21 23:23:39 +02:00
|
|
|
void tcp_wrbuffer_initialize(void)
|
2014-01-14 00:11:01 +01:00
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
sq_init(&g_wrbuffer.freebuffers);
|
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
for (i = 0; i < CONFIG_NET_TCP_NWRBCHAINS; i++)
|
2014-01-14 00:11:01 +01:00
|
|
|
{
|
|
|
|
sq_addfirst(&g_wrbuffer.buffers[i].wb_node, &g_wrbuffer.freebuffers);
|
|
|
|
}
|
|
|
|
|
2017-10-03 20:51:15 +02:00
|
|
|
nxsem_init(&g_wrbuffer.sem, 0, CONFIG_NET_TCP_NWRBCHAINS);
|
2014-01-14 00:11:01 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
2017-04-22 00:33:14 +02:00
|
|
|
* Name: tcp_wrbuffer_alloc
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Allocate a TCP write buffer by taking a pre-allocated buffer from
|
|
|
|
* the free list. This function is called from TCP logic when a buffer
|
|
|
|
* of TCP data is about to sent
|
|
|
|
*
|
2018-02-01 17:00:02 +01:00
|
|
|
* Input Parameters:
|
2014-06-24 19:53:19 +02:00
|
|
|
* None
|
|
|
|
*
|
2014-01-14 00:11:01 +01:00
|
|
|
* Assumptions:
|
2015-01-28 18:56:11 +01:00
|
|
|
* Called from user logic with the network locked.
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
FAR struct tcp_wrbuffer_s *tcp_wrbuffer_alloc(void)
|
2014-01-14 00:11:01 +01:00
|
|
|
{
|
2014-06-22 19:27:57 +02:00
|
|
|
FAR struct tcp_wrbuffer_s *wrb;
|
2014-01-14 00:11:01 +01:00
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
/* We need to allocate two things: (1) A write buffer structure and (2)
|
|
|
|
* at least one I/O buffer to start the chain.
|
|
|
|
*
|
|
|
|
* Allocate the write buffer structure first then the IOBG. In order to
|
|
|
|
* avoid deadlocks, we will need to free the IOB first, then the write
|
|
|
|
* buffer
|
|
|
|
*/
|
|
|
|
|
2017-09-04 14:55:28 +02:00
|
|
|
DEBUGVERIFY(net_lockedwait(&g_wrbuffer.sem)); /* TODO: Handle EINTR. */
|
2014-06-22 19:27:57 +02:00
|
|
|
|
|
|
|
/* Now, we are guaranteed to have a write buffer structure reserved
|
|
|
|
* for us in the free list.
|
|
|
|
*/
|
2014-01-14 00:11:01 +01:00
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
wrb = (FAR struct tcp_wrbuffer_s *)sq_remfirst(&g_wrbuffer.freebuffers);
|
|
|
|
DEBUGASSERT(wrb);
|
|
|
|
memset(wrb, 0, sizeof(struct tcp_wrbuffer_s));
|
|
|
|
|
|
|
|
/* Now get the first I/O buffer for the write buffer structure */
|
|
|
|
|
2014-06-24 19:53:19 +02:00
|
|
|
wrb->wb_iob = iob_alloc(false);
|
2014-06-22 19:27:57 +02:00
|
|
|
if (!wrb->wb_iob)
|
2014-01-14 00:11:01 +01:00
|
|
|
{
|
2016-06-11 23:50:49 +02:00
|
|
|
nerr("ERROR: Failed to allocate I/O buffer\n");
|
2014-06-22 19:27:57 +02:00
|
|
|
tcp_wrbuffer_release(wrb);
|
2014-01-14 00:11:01 +01:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
return wrb;
|
2014-01-14 00:11:01 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
2017-04-22 00:33:14 +02:00
|
|
|
* Name: tcp_wrbuffer_release
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Release a TCP write buffer by returning the buffer to the free list.
|
2014-04-12 20:13:01 +02:00
|
|
|
* This function is called from user logic after it is consumed the
|
|
|
|
* buffered data.
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
* Assumptions:
|
2017-09-02 18:27:03 +02:00
|
|
|
* This function must be called with the network locked.
|
2014-01-14 00:11:01 +01:00
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2014-06-22 19:27:57 +02:00
|
|
|
void tcp_wrbuffer_release(FAR struct tcp_wrbuffer_s *wrb)
|
2014-01-14 00:11:01 +01:00
|
|
|
{
|
2014-06-22 19:27:57 +02:00
|
|
|
DEBUGASSERT(wrb && wrb->wb_iob);
|
|
|
|
|
|
|
|
/* To avoid deadlocks, we must following this ordering: Release the I/O
|
|
|
|
* buffer chain first, then the write buffer structure.
|
|
|
|
*/
|
|
|
|
|
|
|
|
iob_free_chain(wrb->wb_iob);
|
|
|
|
|
|
|
|
/* Then free the write buffer structure */
|
|
|
|
|
|
|
|
sq_addlast(&wrb->wb_node, &g_wrbuffer.freebuffers);
|
2017-10-03 23:35:24 +02:00
|
|
|
nxsem_post(&g_wrbuffer.sem);
|
2014-01-14 00:11:01 +01:00
|
|
|
}
|
|
|
|
|
2016-01-22 22:52:14 +01:00
|
|
|
/****************************************************************************
|
2017-04-22 00:33:14 +02:00
|
|
|
* Name: tcp_wrbuffer_test
|
2016-01-22 22:52:14 +01:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Check if there is room in the write buffer. Does not reserve any space.
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
* None.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
int tcp_wrbuffer_test(void)
|
|
|
|
{
|
|
|
|
int val = 0;
|
2017-10-03 20:51:15 +02:00
|
|
|
nxsem_getvalue(&g_wrbuffer.sem, &val);
|
2016-01-22 22:52:14 +01:00
|
|
|
return val > 0 ? OK : ERROR;
|
|
|
|
}
|
|
|
|
|
2014-01-14 22:17:53 +01:00
|
|
|
#endif /* CONFIG_NET && CONFIG_NET_TCP && CONFIG_NET_TCP_WRITE_BUFFERS */
|