Changeset 623 for trunk/kernel/fs/fatfs.h

Timestamp:

Mar 6, 2019, 4:37:15 PM (5 years ago)

Author:

alain

Message:

Introduce three new types of vsegs (KCODE,KDATA,KDEV)
to map the kernel vsegs in the process VSL and GPT.
This now used by both the TSAR and the I86 architectures.

File:

• trunk/kernel/fs/fatfs.h (modified) (3 diffs)

trunk/kernel/fs/fatfs.h

@@ -309 +309 @@
 
 /*****************************************************************************************
- * This function implements the generic vfs_fs_get_dentry() function for the FATFS.
- *****************************************************************************************
- * It initialises a new child (new inode/dentry couple in Inode Tree), identified
- * by the <child_inode_xp> argument, from the parent directory mapper, identified by the
- * <parent_inode> argument.
+ * This function implements the generic vfs_fs_new_dentry() function for the FATFS.
+ *****************************************************************************************
+ * It initializes a new inode/dentry couple in Inode Tree, attached to the directory
+ * identified by the <parent_inode> argument. The new directory entry is identified
+ * by the <name> argument. The child inode descriptor identified by the <child_inode_xp>
+ * argument, and the dentry descriptor must have been previously allocated.
  * It scan the parent mapper to find the <name> argument.
  * It set the "type", "size", and "extend" fields in inode descriptor.
@@ -324 +325 @@
  * @ return 0 if success / return ENOENT if child not found.
  ****************************************************************************************/
-error_t fatfs_get_dentry( struct vfs_inode_s * parent_inode,
+error_t fatfs_new_dentry( struct vfs_inode_s * parent_inode,
                           char               * name,
                           xptr_t               child_inode_xp );
 
 /*****************************************************************************************
+ * This function implements the generic vfs_fs_update_dentry() function for the FATFS.
+ *****************************************************************************************
+ * It update the size of a directory entry identified by the <dentry> argument in
+ * the mapper of a directory identified by the <inode> argument, as defined by the <size>
+ * argument.
+ * It scan the mapper to find the entry identified by the dentry "name" field.
+ * It set the "size" field in the in the directory mapper AND marks the page as DIRTY.
+ * It must be called by a thread running in the cluster containing the directory inode.
+ *****************************************************************************************
+ * @ inode        : local pointer on inode (directory).
+ * @ dentry       : local pointer on dentry (for name).
+ * @ size         : new size value.
+ * @ return 0 if success / return ENOENT if child not found.
+ ****************************************************************************************/
+error_t fatfs_update_dentry( struct vfs_inode_s  * inode,
+                             struct vfs_dentry_s * dentry,
+                             uint32_t              size );
+
+/*****************************************************************************************
  * This function implements the generic vfs_fs_get_user_dir() function for the FATFS.
  *****************************************************************************************
  * It is called by the remote_dir_create() function to scan the mapper of a directory 
- * identified by the <inode> argument and copy up to <max_dirent> valid dentries to a 
+ * identified by the <inode> argument, and copy up to <max_dirent> valid dentries to a 
  * local dirent array, defined by the <array> argument. The <min_dentry> argument defines
- * the index of the first dentry to copied to the target dirent array.
+ * the index of the first dentry to be copied to the target dirent array.
  * This function returns in the <entries> buffer the number of dentries actually written,
  * and signals in the <done> buffer when the last valid entry has been found.
  * If the <detailed> argument is true, a dentry/inode couple that does not exist in
- * the Inode Tree is dynamically created, and all dirent fiels are documented in the
+ * the Inode Tree is dynamically created, and all dirent fields are documented in the
  * dirent array. Otherwise, only the dentry name is documented.
  * It must be called by a thread running in the cluster containing the directory inode.
@@ -443 +463 @@
  * The page - and the mapper - can be located in another cluster than the calling thread.
  * The pointer on the mapper and the page index in file are found in the page descriptor.
- * It is used for both for a regular file/directory mapper, and the FAT mapper.
+ * It is used for both a regular file/directory mapper, and the FAT mapper.
  * For the FAT mapper, it access the FATFS to get the location on IOC device.
  * For a regular file, it access the FAT mapper to get the cluster index on IOC device.