Add long file name parsing logic

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

Documentation/NuttxPortingGuide.html

@@ -12,7 +12,7 @@
       <h1><big><font color="#3c34ec">
         <i>NuttX RTOS Porting Guide</i>
       </font></big></h1>
-      <p>Last Updated: July 12, 2011</p>
+      <p>Last Updated: July 13, 2011</p>
     </td>
   </tr>
 </table>
@@ -3763,6 +3763,19 @@ build
   <li>
     <code>CONFIG_FAT_SECTORSIZE</code>: Max supported sector size.
   </li>
+  <li>
+    <code>CONFIG_FAT_LCNAME</code>: Enable use of the NT-style upper/lower case 8.3 file name support.
+  </li>
+  <li>
+    <code>CONFIG_FAT_LFN</code>: Enable FAT long file names.
+      NOTE:  Microsoft claims patents on FAT long file name technology.
+      Please read the disclaimer in the top-level COPYING file and only enable this feature if you understand these issues.
+  </li>
+  <li>
+    <code>CONFIG_FAT_MAXFNAME</code>: If <code>CONFIG_FAT_LFN</code> is defined, then the default, maximum long file name is 255 bytes.
+      This can eat up a lot of memory (especially stack space).
+      If you are willing to live with some non-standard, short long file names, then define this value.
+  </li>
   <li>
     <code>CONFIG_FS_NXFFS</code>: Enable NuttX FLASH file system (NXFF) support.
   </li>

configs/README.txt

@@ -564,6 +564,17 @@ defconfig -- This is a configuration file similar to the Linux
 	Filesystem configuration
 		CONFIG_FS_FAT - Enable FAT filesystem support
 		CONFIG_FAT_SECTORSIZE - Max supported sector size
+        CONFIG_FAT_LCNAME - Enable use of the NT-style upper/lower case 8.3
+          file name support.
+		CONFIG_FAT_LFN - Enable FAT long file names.  NOTE:  Microsoft claims
+          patents on FAT long file name technology.  Please read the
+          disclaimer in the top-level COPYING file and only enable this
+          feature if you understand these issues.
+        CONFIG_FAT_MAXFNAME - If CONFIG_FAT_LFN is defined, then the
+          default, maximum long file name is 255 bytes.  This can eat up
+          a lot of memory (especially stack space).  If you are willing
+          to live with some non-standard, short long file names, then
+          define this value.
 		CONFIG_FS_NXFFS: Enable NuttX FLASH file system (NXFF) support.
 		CONFIG_NXFFS_ERASEDSTATE: The erased state of FLASH. 
 		  This must have one of the values of 0xff or 0x00.

fs/fat/fs_fat32.h

@@ -732,9 +732,9 @@ struct fat_dirinfo_s
   /* The file/directory name */
 
 #ifdef CONFIG_FAT_LFN
-  uint8_t fd_lfname[LDIR_MAXFNAME]; /* Long filename */
+  uint8_t fd_lfname[LDIR_MAXFNAME+1]; /* Long filename with terminator */
 #endif
-  uint8_t fd_name[DIR_MAXFNAME];   /* Short 8.3 alias filename */
+  uint8_t fd_name[DIR_MAXFNAME];   /* Short 8.3 alias filename (no terminator) */
 
   /* NT flags are not used */