<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>change log for rtems (2010-06-08)</title>
</head>
<body text='#000000' bgcolor='#ffffff'>
<a name='cs1'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
 <font color='#bb2222'><strong>sh</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2010-06-08 Sebastian Huber <sebastian.huber@embedded-brains.de>

        * libfs/src/imfs/imfs_creat.c: Reject creation of FIFOs if support is
        disabled.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/ChangeLog.diff?r1=text&tr1=1.2355&r2=text&tr2=1.2356&diff_format=h">M</a></td><td width='1%'>1.2356</td><td width='100%'>cpukit/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/libfs/src/imfs/imfs_creat.c.diff?r1=text&tr1=1.14&r2=text&tr2=1.15&diff_format=h">M</a></td><td width='1%'>1.15</td><td width='100%'>cpukit/libfs/src/imfs/imfs_creat.c</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/cpukit/ChangeLog:1.2355 rtems/cpukit/ChangeLog:1.2356
--- rtems/cpukit/ChangeLog:1.2355       Tue Jun  8 07:59:50 2010
+++ rtems/cpukit/ChangeLog      Tue Jun  8 10:15:29 2010
</font><font color='#997700'>@@ -1,5 +1,10 @@
</font> 2010-06-08        Sebastian Huber <sebastian.huber@embedded-brains.de>
 
<font color='#000088'>+   * libfs/src/imfs/imfs_creat.c: Reject creation of FIFOs if support is
+       disabled.
+
+2010-06-08     Sebastian Huber <sebastian.huber@embedded-brains.de>
+
</font>   PR 1524/filesystem
        * libcsupport/src/rtems_mkdir.c: New file.
        * libcsupport/src/Makefile.am: Reflect change above.

<font color='#006600'>diff -u rtems/cpukit/libfs/src/imfs/imfs_creat.c:1.14 rtems/cpukit/libfs/src/imfs/imfs_creat.c:1.15
--- rtems/cpukit/libfs/src/imfs/imfs_creat.c:1.14       Tue Jan 19 13:31:00 2010
+++ rtems/cpukit/libfs/src/imfs/imfs_creat.c    Tue Jun  8 10:15:31 2010
</font><font color='#997700'>@@ -45,6 +45,16 @@
</font>   if ( parent_loc == NULL )
     return NULL;
 
<font color='#000088'>+  parent = parent_loc->node_access;
+  fs_info = parent_loc->mt_entry->fs_info;
+
+  /*
+   *  Reject creation of FIFOs if support is disabled.
+   */
+  if ( type == IMFS_FIFO &&
+       fs_info->fifo_handlers == &rtems_filesystem_null_handlers )
+    return NULL;
+
</font>   /*
    *  Allocate filesystem node and fill in basic information
    */
<font color='#997700'>@@ -96,8 +106,6 @@
</font>   /*
    *  This node MUST have a parent, so put it in that directory list.
    */
<font color='#880000'>-  parent       = parent_loc->node_access;
-  fs_info      = parent_loc->mt_entry->fs_info;
</font> 
   node->Parent = parent;
   node->st_ino = ++fs_info->ino_count;
</pre>
<p> </p>
<a name='cs2'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
 <font color='#bb2222'><strong>sh</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2010-06-08 Sebastian Huber <sebastian.huber@embedded-brains.de>

        * libcsupport/include/rtems/libio.h: Documentation.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/ChangeLog.diff?r1=text&tr1=1.2356&r2=text&tr2=1.2357&diff_format=h">M</a></td><td width='1%'>1.2357</td><td width='100%'>cpukit/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/libcsupport/include/rtems/libio.h.diff?r1=text&tr1=1.67&r2=text&tr2=1.68&diff_format=h">M</a></td><td width='1%'>1.68</td><td width='100%'>cpukit/libcsupport/include/rtems/libio.h</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/cpukit/ChangeLog:1.2356 rtems/cpukit/ChangeLog:1.2357
--- rtems/cpukit/ChangeLog:1.2356       Tue Jun  8 10:15:29 2010
+++ rtems/cpukit/ChangeLog      Tue Jun  8 10:39:59 2010
</font><font color='#997700'>@@ -1,5 +1,9 @@
</font> 2010-06-08        Sebastian Huber <sebastian.huber@embedded-brains.de>
 
