Add skeleton for fcntl()

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

2 files changed, 164 insertions, 3 deletions

diff --git a/nuttx/fs/Makefile b/nuttx/fs/Makefile
index 30073db9e..5c1f037af 100644
--- a/nuttx/fs/Makefile
+++ b/nuttx/fs/Makefile
@@ -44,9 +44,10 @@ ifneq ($(CONFIG_NSOCKET_DESCRIPTORS),0)
 CSRCS		+= fs_close.c fs_write.c fs_ioctl.c fs_poll.c fs_select.c
 endif
 else
-CSRCS		+= fs_open.c fs_close.c fs_read.c fs_write.c fs_ioctl.c fs_poll.c \
-		   fs_select.c fs_lseek.c fs_dup.c fs_filedup.c fs_dup2.c fs_filedup2.c \
-		   fs_mmap.c fs_opendir.c fs_closedir.c fs_stat.c fs_readdir.c fs_readdirr.c \
+CSRCS		+= fs_open.c fs_close.c fs_read.c fs_write.c fs_ioctl.c \
+		   fs_poll.c fs_select.c fs_lseek.c fs_dup.c fs_filedup.c \
+		   fs_dup2.c fs_fcntl.c fs_filedup2.c fs_mmap.c fs_opendir.c \
+		   fs_closedir.c fs_stat.c fs_readdir.c fs_readdirr.c \
 		   fs_seekdir.c fs_telldir.c fs_rewinddir.c fs_files.c fs_inode.c \
 		   fs_inodefind.c fs_inodereserve.c fs_statfs.c fs_inoderemove.c \
 		   fs_registerdriver.c fs_unregisterdriver.c fs_inodeaddref.c \
diff --git a/nuttx/fs/fs_fcntl.c b/nuttx/fs/fs_fcntl.c
new file mode 100644
index 000000000..2ca0923d8
--- /dev/null
+++ b/nuttx/fs/fs_fcntl.c
@@ -0,0 +1,160 @@
+/****************************************************************************
+ * fs/fs_fcntl.c
+ *
+ *   Copyright (C) 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/types.h>
+
+#include <fcntl.h>
+#include <errno.h>
+
+#include "fs_internal.h"
+
+/****************************************************************************
+ * Global Functions
+ ****************************************************************************/
+
+int fcntl(int fildes, int cmd, ...)
+{
+  int err = 0;
+
+#warning "fcntl() not yet implemented"
+  switch (cmd)
+    {
+      case F_DUPFD:
+        /* Return a new file descriptor which shall be the lowest numbered
+         * available (that is, not already open) file descriptor greater than
+         * or equal to the third argument, arg, taken as an integer of type
+         * int. The new file descriptor shall refer to the same open file
+         * description as the original file descriptor, and shall share any
+         * locks.  The FD_CLOEXEC flag associated  with the new file descriptor
+         * shall be cleared to keep the file open across calls to one of the
+         * exec functions.
+         */
+
+      case F_GETFD:
+        /* Get the file descriptor flags defined in <fcntl.h> that are associated
+         * with the file descriptor fildes.  File descriptor flags are associated
+         * with a single file descriptor and do not affect other file descriptors
+         * that refer to the same file.
+         */
+
+      case F_SETFD:
+        /* Set the file descriptor flags defined in <fcntl.h>, that are associated
+         * with fildes, to the third argument, arg, taken as type int. If the
+         * FD_CLOEXEC flag in the third argument is 0, the file shall remain open
+         * across the exec functions; otherwise, the file shall be closed upon
+         * successful execution of one  of  the  exec  functions.
+         */
+
+      case F_GETFL:
+        /* Get the file status flags and file access modes, defined in <fcntl.h>,
+         * for the file description associated with fildes. The file access modes
+         * can be extracted from the return value using the mask O_ACCMODE, which is
+         * defined  in <fcntl.h>. File status flags and file access modes are associated
+         * with the file description and do not affect other file descriptors that
+         * refer to the same file with different open file descriptions.
+         */
+
+      case F_SETFL:
+        /* Set the file status flags, defined in <fcntl.h>, for the file description
+         * associated with fildes from the corresponding  bits in the third argument,
+         * arg, taken as type int. Bits corresponding to the file access mode and
+         * the file creation flags, as defined in <fcntl.h>, that are set in arg shall
+         * be ignored. If any bits in arg other than those mentioned here are changed
+         * by the application, the result is unspecified.
+         */
+
+      case F_GETOWN:
+        /* If fildes refers to a socket, get the process or process group ID specified
+         * to receive SIGURG signals when out-of-band data is available. Positive values
+         * indicate a process ID; negative values, other than -1, indicate a process group
+         * ID. If fildes does not refer to a socket, the results are unspecified.
+         */
+
+      case F_SETOWN:
+        /* If fildes refers to a socket, set the process or process group ID specified
+         * to receive SIGURG signals when out-of-band data is available, using the value
+         * of the third argument, arg, taken as type int. Positive values indicate a 
+         * process ID; negative values, other than -1, indicate a process group ID. If
+         * fildes does not refer to a socket, the results are unspecified.
+         */
+
+      case F_GETLK:
+        /* Get the first lock which blocks the lock description pointed to by the third
+         * argument, arg, taken as a pointer to type struct flock, defined in <fcntl.h>.
+         * The information retrieved shall overwrite the information passed to fcntl() in
+         * the structure flock. If no lock is found that would prevent this lock from being
+         * created, then the structure shall be left unchanged except for the lock type
+         * which shall be set to F_UNLCK.
+         */
+
+      case F_SETLK:
+        /* Set or clear a file segment lock according to the lock description pointed to
+         * by the third argument, arg, taken as a pointer to type struct flock, defined in
+         * <fcntl.h>. F_SETLK can establish shared (or read) locks (F_RDLCK) or exclusive
+         * (or write) locks (F_WRLCK), as well  as  to  remove  either  type  of  lock  (F_UNLCK).
+         * F_RDLCK, F_WRLCK, and F_UNLCK are defined in <fcntl.h>. If a shared or exclusive
+         * lock cannot be set, fcntl() shall return immediately with a return value of -1.
+         */
+
+      case F_SETLKW:
+        /* This command shall be equivalent to F_SETLK except that if a shared or exclusive
+         * lock is blocked by other locks, the thread shall wait until the request can be
+         * satisfied. If a signal that is to be caught is received while fcntl() is waiting
+         * for a region, fcntl() shall be interrupted. Upon return from the signal handler,
+         * fcntl() shall return -1 with errno set to [EINTR], and the lock operation shall
+         * not be done.
+         */
+
+         err = ENOSYS;
+         break;
+
+      default:
+         err = EINVAL;
+         break;
+  }
+
+  if (err != 0)
+    {
+      errno = err;
+      return ERROR;
+    }
+  return OK;
+}
+