Move nuttx/examples to apps/examples

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3405 42af7a65-404d-4744-a932-0658087f49c3

6 files changed, 1153 insertions, 0 deletions

diff --git a/apps/examples/pipe/Makefile b/apps/examples/pipe/Makefile
new file mode 100644
index 000000000..886409f62
--- /dev/null
+++ b/apps/examples/pipe/Makefile
@@ -0,0 +1,90 @@
+############################################################################
+# apps/examples/pipe/Makefile
+#
+#   Copyright (C) 2008, 2010-2011 Gregory Nutt. All rights reserved.
+#   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+#
+# 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.
+#
+############################################################################
+
+-include $(TOPDIR)/.config
+-include $(TOPDIR)/Make.defs
+include $(APPDIR)/Make.defs
+
+# Pipe Example
+
+ASRCS		=
+CSRCS		= pipe_main.c transfer_test.c interlock_test.c redirect_test.c
+
+AOBJS		= $(ASRCS:.S=$(OBJEXT))
+COBJS		= $(CSRCS:.c=$(OBJEXT))
+
+SRCS		= $(ASRCS) $(CSRCS)
+OBJS		= $(AOBJS) $(COBJS)
+
+BIN	    	= ../../libapps$(LIBEXT)
+
+ROOTDEPPATH	= --dep-path .
+
+# Common build
+
+VPATH		= 
+
+all: .built
+.PHONY:	.built clean depend disclean
+
+$(AOBJS): %$(OBJEXT): %.S
+	$(call ASSEMBLE, $<, $@)
+
+$(COBJS): %$(OBJEXT): %.c
+	$(call COMPILE, $<, $@)
+
+$(BIN):	$(OBJS)
+	@( for obj in $(OBJS) ; do \
+		$(call ARCHIVE, $@, $${obj}); \
+	done ; )
+	@touch .built
+	
+.built: $(BIN)
+
+.depend: Makefile $(SRCS)
+	@$(MKDEP) $(ROOTDEPPATH) $(CC) -- $(CFLAGS) -- $(SRCS) >Make.dep
+	@touch $@
+
+# Register application
+depend: .depend
+
+clean:
+	@rm -f $(BIN) *.o *~ .*.swp .built
+	$(call CLEAN)
+
+distclean: clean
+	@rm -f Make.dep .depend
+
+-include Make.dep
diff --git a/apps/examples/pipe/interlock_test.c b/apps/examples/pipe/interlock_test.c
new file mode 100644
index 000000000..e049a65f6
--- /dev/null
+++ b/apps/examples/pipe/interlock_test.c
@@ -0,0 +1,224 @@
+/****************************************************************************
+ * examples/pipe/interlock_test.c
+ *
+ *   Copyright (C) 2008 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * 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
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+#include <sys/stat.h>
+
+#include <sys/types.h>
+
+#include <stdio.h>
+#include <fcntl.h>
+#include <unistd.h>
+#include <errno.h>
+
+#include "pipe.h"
+
+/****************************************************************************
+ * Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: null_writer
+ ****************************************************************************/
+
+static void *null_writer(pthread_addr_t pvarg)
+{
+  int fd;
+
+  /* Wait a bit */
+
+  printf("null_writer: started -- sleeping\n");
+  sleep(5);
+
+  /* Then open the FIFO for write access */
+
+  printf("null_writer: Opening FIFO for write access\n");
+  fd = open(FIFO_PATH2, O_WRONLY);
+  if (fd < 0)
+    {
+      fprintf(stderr, "null_writer: Failed to open FIFO %s for writing, errno=%d\n",
+              FIFO_PATH2, errno);
+      return (void*)1;
+    }
+
+  /* Wait a bit more */
+
+  printf("null_writer: Opened %s for writing -- sleeping\n", FIFO_PATH2);
+  sleep(5);
+
+  /* Then close the FIFO */
+
+  printf("null_writer: Closing %s\n", FIFO_PATH2);
+  if (close(fd) != 0)
+    {
+      fprintf(stderr, "null_writer: close failed: %d\n", errno);
+    }
+  sleep(5);
+  
+  printf("null_writer: Returning success\n");
+  return (void*)0;
+}
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: interlock_test
+ ****************************************************************************/
+
+int interlock_test(void)
+{
+  pthread_t writerid;
+  void *value;
+  char data[16];
+  ssize_t nbytes;
+  int fd;
+  int ret;
+
+  /* Create a FIFO */
+
+  ret = mkfifo(FIFO_PATH2, 0666);
+  if (ret < 0)
+    {
+      fprintf(stderr, "interlock_test: mkfifo failed with errno=%d\n", errno);
+      return 1;
+    }
+
+  /* Start the null_writer_thread */
+
+  printf("interlock_test: Starting null_writer thread\n");
+  ret = pthread_create(&writerid, NULL, null_writer, (pthread_addr_t)NULL);
+  if (ret != 0)
+    {
+      fprintf(stderr, "interlock_test: Failed to create null_writer thread, error=%d\n", ret);
+      ret = 2;
+      goto errout_with_fifo;
+    }
+ 
+  /* Open one end of the FIFO for reading.  This open call should block until the
+   * null_writer thread opens the other end of the FIFO for writing.
+   */
+
+  printf("interlock_test: Opening FIFO for read access\n");
+  fd = open(FIFO_PATH2, O_RDONLY);
+  if (fd < 0)
+    {
+      fprintf(stderr, "interlock_test: Failed to open FIFO %s for reading, errno=%d\n",
+              FIFO_PATH2, errno);
+      ret = 3;
+      goto errout_with_thread;
+    }
+
+  /* Attempt to read one byte from the FIFO.  This should return end-of-file because
+   * the null_writer closes the FIFO without writing anything.
+   */
+
+  printf("interlock_test: Reading from %s\n", FIFO_PATH2);
+  nbytes = read(fd, data, 16);
+  if (nbytes < 0 )
+    {
+      fprintf(stderr, "interlock_test: read failed, errno=%d\n", errno);
+      ret = 4;
+      goto errout_with_file;
+    }
+  else if (ret != 0)
+    {
+      fprintf(stderr, "interlock_test: Read %d bytes of data -- aborting: %d\n", nbytes);
+      ret = 5;
+      goto errout_with_file;
+    }
+
+  /* Close the file */
+
+  printf("interlock_test: Closing %s\n", FIFO_PATH2);
+  if (close(fd) != 0)
+    {
+      fprintf(stderr, "interlock_test: close failed: %d\n", errno);
+    }
+
+  /* Wait for null_writer thread to complete */
+
+  printf("interlock_test: Waiting for null_writer thread\n");
+  ret = pthread_join(writerid, &value);
+  if (ret != 0)
+    {
+      fprintf(stderr, "interlock_test: pthread_join failed, error=%d\n", ret);
+      ret = 6;
+      goto errout_with_fifo;
+    }
+  else
+    {
+      printf("interlock_test: writer returned %d\n", (int)value);
+      if (value != (void*)0)
+        {
+          ret = 7;
+          goto errout_with_fifo;
+        }
+    }
+
+  /* unlink(FIFO_PATH2); */
+  printf("interlock_test: Returning success\n");
+  return 0;
+
+errout_with_file:
+  if (close(fd) != 0)
+    {
+      fprintf(stderr, "interlock_test: close failed: %d\n", errno);
+    }
+errout_with_thread:
+  pthread_detach(writerid);
+  pthread_cancel(writerid);
+errout_with_fifo:
+  /* unlink(FIFO_PATH2); */
+  printf("interlock_test: Returning %d\n", ret);
+  return ret;
+}
diff --git a/apps/examples/pipe/pipe.h b/apps/examples/pipe/pipe.h
new file mode 100644
index 000000000..2c18fd868
--- /dev/null
+++ b/apps/examples/pipe/pipe.h
@@ -0,0 +1,74 @@
+/****************************************************************************
+ * examples/pipe/pipe.h
+ *
+ *   Copyright (C) 2008 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * 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.
+ *
+ ****************************************************************************/
+
+#ifndef __EXAMPLES_PIPE_PIPE_H
+#define __EXAMPLES_PIPE_PIPE_H
+
+/****************************************************************************
+ * Compilation Switches
+ ****************************************************************************/
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+/****************************************************************************
+ * Definitions
+ ****************************************************************************/
+
+#define FIFO_PATH1 "/tmp/testfifo-1"
+#define FIFO_PATH2 "/tmp/testfifo-2"
+
+#ifndef CONFIG_EXAMPLES_PIPE_STACKSIZE
+#  define CONFIG_EXAMPLES_PIPE_STACKSIZE 1024
+#endif
+
+/****************************************************************************
+ * Public Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Variables
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+extern int transfer_test(int fdin, int fdout);
+extern int interlock_test(void);
+extern int redirection_test(void);
+
+#endif /* __EXAMPLES_PIPE_PIPE_H */
diff --git a/apps/examples/pipe/pipe_main.c b/apps/examples/pipe/pipe_main.c
new file mode 100644
index 000000000..97e728eb7
--- /dev/null
+++ b/apps/examples/pipe/pipe_main.c
@@ -0,0 +1,197 @@
+/****************************************************************************
+ * examples/pipe/pipe_main.c
+ *
+ *   Copyright (C) 2008-2009 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * 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
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <sys/stat.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <sched.h>
+#include <fcntl.h>
+#include <errno.h>
+
+#include "pipe.h"
+
+/****************************************************************************
+ * Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: user_initialize
+ ****************************************************************************/
+
+void user_initialize(void)
+{
+}
+
+/****************************************************************************
+ * Name: user_start
+ ****************************************************************************/
+
+int user_start(int argc, char *argv[])
+{
+  int filedes[2];
+  int ret;
+
+  /* Test FIFO logic */
+
+  printf("\nuser_start: Performing FIFO test\n");
+  ret = mkfifo(FIFO_PATH1, 0666);
+  if (ret < 0)
+    {
+      fprintf(stderr, "user_start: mkfifo failed with errno=%d\n", errno);
+      return 1;
+    }
+
+  /* Open one end of the FIFO for reading and the other end for writing.  NOTE:
+   * the following might not work on most FIFO implementations because the attempt
+   * to open just one end of the FIFO for writing might block.  The NuttX FIFOs block
+   * only on open for read-only (see interlock_test()).
+   */
+
+  filedes[1] = open(FIFO_PATH1, O_WRONLY);
+  if (filedes[1] < 0)
+    {
+      fprintf(stderr, "user_start: Failed to open FIFO %s for writing, errno=%d\n",
+              FIFO_PATH1, errno);
+      return 2;
+    }
+
+  filedes[0] = open(FIFO_PATH1, O_RDONLY);
+  if (filedes[0] < 0)
+    {
+      fprintf(stderr, "user_start: Failed to open FIFO %s for reading, errno=%d\n",
+              FIFO_PATH1, errno);
+      if (close(filedes[1]) != 0)
+        {
+          fprintf(stderr, "user_start: close failed: %d\n", errno);
+        }
+      return 3;
+    }
+
+  /* Then perform the test using those file descriptors */
+
+  ret = transfer_test(filedes[0], filedes[1]);
+  if (close(filedes[0]) != 0)
+    {
+      fprintf(stderr, "user_start: close failed: %d\n", errno);
+    }
+  if (close(filedes[1]) != 0)
+    {
+      fprintf(stderr, "user_start: close failed: %d\n", errno);
+    }
+  /* unlink(FIFO_PATH1); fails */
+
+  if (ret != 0)
+    {
+      fprintf(stderr, "user_start: FIFO test FAILED (%d)\n", ret);
+      return 4;
+    }
+  printf("user_start: FIFO test PASSED\n");
+
+  /* Test PIPE logic */
+
+  printf("\nuser_start: Performing pipe test\n");
+  ret = pipe(filedes);
+  if (ret < 0)
+    {
+      fprintf(stderr, "user_start: pipe failed with errno=%d\n", errno);
+      return 5;
+    }
+
+  /* Then perform the test using those file descriptors */
+
+  ret = transfer_test(filedes[0], filedes[1]);
+  if (close(filedes[0]) != 0)
+    {
+      fprintf(stderr, "user_start: close failed: %d\n", errno);
+    }
+  if (close(filedes[1]) != 0)
+    {
+      fprintf(stderr, "user_start: close failed: %d\n", errno);
+    }
+
+  if (ret != 0)
+    {
+      fprintf(stderr, "user_start: PIPE test FAILED (%d)\n", ret);
+      return 6;
+    }
+  printf("user_start: PIPE test PASSED\n");
+
+  /* Perform the FIFO interlock test */
+
+  printf("\nuser_start: Performing pipe interlock test\n");
+  ret = interlock_test();
+  if (ret != 0)
+    {
+      fprintf(stderr, "user_start: FIFO interlock test FAILED (%d)\n", ret);
+      return 7;
+    }
+  printf("user_start: PIPE interlock test PASSED\n");
+
+  /* Perform the pipe redirection test */
+
+  printf("\nuser_start: Performing redirection test\n");
+  ret = redirection_test();
+  if (ret != 0)
+    {
+      fprintf(stderr, "user_start: FIFO redirection test FAILED (%d)\n", ret);
+      return 7;
+    }
+  printf("user_start: PIPE redirection test PASSED\n");
+
+  fflush(stdout);
+  return 0;
+}
diff --git a/apps/examples/pipe/redirect_test.c b/apps/examples/pipe/redirect_test.c
new file mode 100644
index 000000000..45e86c356
--- /dev/null
+++ b/apps/examples/pipe/redirect_test.c
@@ -0,0 +1,326 @@
+/****************************************************************************
+ * examples/pipe/redirect_test.c
+ *
+ *   Copyright (C) 2008-2009 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * 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
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <sched.h>
+#include <semaphore.h>
+#include <errno.h>
+
+#include "pipe.h"
+
+/****************************************************************************
+ * Definitions
+ ****************************************************************************/
+
+#define READ_SIZE 37
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+static sem_t g_rddone;
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: redirect_reader
+ ****************************************************************************/
+
+static int redirect_reader(int argc, char *argv[])
+{
+  char buffer[READ_SIZE];
+  int fdin;
+  int fdout;
+  int ret;
+  int nbytes = 0;
+ 
+  printf("redirect_reader: started with fdin=%s\n", argv[1]);
+
+  /* Convert the fdin to binary */
+
+  fdin  = atoi(argv[1]);
+  fdout = atoi(argv[2]);
+
+  /* Close fdout -- we don't need it */
+
+  ret = close(fdout);
+  if (ret != 0)
+    {
+       fprintf(stderr, "redirect_reader: failed to close fdout=%d\n", fdout);
+       return 1;
+    }
+
+  /* Re-direct the fdin to stdin */
+
+  ret = dup2(fdin, 0);
+  if (ret != 0)
+    {
+        fprintf(stderr, "redirect_reader: dup2 failed: %d\n", errno);
+        close(fdin);
+        return 2;
+    }
+
+  /* Close the original file descriptor */
+
+  ret = close(fdin);
+  if (ret != 0)
+    {
+       fprintf(stderr, "redirect_reader: failed to close fdin=%d\n", fdin);
+       return 3;
+    }
+
+  /* Then read from stdin until we hit the end of file */
+
+  fflush(stdout);
+  for (;;)
+    {
+      /* Read from stdin */
+
+      ret = read(0, buffer, READ_SIZE);
+      if (ret < 0 )
+        {
+           fprintf(stderr, "redirect_reader: read failed, errno=%d\n", errno);
+           return 4;
+        }
+      else if (ret == 0)
+        {
+          break;
+        }
+      nbytes += ret;
+
+      /* Echo to stdout */
+ 
+      ret = write(1, buffer, ret);
+      if (ret < 0)
+        {
+           fprintf(stderr, "redirect_reader: read failed, errno=%d\n", errno);
+           return 5;
+        }
+    }
+
+  printf("redirect_reader: %d bytes read\n", nbytes);
+  ret = close(0);
+  if (ret != 0)
+    {
+       fprintf(stderr, "redirect_reader: failed to close fd=0\n");
+       return 6;
+    }
+
+  sem_post(&g_rddone);
+  printf("redirect_reader: Returning success\n");
+  return 0;
+}
+
+/****************************************************************************
+ * Name: redirect_writer
+ ****************************************************************************/
+
+static int redirect_writer(int argc, char *argv[])
+{
+  int fdin;
+  int fdout;
+  int nbytes = 0;
+  int ret;
+ 
+  fprintf(stderr, "redirect_writer: started with fdout=%s\n", argv[2]);
+ 
+  /* Convert the fdout to binary */
+
+  fdin  = atoi(argv[1]);
+  fdout = atoi(argv[2]);
+
+  /* Close fdin -- we don't need it */
+
+  ret = close(fdin);
+  if (ret != 0)
+    {
+       fprintf(stderr, "redirect_reader: failed to close fdin=%d\n", fdin);
+       return 1;
+    }
+
+  /* Re-direct the fdout to stdout */
+
+  ret = dup2(fdout, 1);
+  if (ret != 0)
+    {
+        fprintf(stderr, "redirect_writer: dup2 failed: %d\n", errno);
+        return 2;
+    }
+
+  /* Close the original file descriptor */
+
+  ret = close(fdout);
+  if (ret != 0)
+    {
+       fprintf(stderr, "redirect_reader: failed to close fdout=%d\n", fdout);
+       return 3;
+    }
+
+  /* Then write a bunch of stuff to stdout */
+
+  fflush(stderr);
+  nbytes += printf("\nFour score and seven years ago our fathers brought forth on this continent a new nation,\n");
+  nbytes += printf("conceived in Liberty, and dedicated to the proposition that all men are created equal.\n");
+  nbytes += printf("\nNow we are engaged in a great civil war, testing whether that nation, or any nation, so\n");
+  nbytes += printf("conceived and so dedicated, can long endure. We are met on a great battle-field of that war.\n");
+  nbytes += printf("We have come to dedicate a portion of that field, as a final resting place for those who here\n");
+  nbytes += printf("gave their lives that that nation might live. It is altogether fitting and proper that we\n");
+  nbytes += printf("should do this.\n");
+  nbytes += printf("\nBut, in a larger sense, we can not dedicate - we can not consecrate - we can not hallow - this ground.\n");
+  nbytes += printf("The brave men, living and dead, who struggled here, have consecrated it, far above our poor power\n");
+  nbytes += printf("to add or detract. The world will little note, nor long remember what we say here, but it can\n");
+  nbytes += printf("never forget what they did here. It is for us the living, rather, to be dedicated here to the\n");
+  nbytes += printf("unfinished work which they who fought here have thus far so nobly advanced. It is rather for us to\n");
+  nbytes += printf("be here dedicated to the great task remaining before us - that from these honored dead we take\n");
+  nbytes += printf("increased devotion to that cause for which they gave the last full measure of devotion - that we\n");
+  nbytes += printf("here highly resolve that these dead shall not have died in vain - that this nation, under God,\n");
+  nbytes += printf("shall have a new birth of freedom - and that government of the people, by the people, for the\n");
+  nbytes += printf("people, shall not perish from the earth.\n\n");
+  fflush(stdout);
+
+  fprintf(stderr, "redirect_writer: %d bytes written\n", nbytes);
+
+  ret = close(1);
+  if (ret != 0)
+    {
+       fprintf(stderr, "redirect_writer: failed to close fd=1\n");
+       return 4;
+    }
+
+  fprintf(stderr, "redirect_writer: Returning success\n");
+  return 0;
+}
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: redirection_test
+ ****************************************************************************/
+
+int redirection_test(void)
+{
+  const char *argv[3];
+  char buffer1[8];
+  char buffer2[8];
+  int readerid;
+  int writerid;
+  int filedes[2];
+  int ret;
+
+  sem_init(&g_rddone, 0, 0);
+
+    /* Create the pipe */
+
+  ret = pipe(filedes);
+  if (ret < 0)
+    {
+      fprintf(stderr, "redirection_test: pipe failed with errno=%d\n", errno);
+      return 5;
+    }
+ 
+  sprintf(buffer1, "%d", filedes[0]);
+  argv[0] = buffer1;
+  sprintf(buffer2, "%d", filedes[1]);
+  argv[1] = buffer2;
+  argv[2] = NULL;
+
+  /* Start redirect_reader thread */
+
+  printf("redirection_test: Starting redirect_reader task with fd=%d\n", filedes[0]);
+  readerid = task_create("redirect_reader", 50, CONFIG_EXAMPLES_PIPE_STACKSIZE, redirect_reader, argv);
+  if (readerid < 0)
+    {
+      fprintf(stderr, "redirection_test: Failed to create redirect_writer task: %d\n", errno);
+      return 1;
+    }
+
+  /* Start redirect_writer task */
+
+  printf("redirection_test: Starting redirect_writer task with fd=%d\n", filedes[1]);
+  writerid = task_create("redirect_writer", 50, CONFIG_EXAMPLES_PIPE_STACKSIZE, redirect_writer, argv);
+  if (writerid < 0)
+    {
+      fprintf(stderr, "redirection_test: Failed to create redirect_writer task: %d\n", errno);
+      ret = task_delete(readerid);
+      if (ret != 0)
+        {
+          fprintf(stderr, "redirection_test: Failed to delete redirect_reader task %d\n", errno);
+        }
+      return 2;
+    }
+
+  /* We should be able to close the pipe file descriptors now. */
+
+  if (close(filedes[0]) != 0)
+    {
+      fprintf(stderr, "user_start: close failed: %d\n", errno);
+    }
+  if (close(filedes[1]) != 0)
+    {
+      fprintf(stderr, "user_start: close failed: %d\n", errno);
+    }
+
+  if (ret != 0)
+    {
+      fprintf(stderr, "user_start: PIPE test FAILED (%d)\n", ret);
+      return 6;
+    }
+
+  /* Wait for redirect_writer thread to complete */
+
+  printf("redirection_test: Waiting...\n");
+  fflush(stdout);
+  sem_wait(&g_rddone);
+
+  printf("redirection_test: returning %d\n", ret);
+  return ret;
+}
+
diff --git a/apps/examples/pipe/transfer_test.c b/apps/examples/pipe/transfer_test.c
new file mode 100644
index 000000000..cb8cad04a
--- /dev/null
+++ b/apps/examples/pipe/transfer_test.c
@@ -0,0 +1,242 @@
+/****************************************************************************
+ * examples/pipe/transfer_test.c
+ *
+ *   Copyright (C) 2008-2009 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * 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
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <stdio.h>
+#include <unistd.h>
+#include <errno.h>
+
+#include "pipe.h"
+
+/****************************************************************************
+ * Pre-proecessor Definitions
+ ****************************************************************************/
+
+#define MAX_BYTE      13
+
+#define WRITE_SIZE    MAX_BYTE
+#define NWRITES       1400
+#define NWRITE_BYTES (NWRITES * WRITE_SIZE)
+
+#define READ_SIZE    (2*MAX_BYTE)
+#define NREADS       (NWRITES / 2)
+#define NREAD_BYTES   NWRITE_BYTES
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: transfer_reader
+ ****************************************************************************/
+
+static void *transfer_reader(pthread_addr_t pvarg)
+{
+  char buffer[READ_SIZE];
+  int fd = (int)pvarg;
+  int ret;
+  int nbytes;
+  int value;
+  int ndx;
+
+  printf("transfer_reader: started\n");
+  for (nbytes = 0, value = 0; nbytes < NREAD_BYTES;)
+    {
+      ret = read(fd, buffer, READ_SIZE);
+      if (ret < 0 )
+        {
+           fprintf(stderr, "transfer_reader: read failed, errno=%d\n", errno);
+           return (void*)1;
+        }
+      else if (ret == 0)
+        {
+          if (nbytes < NREAD_BYTES)
+            {
+              fprintf(stderr, "transfer_reader: Too few bytes read -- aborting: %d\n", nbytes);
+              return (void*)2;
+            }
+          break;
+        }
+      for (ndx = 0; ndx < ret; ndx++)
+        {
+          if (value >= WRITE_SIZE)
+            {
+              value = 0;
+            }
+          if (buffer[ndx] != value)
+            {
+              fprintf(stderr, "transfer_reader: Byte %d, expected %d, found %d\n",
+                      nbytes + ndx, value, buffer[ndx]);
+              return (void*)3;
+            }
+          value++;
+        }
+      nbytes += ret;
+      if (nbytes > NREAD_BYTES)
+        {
+          fprintf(stderr, "transfer_reader: Too many bytes read -- aborting: %d\n", nbytes);
+          return (void*)4;
+        }
+    }
+  printf("transfer_reader: %d bytes read\n", nbytes);
+  return (void*)0;
+}
+
+/****************************************************************************
+ * Name: transfer_writer
+ ****************************************************************************/
+
+static void *transfer_writer(pthread_addr_t pvarg)
+{
+  char buffer[WRITE_SIZE];
+  int fd = (int)pvarg;
+  int ret;
+  int i;
+
+  printf("transfer_writer: started\n");
+  for (i = 0; i < WRITE_SIZE; i++)
+    {
+      buffer[i] = i;
+    }
+
+  for (i = 0; i < NWRITES; i++)
+    {
+      ret = write(fd, buffer, WRITE_SIZE);
+      if (ret < 0 )
+        {
+           fprintf(stderr, "transfer_writer: write failed, errno=%d\n", errno);
+           return (void*)1;
+        }
+      else if (ret != WRITE_SIZE)
+        {
+           fprintf(stderr, "transfer_writer: Unexpected write size=%d\n", ret);
+           return (void*)2;
+        }
+    }
+  printf("transfer_writer: %d bytes written\n", NWRITE_BYTES);
+  return (void*)0;
+}
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: transfer_test
+ ****************************************************************************/
+
+int transfer_test(int fdin, int fdout)
+{
+  pthread_t readerid;
+  pthread_t writerid;
+  void *value;
+  int tmp;
+  int ret;
+
+  /* Start transfer_reader thread */
+
+  printf("transfer_test: Starting transfer_reader thread\n");
+  ret = pthread_create(&readerid, NULL, transfer_reader, (pthread_addr_t)fdin);
+  if (ret != 0)
+    {
+      fprintf(stderr, "transfer_test: Failed to create transfer_reader thread, error=%d\n", ret);
+      return 1;
+    }
+
+  /* Start transfer_writer thread */
+
+  printf("transfer_test: Starting transfer_writer thread\n");
+  ret = pthread_create(&writerid, NULL, transfer_writer, (pthread_addr_t)fdout);
+  if (ret != 0)
+    {
+      fprintf(stderr, "transfer_test: Failed to create transfer_writer thread, error=%d\n", ret);
+      pthread_detach(readerid);
+      ret = pthread_cancel(readerid);
+      if (ret != 0)
+        {
+          fprintf(stderr, "transfer_test: Failed to cancel transfer_reader thread, error=%d\n", ret);
+        }
+      return 2;
+    }
+
+  /* Wait for transfer_writer thread to complete */
+
+  printf("transfer_test: Waiting for transfer_writer thread\n");
+  ret = pthread_join(writerid, &value);
+  if (ret != 0)
+    {
+      fprintf(stderr, "transfer_test: pthread_join failed, error=%d\n", ret);
+    }
+  else
+    {
+      ret = (int)value;
+      printf("transfer_test: transfer_writer returned %d\n", ret);
+    }
+
+  /* Wait for transfer_reader thread to complete */
+
+  printf("transfer_test: Waiting for transfer_reader thread\n");
+  tmp = pthread_join(readerid, &value);
+  if (tmp != 0)
+    {
+      fprintf(stderr, "transfer_test: pthread_join failed, error=%d\n", ret);
+    }
+  else
+    {
+      tmp = (int)value;
+      printf("transfer_test: transfer_reader returned %d\n", tmp);
+    }
+
+  if (ret == 0)
+    {
+      ret = tmp;
+    }
+  printf("transfer_test: returning %d\n", ret);
+  return ret;
+}
+