<font color='#000088'>+   * libcsupport/include/rtems/libio.h: Documentation.
+
+2010-06-08     Sebastian Huber <sebastian.huber@embedded-brains.de>
+
</font>   * libfs/src/imfs/imfs_creat.c: Reject creation of FIFOs if support is
        disabled.
 

<font color='#006600'>diff -u rtems/cpukit/libcsupport/include/rtems/libio.h:1.67 rtems/cpukit/libcsupport/include/rtems/libio.h:1.68
--- rtems/cpukit/libcsupport/include/rtems/libio.h:1.67 Tue Jun  8 07:59:51 2010
+++ rtems/cpukit/libcsupport/include/rtems/libio.h      Tue Jun  8 10:40:00 2010
</font><font color='#997700'>@@ -1,15 +1,12 @@
</font> /**
<font color='#880000'>- * @file rtems/libio.h
</font><font color='#000088'>+ * @file
+ *
+ * @ingroup LibIO
+ *
+ * @brief Basic IO API.
</font>  */
 
 /*
<font color='#880000'>- *  System call and file system interface definition
- *
- *  General purpose communication channel for RTEMS to allow UNIX/POSIX
- *  system call behavior under RTEMS.  Initially this supported only
- *  IO to devices but has since been enhanced to support networking
- *  and support for mounted file systems.
- *
</font>  *  COPYRIGHT (c) 1989-2008.
  *  On-Line Applications Research Corporation (OAR).
  *
<font color='#997700'>@@ -23,41 +20,63 @@
</font> #ifndef _RTEMS_RTEMS_LIBIO_H
 #define _RTEMS_RTEMS_LIBIO_H
 
<font color='#880000'>-#include <rtems.h>
-#include <rtems/chain.h>
</font> #include <sys/types.h>
 #include <sys/stat.h>
 #include <sys/ioctl.h>
 #include <sys/statvfs.h>
 
<font color='#880000'>-/*
- *  Define data types which must be constructed using forward references.
- */
</font><font color='#000088'>+#include <unistd.h>
+#include <termios.h>
</font> 
<font color='#000088'>+#include <rtems.h>
</font> #include <rtems/fs.h>
<font color='#000088'>+#include <rtems/chain.h>
</font> 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
<font color='#880000'>-/*
- * A 64bit file offset for internal use by RTEMS. Based on the newlib type.
</font><font color='#000088'>+/**
+ * @defgroup LibIO IO Library
+ *
+ * @brief Provides system call and file system interface definitions.
+ *
+ * General purpose communication channel for RTEMS to allow UNIX/POSIX
+ * system call behavior under RTEMS.  Initially this supported only
+ * IO to devices but has since been enhanced to support networking
+ * and support for mounted file systems.
+ *
+ * @{
+ */
+
+/**
+ * @brief A 64-bit file offset for internal use by RTEMS. Based on the Newlib
+ * type.
</font>  */
 typedef _off64_t rtems_off64_t;
 
<font color='#880000'>-/*
- * Valid RTEMS file types.
</font><font color='#000088'>+/**
+ * @name File system node types.
+ *
+ * @{
</font>  */
<font color='#000088'>+
</font> #define RTEMS_FILESYSTEM_DIRECTORY   1
 #define RTEMS_FILESYSTEM_DEVICE      2
 #define RTEMS_FILESYSTEM_HARD_LINK   3
 #define RTEMS_FILESYSTEM_SYM_LINK    4
 #define RTEMS_FILESYSTEM_MEMORY_FILE 5
<font color='#000088'>+
+/** @} */
+
</font> typedef int rtems_filesystem_node_types_t;
 
<font color='#880000'>-/*
- *  File Handler Operations Table
</font><font color='#000088'>+/**
+ * @name File System Node Operations
+ *
+ * @{
</font>  */
<font color='#000088'>+
</font> typedef int (*rtems_filesystem_open_t)(
   rtems_libio_t *iop,
   const char    *pathname,
<font color='#997700'>@@ -131,6 +150,11 @@
</font>  rtems_filesystem_location_info_t      *pathloc       /* IN */
 );
 
<font color='#000088'>+/** @} */
+
+/**
+ * @brief File system node operations table.
+ */
</font> struct _rtems_filesystem_file_handlers_r {
     rtems_filesystem_open_t         open_h;
     rtems_filesystem_close_t        close_h;
<font color='#997700'>@@ -148,8 +172,10 @@
</font>     rtems_filesystem_rmnod_t        rmnod_h;
 };
 
