Changeset 614 for trunk/kernel/fs/vfs.h

Timestamp:

Jan 15, 2019, 1:59:32 PM (5 years ago)

Author:

alain

Message:

1) introduce a dev_ioc_sync_write() function in IOC API,

to improve the DEVFS synchronous update.

2) fix a big bug in both the user_dir_create() and user_dir_destroy()

functions: add an extended pointer on the reference client process
in the function's arguments.

File:

• trunk/kernel/fs/vfs.h (modified) (5 diffs)

trunk/kernel/fs/vfs.h

@@ -41 +41 @@
 #include <ramfs.h>
 #include <devfs.h>
+#include <dev_ioc.h>
 
 /****  Forward declarations  ***/
@@ -408 +409 @@
  * It must called by a local thread. Use the RPC_DENTRY_CREATE if client thread is remote.
  ******************************************************************************************
- * @ fs_type    : file system type.
- * @ name       : directory entry file/dir name.
+ * @ fs_type    : [in]  file system type.
+ * @ name       : [in]  directory entry file/dir name.
  * @ dentry_xp  : [out] buffer for extended pointer on created dentry.
  * @ return 0 if success / return ENOMEM or EINVAL if error.
@@ -421 +422 @@
  * allocated to the dentry descriptor.
  * It must be executed by a thread running in the cluster containing the dentry.
- * Use the rpc_vfs_dentry_destroy_client() function if required.
+ * Use the RPC_DENTRY_DESTROY if required.
  ****************************************************************************************** 
- * @ dentry  : local pointer on dentry descriptor.
+ * @ dentry  : [in] local pointer on dentry descriptor.
  *****************************************************************************************/
 void vfs_dentry_destroy( vfs_dentry_t *  dentry );  
@@ -875 +876 @@
 
 /******************************************************************************************
+ * This function makes the I/O operation to move one page identified by the <page_xp>
+ * argument to/from the IOC device from/to the mapper, as defined by <cmd_type>.
+ * Depending on the file system type, it calls the proper, FS specific function.
+ * It is used in case of MISS on the mapper, or when a dirty page in the mapper must
+ * be updated in the File System.
+ * The mapper pointer is obtained from the page descriptor.
+ * It can be executed by any thread running in any cluster.
+ * This function does NOT take any lock.
+ ******************************************************************************************
+ * @ page_xp   : extended pointer on page descriptor (for mapper and page_id).
+ * @ cmd_type  : IOC_READ / IOC_WRITE / IOC_SYNC_READ / IOC_SYNC_WRITE
+ * @ returns 0 if success / return -1 if device access failure.
+ *****************************************************************************************/
+error_t vfs_fs_move_page( xptr_t      page_xp,
+                          cmd_type_t  cmd_type );
+
+/******************************************************************************************
  * This function updates the mapper associated to a directory inode identified by the 
  * <parent> argument, to add a new entry identified by the <dentry> argument. 
@@ -1032 +1050 @@
 error_t vfs_fs_release_inode( xptr_t  inode_xp ); 
 
-/******************************************************************************************
- * This function makes the I/O operation to move one page identified by the <page_xp>
- * argument to/from the IOC device from/to the mapper, as defined by <to_mapper>.
- * Depending on the file system type, it calls the proper, FS specific function.
- * It is used in case of MISS on the mapper, or when a dirty page in the mapper must
- * be updated in the File System.
- * The mapper pointer is obtained from the page descriptor.
- * It can be executed by any thread running in any cluster.
- * This function does NOT take any lock.
- ******************************************************************************************
- * @ page_xp   : extended pointer on the page descriptor.
- * @ to_mapper : transfer direction.
- * @ returns 0 if success / return -1 if device access failure.
- *****************************************************************************************/
-error_t vfs_fs_move_page( xptr_t  page_xp,
-                          bool_t  to_mapper );
-
 
 #endif  /* _VFS_H_ */