This is an automated email from the ASF dual-hosted git repository.
xiaoxiang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
The following commit(s) were added to refs/heads/master by this push:
new d010744582 drivers/pipes: use circbuf to refine buffer model
d010744582 is described below
commit d01074458216f21bb62734de729c934c2e1dd1e5
Author: chao an <[email protected]>
AuthorDate: Tue Aug 8 12:48:40 2023 +0800
drivers/pipes: use circbuf to refine buffer model
Signed-off-by: chao an <[email protected]>
---
drivers/pipes/pipe.c | 7 +-
drivers/pipes/pipe_common.c | 170 ++++++++++----------------------------------
drivers/pipes/pipe_common.h | 27 ++++---
3 files changed, 52 insertions(+), 152 deletions(-)
diff --git a/drivers/pipes/pipe.c b/drivers/pipes/pipe.c
index 8f2c4e8ea2..61918b8f5e 100644
--- a/drivers/pipes/pipe.c
+++ b/drivers/pipes/pipe.c
@@ -285,7 +285,6 @@ int pipe2(int fd[2], int flags)
{
char devname[32];
int ret;
- bool blocking;
/* Register a new pipe device */
@@ -296,10 +295,6 @@ int pipe2(int fd[2], int flags)
return ERROR;
}
- /* Check for the O_NONBLOCK bit on flags */
-
- blocking = (flags & O_NONBLOCK) == 0;
-
/* Get a write file descriptor setting O_NONBLOCK temporarily */
fd[1] = open(devname, O_WRONLY | O_NONBLOCK | flags);
@@ -310,7 +305,7 @@ int pipe2(int fd[2], int flags)
/* Clear O_NONBLOCK if it was set previously */
- if (blocking)
+ if ((flags & O_NONBLOCK) == 0)
{
ret = fcntl(fd[1], F_SETFL, flags & (~O_NONBLOCK));
if (ret < 0)
diff --git a/drivers/pipes/pipe_common.c b/drivers/pipes/pipe_common.c
index f5df000723..daf3eb3e7a 100644
--- a/drivers/pipes/pipe_common.c
+++ b/drivers/pipes/pipe_common.c
@@ -65,18 +65,16 @@
****************************************************************************/
/****************************************************************************
- * Name: pipecommon_bufferused
+ * Name: pipecommon_wakeup
****************************************************************************/
-static pipe_ndx_t pipecommon_bufferused(FAR struct pipe_dev_s *dev)
+static void pipecommon_wakeup(FAR sem_t *sem)
{
- if (dev->d_wrndx >= dev->d_rdndx)
- {
- return dev->d_wrndx - dev->d_rdndx;
- }
- else
+ int sval;
+
+ while (nxsem_get_value(sem, &sval) == OK && sval <= 0)
{
- return dev->d_bufsize + dev->d_wrndx - dev->d_rdndx;
+ nxsem_post(sem);
}
}
@@ -105,7 +103,7 @@ FAR struct pipe_dev_s *pipecommon_allocdev(size_t bufsize)
nxmutex_init(&dev->d_bflock);
nxsem_init(&dev->d_rdsem, 0, 0);
nxsem_init(&dev->d_wrsem, 0, 0);
- dev->d_bufsize = bufsize + 1; /* +1 to compensate the full indicator */
+ dev->d_bufsize = bufsize;
}
return dev;
@@ -131,7 +129,6 @@ int pipecommon_open(FAR struct file *filep)
{
FAR struct inode *inode = filep->f_inode;
FAR struct pipe_dev_s *dev = inode->i_private;
- int sval;
int ret;
DEBUGASSERT(dev != NULL);
@@ -153,13 +150,13 @@ int pipecommon_open(FAR struct file *filep)
* is first opened.
*/
- if (inode->i_crefs == 1 && dev->d_buffer == NULL)
+ if (inode->i_crefs == 1 && !circbuf_is_init(&dev->d_buffer))
{
- dev->d_buffer = (FAR uint8_t *)kmm_malloc(dev->d_bufsize);
- if (!dev->d_buffer)
+ ret = circbuf_init(&dev->d_buffer, NULL, dev->d_bufsize);
+ if (ret < 0)
{
nxmutex_unlock(&dev->d_bflock);
- return -ENOMEM;
+ return ret;
}
}
@@ -178,17 +175,14 @@ int pipecommon_open(FAR struct file *filep)
if (dev->d_nwriters == 1)
{
- while (nxsem_get_value(&dev->d_rdsem, &sval) == 0 && sval <= 0)
- {
- nxsem_post(&dev->d_rdsem);
- }
+ pipecommon_wakeup(&dev->d_rdsem);
}
}
while ((filep->f_oflags & O_NONBLOCK) == 0 && /* Blocking */
(filep->f_oflags & O_RDWR) == O_WRONLY && /* Write-only */
dev->d_nreaders < 1 && /* No readers on the pipe
*/
- dev->d_wrndx == dev->d_rdndx) /* Buffer is empty */
+ circbuf_is_empty(&dev->d_buffer)) /* Buffer is empty */
{
/* If opened for write-only, then wait for at least one reader
* on the pipe.
@@ -245,17 +239,14 @@ int pipecommon_open(FAR struct file *filep)
if (dev->d_nreaders == 1)
{
- while (nxsem_get_value(&dev->d_wrsem, &sval) == 0 && sval <= 0)
- {
- nxsem_post(&dev->d_wrsem);
- }
+ pipecommon_wakeup(&dev->d_wrsem);
}
}
while ((filep->f_oflags & O_NONBLOCK) == 0 && /* Blocking */
(filep->f_oflags & O_RDWR) == O_RDONLY && /* Read-only */
dev->d_nwriters < 1 && /* No writers on the pipe
*/
- dev->d_wrndx == dev->d_rdndx) /* Buffer is empty */
+ circbuf_is_empty(&dev->d_buffer)) /* Buffer is empty */
{
/* If opened for read-only, then wait for either at least one writer
* on the pipe.
@@ -311,7 +302,6 @@ int pipecommon_close(FAR struct file *filep)
{
FAR struct inode *inode = filep->f_inode;
FAR struct pipe_dev_s *dev = inode->i_private;
- int sval;
int ret;
DEBUGASSERT(dev && filep->f_inode->i_crefs > 0);
@@ -353,10 +343,7 @@ int pipecommon_close(FAR struct file *filep)
poll_notify(dev->d_fds, CONFIG_DEV_PIPE_NPOLLWAITERS, POLLHUP);
- while (nxsem_get_value(&dev->d_rdsem, &sval) == 0 && sval <= 0)
- {
- nxsem_post(&dev->d_rdsem);
- }
+ pipecommon_wakeup(&dev->d_rdsem);
}
}
@@ -374,11 +361,7 @@ int pipecommon_close(FAR struct file *filep)
poll_notify(dev->d_fds, CONFIG_DEV_PIPE_NPOLLWAITERS,
POLLERR);
- while (nxsem_get_value(&dev->d_wrsem, &sval) == 0 &&
- sval <= 0)
- {
- nxsem_post(&dev->d_wrsem);
- }
+ pipecommon_wakeup(&dev->d_wrsem);
}
}
}
@@ -390,17 +373,15 @@ int pipecommon_close(FAR struct file *filep)
* obtained when the pipe is re-opened.
*/
- else if (PIPE_IS_POLICY_0(dev->d_flags) || dev->d_wrndx == dev->d_rdndx)
+ else if (PIPE_IS_POLICY_0(dev->d_flags) ||
+ circbuf_is_empty(&dev->d_buffer))
{
/* Policy 0 or the buffer is empty ... deallocate the buffer now. */
- kmm_free(dev->d_buffer);
- dev->d_buffer = NULL;
+ circbuf_uninit(&dev->d_buffer);
/* And reset all counts and indices */
- dev->d_wrndx = 0;
- dev->d_rdndx = 0;
dev->d_nwriters = 0;
dev->d_nreaders = 0;
@@ -429,11 +410,7 @@ ssize_t pipecommon_read(FAR struct file *filep, FAR char
*buffer, size_t len)
{
FAR struct inode *inode = filep->f_inode;
FAR struct pipe_dev_s *dev = inode->i_private;
-#ifdef CONFIG_DEV_PIPEDUMP
- FAR uint8_t *start = (FAR uint8_t *)buffer;
-#endif
ssize_t nread = 0;
- int sval;
int ret;
DEBUGASSERT(dev);
@@ -457,7 +434,7 @@ ssize_t pipecommon_read(FAR struct file *filep, FAR char
*buffer, size_t len)
/* If the pipe is empty, then wait for something to be written to it */
- while (dev->d_wrndx == dev->d_rdndx)
+ while (circbuf_is_empty(&dev->d_buffer))
{
/* If there are no writers on the pipe, then return end of file */
@@ -494,23 +471,13 @@ ssize_t pipecommon_read(FAR struct file *filep, FAR char
*buffer, size_t len)
* byte).
*/
- nread = 0;
- while ((size_t)nread < len && dev->d_wrndx != dev->d_rdndx)
- {
- *buffer++ = dev->d_buffer[dev->d_rdndx];
- if (++dev->d_rdndx >= dev->d_bufsize)
- {
- dev->d_rdndx = 0;
- }
-
- nread++;
- }
+ nread = circbuf_read(&dev->d_buffer, buffer, len);
/* Notify all poll/select waiters that they can write to the
* FIFO when buffer can accept more than d_polloutthrd bytes.
*/
- if (pipecommon_bufferused(dev) < (dev->d_bufsize - 1 - dev->d_polloutthrd))
+ if (circbuf_used(&dev->d_buffer) <= (dev->d_bufsize - dev->d_polloutthrd))
{
poll_notify(dev->d_fds, CONFIG_DEV_PIPE_NPOLLWAITERS, POLLOUT);
}
@@ -519,13 +486,10 @@ ssize_t pipecommon_read(FAR struct file *filep, FAR char
*buffer, size_t len)
* buffer.
*/
- while (nxsem_get_value(&dev->d_wrsem, &sval) == 0 && sval <= 0)
- {
- nxsem_post(&dev->d_wrsem);
- }
+ pipecommon_wakeup(&dev->d_wrsem);
nxmutex_unlock(&dev->d_bflock);
- pipe_dumpbuffer("From PIPE:", start, nread);
+ pipe_dumpbuffer("From PIPE:", buffer, nread);
return nread;
}
@@ -540,8 +504,6 @@ ssize_t pipecommon_write(FAR struct file *filep, FAR const
char *buffer,
FAR struct pipe_dev_s *dev = inode->i_private;
ssize_t nwritten = 0;
ssize_t last;
- int nxtwrndx;
- int sval;
int ret;
DEBUGASSERT(dev);
@@ -598,33 +560,22 @@ ssize_t pipecommon_write(FAR struct file *filep, FAR
const char *buffer,
return nwritten == 0 ? -EPIPE : nwritten;
}
- /* Calculate the write index AFTER the next byte is written */
-
- nxtwrndx = dev->d_wrndx + 1;
- if (nxtwrndx >= dev->d_bufsize)
- {
- nxtwrndx = 0;
- }
-
/* Would the next write overflow the circular buffer? */
- if (nxtwrndx != dev->d_rdndx)
+ if (!circbuf_is_full(&dev->d_buffer))
{
- /* No... copy the byte */
+ /* Loop until all of the bytes have been written */
- dev->d_buffer[dev->d_wrndx] = *buffer++;
- dev->d_wrndx = nxtwrndx;
+ nwritten += circbuf_write(&dev->d_buffer,
+ buffer + nwritten, len - nwritten);
- /* Is the write complete? */
-
- nwritten++;
- if ((size_t)nwritten >= len)
+ if ((size_t)nwritten == len)
{
/* Notify all poll/select waiters that they can read from the
* FIFO when buffer used exceeds poll threshold.
*/
- if (pipecommon_bufferused(dev) > dev->d_pollinthrd)
+ if (circbuf_used(&dev->d_buffer) > dev->d_pollinthrd)
{
poll_notify(dev->d_fds, CONFIG_DEV_PIPE_NPOLLWAITERS,
POLLIN);
@@ -634,10 +585,7 @@ ssize_t pipecommon_write(FAR struct file *filep, FAR const
char *buffer,
* available.
*/
- while (nxsem_get_value(&dev->d_rdsem, &sval) == 0 && sval <= 0)
- {
- nxsem_post(&dev->d_rdsem);
- }
+ pipecommon_wakeup(&dev->d_rdsem);
/* Return the number of bytes written */
@@ -663,10 +611,7 @@ ssize_t pipecommon_write(FAR struct file *filep, FAR const
char *buffer,
* available.
*/
- while (nxsem_get_value(&dev->d_rdsem, &sval) == 0 && sval <= 0)
- {
- nxsem_post(&dev->d_rdsem);
- }
+ pipecommon_wakeup(&dev->d_rdsem);
}
last = nwritten;
@@ -759,7 +704,7 @@ int pipecommon_poll(FAR struct file *filep, FAR struct
pollfd *fds,
* First, determine how many bytes are in the buffer
*/
- nbytes = pipecommon_bufferused(dev);
+ nbytes = circbuf_used(&dev->d_buffer);
/* Notify the POLLOUT event if the pipe buffer can accept
* more than d_polloutthrd bytes, but only if
@@ -768,7 +713,7 @@ int pipecommon_poll(FAR struct file *filep, FAR struct
pollfd *fds,
eventset = 0;
if ((filep->f_oflags & O_WROK) &&
- nbytes < (dev->d_bufsize - 1 - dev->d_polloutthrd))
+ nbytes <= (dev->d_bufsize - dev->d_polloutthrd))
{
eventset |= POLLOUT;
}
@@ -896,26 +841,7 @@ int pipecommon_ioctl(FAR struct file *filep, int cmd,
unsigned long arg)
case FIONWRITE: /* Number of bytes waiting in send queue */
case FIONREAD: /* Number of bytes available for reading */
{
- int count;
-
- /* Determine the number of bytes written to the buffer. This is,
- * of course, also the number of bytes that may be read from the
- * buffer.
- *
- * d_rdndx - index to remove next byte from the buffer
- * d_wrndx - Index to next location to add a byte to the buffer.
- */
-
- if (dev->d_wrndx < dev->d_rdndx)
- {
- count = (dev->d_bufsize - dev->d_rdndx) + dev->d_wrndx;
- }
- else
- {
- count = dev->d_wrndx - dev->d_rdndx;
- }
-
- *(FAR int *)((uintptr_t)arg) = count;
+ *(FAR int *)((uintptr_t)arg) = circbuf_used(&dev->d_buffer);
ret = 0;
}
break;
@@ -924,24 +850,7 @@ int pipecommon_ioctl(FAR struct file *filep, int cmd,
unsigned long arg)
case FIONSPACE:
{
- int count;
-
- /* Determine the number of bytes free in the buffer.
- *
- * d_rdndx - index to remove next byte from the buffer
- * d_wrndx - Index to next location to add a byte to the buffer.
- */
-
- if (dev->d_wrndx < dev->d_rdndx)
- {
- count = (dev->d_rdndx - dev->d_wrndx) - 1;
- }
- else
- {
- count = ((dev->d_bufsize - dev->d_wrndx) + dev->d_rdndx) - 1;
- }
-
- *(FAR int *)((uintptr_t)arg) = count;
+ *(FAR int *)((uintptr_t)arg) = circbuf_space(&dev->d_buffer);
ret = 0;
}
break;
@@ -981,10 +890,7 @@ int pipecommon_unlink(FAR struct inode *inode)
{
/* No.. free the buffer (if there is one) */
- if (dev->d_buffer)
- {
- kmm_free(dev->d_buffer);
- }
+ circbuf_uninit(&dev->d_buffer);
/* And free the device structure. */
diff --git a/drivers/pipes/pipe_common.h b/drivers/pipes/pipe_common.h
index 1e587a2c96..72f1af89f5 100644
--- a/drivers/pipes/pipe_common.h
+++ b/drivers/pipes/pipe_common.h
@@ -27,6 +27,7 @@
#include <nuttx/config.h>
#include <nuttx/mutex.h>
+#include <nuttx/mm/circbuf.h>
#include <sys/types.h>
#include <stdint.h>
@@ -114,20 +115,18 @@ typedef uint8_t pipe_ndx_t; /* 8-bit index */
struct pipe_dev_s
{
- mutex_t d_bflock; /* Used to serialize access to d_buffer and
indices */
- sem_t d_rdsem; /* Empty buffer - Reader waits for data write AND
- * block O_RDONLY open until there is at least one
writer */
- sem_t d_wrsem; /* Full buffer - Writer waits for data read AND
- * block O_WRONLY open until there is at least one
reader */
- pipe_ndx_t d_wrndx; /* Index in d_buffer to save next byte written */
- pipe_ndx_t d_rdndx; /* Index in d_buffer to return the next byte read
*/
- pipe_ndx_t d_bufsize; /* allocated size of d_buffer in bytes */
- pipe_ndx_t d_pollinthrd; /* Buffer threshold for POLLIN to occur */
- pipe_ndx_t d_polloutthrd; /* Buffer threshold for POLLOUT to occur */
- uint8_t d_nwriters; /* Number of reference counts for write access */
- uint8_t d_nreaders; /* Number of reference counts for read access */
- uint8_t d_flags; /* See PIPE_FLAG_* definitions */
- uint8_t *d_buffer; /* Buffer allocated when device opened */
+ mutex_t d_bflock; /* Used to serialize access to d_buffer and
indices */
+ sem_t d_rdsem; /* Empty buffer - Reader waits for data
write AND
+ * block O_RDONLY open until there is at
least one writer */
+ sem_t d_wrsem; /* Full buffer - Writer waits for data read
AND
+ * block O_WRONLY open until there is at
least one reader */
+ pipe_ndx_t d_bufsize; /* allocated size of d_buffer in bytes */
+ pipe_ndx_t d_pollinthrd; /* Buffer threshold for POLLIN to occur */
+ pipe_ndx_t d_polloutthrd; /* Buffer threshold for POLLOUT to occur */
+ uint8_t d_nwriters; /* Number of reference counts for write
access */
+ uint8_t d_nreaders; /* Number of reference counts for read
access */
+ uint8_t d_flags; /* See PIPE_FLAG_* definitions */
+ struct circbuf_s d_buffer; /* Buffer allocated when device opened */
/* The following is a list if poll structures of threads waiting for
* driver events. The 'struct pollfd' reference for each open is also