<font color='#880000'>-/*
- *  File System Operations Table
</font><font color='#000088'>+/**
+ * @name File System Operations
+ *
+ * @{
</font>  */
 
 /*
<font color='#997700'>@@ -261,12 +287,10 @@
</font>  struct statvfs                    *buf      /* OUT */
 );
 
<font color='#880000'>-/*
- * operations table that must be defined for every file system.
- */
</font><font color='#000088'>+/** @} */
</font> 
<font color='#880000'>-/*
- * File system types
</font><font color='#000088'>+/**
+ * @brief File system operations table.
</font>  */
 struct _rtems_filesystem_operations_table {
     rtems_filesystem_evalpath_t      evalpath_h;
<font color='#997700'>@@ -307,7 +331,10 @@
</font> /**
  * @brief Per file system table entry routine type.
  *
<font color='#880000'>- * Return @c true to continue the iteration, and @c false to stop.
</font><font color='#000088'>+ * @see rtems_filesystem_iterate().
+ *
+ * @retval true Continue the iteration.
+ * @retval false Stop the iteration.
</font>  */
 typedef bool (*rtems_per_filesystem_routine)(
   const rtems_filesystem_table_t *entry,
<font color='#997700'>@@ -327,7 +354,9 @@
</font> );
 
 /**
<font color='#880000'>- * @brief Returns the file system mount handler associated with the @a type, or
</font><font color='#000088'>+ * @brief Gets the mount handler for the file system @a type.
+ *
+ * @return The file system mount handler associated with the @a type, or
</font>  * @c NULL if no such association exists.
  */
 rtems_filesystem_fsmount_me_t
<font color='#997700'>@@ -364,9 +393,9 @@
</font>   const char *type
 );
 
<font color='#880000'>-/*
- *  Structure used to contain file system specific information which
- *  is required to support fpathconf().
</font><font color='#000088'>+/**
+ * @brief Contain file system specific information which is required to support
+ * fpathconf().
</font>  */
 typedef struct {
   int    link_max;                 /* count */
<font color='#997700'>@@ -383,15 +412,16 @@
</font>   int    posix_vdisable;           /* special char processing, 0=no, 1=yes */
 } rtems_filesystem_limits_and_options_t;
 
<font color='#880000'>-/*
- * Default pathconf settings. Override in a filesystem.
</font><font color='#000088'>+/**
+ * @brief Default pathconf settings.
+ *
+ * Override in a filesystem.
</font>  */
 extern const rtems_filesystem_limits_and_options_t rtems_filesystem_default_pathconf;
 
<font color='#880000'>-/*
- * Structure for a mount table entry.
</font><font color='#000088'>+/**
+ * @brief Mount table entry.
</font>  */
<font color='#880000'>-
</font> struct rtems_filesystem_mount_table_entry_tt {
   rtems_chain_node                       Node;
   rtems_filesystem_location_info_t       mt_point_node;
<font color='#997700'>@@ -422,27 +452,27 @@
</font> };
 
 /**
<font color='#880000'>- * The pathconf setting for a file system.
</font><font color='#000088'>+ * @brief The pathconf setting for a file system.
</font>  */
 #define rtems_filesystem_pathconf(_mte) ((_mte)->pathconf_limits_and_options)
 
 /**
<font color='#880000'>- * The type of file system. Its name.
</font><font color='#000088'>+ * @brief The type of file system. Its name.
</font>  */
 #define rtems_filesystem_type(_mte) ((_mte)->type)
 
 /**
<font color='#880000'>- * The mount point of a file system.
</font><font color='#000088'>+ * @brief The mount point of a file system.
</font>  */
 #define rtems_filesystem_mount_point(_mte) ((_mte)->target)
 
 /**
<font color='#880000'>- * The device entry of a file system.
</font><font color='#000088'>+ * @brief The device entry of a file system.
</font>  */
 #define rtems_filesystem_mount_device(_mte) ((_mte)->dev)
 
