Changes between Version 22 and Version 23 of file_system

Timestamp:

Jul 28, 2015, 3:18:00 PM (10 years ago)

Author:

guerin

Comment:

--

file_system

@@ -225 +225 @@
  *  -11 : "cannot remove to_remove node from FS"
 
-=== __int '''_fat_list'''( char* pathname )__ ===
-This function implements the giet_fat_list() system call.
-It displays the content of a directory identified by the pathname argument.
-It returns 0 if success. It returns a negative value if error:
- *   -1  : "FAT not initialised
- *   -2  : "Directory not found"
- *   -3  : "Name in path too long
- *   -4  : "Not a directory"
- *   -5  : "Cannot access directory"
+=== __int '''_fat_opendir'''( char* pathname )__ ===
+This function implements the giet_fat_opendir() system call.
+The semantic is similar to the UNIX opendir() function. If the specified directory does not exist, an error is returned. It allocates a file descriptor to the calling task, for the directory identified by "pathname". If several tasks try to open the same directory, each task obtains a private file descriptor. A node name cannot be larger than 31 characters.
+ * '''pathname''' : directory complete pathname
+Returns a file descriptor for the directory index on success.
+Returns a negative value on error:
+ * GIET_FAT32_NOT_INITIALIZED,
+ * GIET_FAT32_NAME_TOO_LONG,
+ * GIET_FAT32_FILE_NOT_FOUND,
+ * GIET_FAT32_TOO_MANY_OPEN_FILES,
+ * GIET_FAT32_NOT_A_DIRECTORY
+
+=== __int '''_fat_closedir'''( unsigned int fd_id )__ ===
+This function implements the "giet_fat_closedir()" system call.
+Same behavior as _fat_close(), no check for directory.
+ * '''fd_id''' : file descriptor index
+Returns GIET_FAT32_OK on success. Returns a negative value on error:
+ * GIET_FAT32_NOT_INITIALIZED,
+ * GIET_FAT32_INVALID_FD,
+ * GIET_FAT32_NOT_OPEN,
+ * GIET_FAT32_IO_ERROR
+
+=== __int '''_fat_readdir'''( unsigned int fd_id, fat_dirent_t* entry )__ ===
+This function implements the "giet_fat_readdir()" system call.
+It reads one directory entry from the file descriptor opened by "giet_fat_opendir()" and writes its info to the "entry" argument. This includes the cluster, size, is_dir and name info for each entry.
+ * '''fd_id''' : file descriptor index
+ * '''entry''' : pointer to write 
+Returns GIET_FAT32_OK on success. Returns a negative value on error:
+ * GIET_FAT32_NOT_INITIALIZED,
+ * GIET_FAT32_INVALID_FD,
+ * GIET_FAT32_NOT_OPEN,
+ * GIET_FAT32_NOT_A_DIRECTORY,
+ * GIET_FAT32_IO_ERROR,
+ * GIET_FAT32_NO_MORE_ENTRIES
 
 === __int '''_fat_read_no_cache'''( char* pathname , unsigned int buffer_vbase , unsigned int buffer_size )__ ===