Changeset 614 for trunk/kernel/libk/user_dir.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/libk/user_dir.h (modified) (2 diffs)

trunk/kernel/libk/user_dir.h

@@ -70 +70 @@
  * in the reference process descriptor.
  *****************************************************************************************
- * @ ident    : DIR virtual address, used as identifier.
+ * @ ident    : [in] DIR virtual address, used as identifier.
  * @ returns extended pointer on user_dir_t if success / returns XPTR_NULL if not found. 
  ****************************************************************************************/
@@ -77 +77 @@
 /*****************************************************************************************
  * This function allocates memory and initializes a user_dir_t structure in the cluster
- * containing the directory inode identified by the <inode> argument. 
+ * containing the directory inode identified by the <inode> argument and map the
+ * user accessible dirent array in the reference user process VMM, identified by the
+ * <ref_xp> argument. 
  * It must be executed by a thread running in the cluster containing the target inode.
  * Use the RPC_USER_DIR_CREATE when the client thread is remote.
  * It makes the following actions:
- * - the allocation of one user_dir_t descriptor in reference cluster.
+ * - the allocation of one user_dir_t descriptor in the directory inode cluster.
  * - the allocation of one or several physical pages in reference cluster to store 
  *   all directory entries in an array of 64 bytes dirent structures,
  * - the initialisation of this array from informations found in the Inode Tree.
- * - the creation of an user accessible vseg containing this dirent array, and the
- *   mapping of all relevant physical pages in this vseg. 
+ * - the creation of an ANON vseg containing this dirent array in reference process VMM,
+ *   and the mapping of the relevant physical pages in this vseg. 
  * - the registration of the created user_dir_t structure in the xlist rooted 
  *   in the reference process,
  * It returns a local pointer on the created user_dir_t structure.
  *****************************************************************************************
- * @ inode    : local pointer on the directory inode.
+ * @ inode    : [in] local pointer on the directory inode.
+ * @ ref_xp   : [in] extended pointer on the reference user process descriptor. 
  * @ return local pointer on user_dir_t if success / return XPTR_NULL if failure.
  ****************************************************************************************/
-user_dir_t * user_dir_create( struct vfs_inode_s * inode );
+user_dir_t * user_dir_create( struct vfs_inode_s * inode,
+                              xptr_t               ref_xp );
 
 /*****************************************************************************************
  * This function removes a user_dir_t structure from the xlist of user_dir_t
- * structures rooted in the reference process descriptor, and release all memory
- * allocated for the user_dir_t struct in the directory inode cluster,
- * including the dirent array.
+ * structures rooted in the reference process descriptor, release all memory
+ * allocated for the user_dir_t struct in the directory inode cluster, including 
+ * the dirent array, and delete all ANON vseg copies in all process VMM copies,
+ * using parallel RPCs.
  * It must be executed by a thread running in the cluster containing the target inode.
  * Use the RPC_USER_DIR_DESTROY when the client thread is remote.
  *****************************************************************************************
- * @ dir  : local pointer on user_dir_t structure.
+ * @ dir      : [in] local pointer on user_dir_t structure.
+ * @ ref_xp   : [in] extended pointer on the reference user process descriptor. 
  ****************************************************************************************/
-void user_dir_destroy( struct user_dir_s * dir );
+void user_dir_destroy( struct user_dir_s * dir,
+                       xptr_t              ref_xp );