<font color='#880000'>-/*
- *  Valid RTEMS file systems options
</font><font color='#000088'>+/**
+ * @brief File systems options.
</font>  */
 typedef enum {
   RTEMS_FILESYSTEM_READ_ONLY,
<font color='#997700'>@@ -450,12 +480,13 @@
</font>   RTEMS_FILESYSTEM_BAD_OPTIONS
 } rtems_filesystem_options_t;
 
<font color='#880000'>-
-/*
- *  An open file data structure, indexed by 'fd'
- *  TODO:
- *     should really have a separate per/file data structure that this
- *     points to (eg: size, offset, driver, pathname should be in that)
</font><font color='#000088'>+/**
+ * @brief An open file data structure.
+ *
+ * It will be indexed by 'fd'.
+ *
+ * @todo Should really have a separate per/file data structure that this points
+ * to (eg: size, offset, driver, pathname should be in that)
</font>  */
 struct rtems_libio_tt {
   rtems_driver_name_t                    *driver;
<font color='#997700'>@@ -470,10 +501,11 @@
</font>   const rtems_filesystem_file_handlers_r *handlers;  /* type specific handlers */
 };
 
<font color='#880000'>-/*
- *  param block for read/write
- *  Note: it must include 'offset' instead of using iop's offset since
- *        we can have multiple outstanding i/o's on a device.
</font><font color='#000088'>+/**
+ * @brief Paramameter block for read/write.
+ *
+ * It must include 'offset' instead of using iop's offset since we can have
+ * multiple outstanding i/o's on a device.
</font>  */
 typedef struct {
   rtems_libio_t          *iop;
<font color='#997700'>@@ -484,8 +516,8 @@
</font>   uint32_t                bytes_moved;
 } rtems_libio_rw_args_t;
 
<font color='#880000'>-/*
- *  param block for open/close
</font><font color='#000088'>+/**
+ * @brief Parameter block for open/close.
</font>  */
 typedef struct {
   rtems_libio_t          *iop;
<font color='#997700'>@@ -493,8 +525,8 @@
</font>   uint32_t                mode;
 } rtems_libio_open_close_args_t;
 
<font color='#880000'>-/*
- *  param block for ioctl
</font><font color='#000088'>+/**
+ * @brief Parameter block for ioctl.
</font>  */
 typedef struct {
   rtems_libio_t          *iop;
<font color='#997700'>@@ -503,9 +535,12 @@
</font>   uint32_t                ioctl_return;
 } rtems_libio_ioctl_args_t;
 
<font color='#880000'>-/*
- *  Values for 'flag'
</font><font color='#000088'>+/**
+ * @name Flag Values
+ *
+ * @{
</font>  */
<font color='#000088'>+
</font> #define LIBIO_FLAGS_NO_DELAY      0x0001  /* return immediately if no data */
 #define LIBIO_FLAGS_READ          0x0002  /* reading */
 #define LIBIO_FLAGS_WRITE         0x0004  /* writing */
<font color='#997700'>@@ -515,10 +550,14 @@
</font> #define LIBIO_FLAGS_CLOSE_ON_EXEC 0x0800  /* close on process exec() */
 #define LIBIO_FLAGS_READ_WRITE    (LIBIO_FLAGS_READ | LIBIO_FLAGS_WRITE)
 
<font color='#000088'>+/** @} */
+
</font> void rtems_libio_init(void);
 
<font color='#880000'>-/*
- *  External I/O handlers
</font><font color='#000088'>+/**
+ * @name External I/O Handlers
+ *
+ * @{
</font>  */
 
 typedef int (*rtems_libio_open_t)(
<font color='#997700'>@@ -555,6 +594,14 @@
</font>   int           whence
 );
 
<font color='#000088'>+/** @} */
+
+/**
+ * @name Permission Macros
+ *
+ * @{
+ */
+
</font> /*
  *  The following macros are used to build up the permissions sets
  *  used to check permissions.  These are similar in style to the
<font color='#997700'>@@ -567,11 +614,7 @@
</font> #define RTEMS_LIBIO_PERMS_SEARCH RTEMS_LIBIO_PERMS_EXEC
 #define RTEMS_LIBIO_PERMS_RWX    S_IRWXO
 
<font color='#880000'>-/*
- *  Macros
- */
-
-#include <unistd.h>
</font><font color='#000088'>+/** @} */
</font> 
 union __rtems_dev_t {
   dev_t device;
<font color='#997700'>@@ -632,10 +675,65 @@
</font> 
 void rtems_filesystem_initialize( void );
 
<font color='#000088'>+int unmount(
+  const char *mount_path
+);
+
+int mount(
+  const char                 *source,
+  const char                 *target,
+  const char                 *filesystemtype,
+  rtems_filesystem_options_t options,
+  const void                 *data
+);
+
</font> /*
<font color='#880000'>- * Callbacks from TERMIOS routines to device-dependent code
</font><font color='#000088'>+ *  Boot Time Mount Table Structure
+ */
+
+typedef struct {
+  const char                              *type;
+  rtems_filesystem_options_t               fsoptions;
+  const char                              *device;
+  const char                              *mount_point;
+} rtems_filesystem_mount_table_t;
+
+extern const rtems_filesystem_mount_table_t *rtems_filesystem_mount_table;
+extern const int                             rtems_filesystem_mount_table_size;
+
+typedef void (*rtems_libio_init_functions_t)(void);
+extern  rtems_libio_init_functions_t rtems_libio_init_helper;
+
+void    open_dev_console(void);
+
+typedef void (*rtems_libio_supp_functions_t)(void);
+extern  rtems_libio_supp_functions_t rtems_libio_supp_helper;
+
+typedef void (*rtems_fs_init_functions_t)(void);
+extern  rtems_fs_init_functions_t    rtems_fs_init_helper;
+
+/**
+ * @brief Creates a directory and all its parrent directories according to
+ * @a path.
+ *
+ * The @a mode value selects the access permissions of the directory.
+ *
+ * @retval 0 Successful operation.
+ * @retval -1 An error occured.  @c errno indicates the error.
+ */
+extern int rtems_mkdir(const char *path, mode_t mode);
+
+/** @} */
+
+/**
+ * @defgroup Termios Termios
+ *
+ * @ingroup LibIO
+ *
+ * @brief Termios
+ *
+ * @{
</font>  */
<font color='#880000'>-#include <termios.h>
</font> 
 typedef struct rtems_termios_callbacks {
   int    (*firstOpen)(int major, int minor, void *arg);
<font color='#997700'>@@ -648,9 +746,6 @@
</font>   int    outputUsesInterrupts;
 } rtems_termios_callbacks;
 
<font color='#880000'>-/*
- *  Device-independent TERMIOS routines
- */
</font> void rtems_termios_initialize (void);
 
 /*
<font color='#997700'>@@ -698,53 +793,7 @@
</font>   int   len
 );
 
<font color='#880000'>-int unmount(
-  const char *mount_path
-);
-
-int mount(
-  const char                 *source,
-  const char                 *target,
-  const char                 *filesystemtype,
-  rtems_filesystem_options_t options,
-  const void                 *data
-);
-
-/*
- *  Boot Time Mount Table Structure
- */
-
-typedef struct {
-  const char                              *type;
-  rtems_filesystem_options_t               fsoptions;
-  const char                              *device;
-  const char                              *mount_point;
-} rtems_filesystem_mount_table_t;
-
-extern const rtems_filesystem_mount_table_t *rtems_filesystem_mount_table;
-extern const int                             rtems_filesystem_mount_table_size;
-
-typedef void (*rtems_libio_init_functions_t)(void);
-extern  rtems_libio_init_functions_t rtems_libio_init_helper;
-
-void    open_dev_console(void);
-
-typedef void (*rtems_libio_supp_functions_t)(void);
-extern  rtems_libio_supp_functions_t rtems_libio_supp_helper;
-
-typedef void (*rtems_fs_init_functions_t)(void);
-extern  rtems_fs_init_functions_t    rtems_fs_init_helper;
-
-/**
- * @brief Creates a directory and all its parrent directories according to
- * @a path.
- *
- * The @a mode value selects the access permissions of the directory.
- *
- * @retval 0 Successful operation.
- * @retval -1 An error occured.  @c errno indicates the error.
- */
-extern int rtems_mkdir(const char *path, mode_t mode);
</font><font color='#000088'>+/** @} */
</font> 
 #ifdef __cplusplus
 }
</pre>
<p> </p>

<p>--<br />
<small>Generated by <a href="http://www.codewiz.org/projects/index.html#loginfo">Deluxe Loginfo</a> 2.122 by Bernardo Innocenti <bernie@develer.com></small></p>
</body>
</html>