Changeset 611 for trunk/kernel/syscalls/syscalls.h

Timestamp:

Jan 9, 2019, 3:02:51 PM (5 years ago)

Author:

alain

Message:

Introduce sigificant modifs in VFS to support the <ls> command,
and the . and .. directories entries.

File:

• trunk/kernel/syscalls/syscalls.h (modified) (5 diffs)

trunk/kernel/syscalls/syscalls.h

@@ -328 +328 @@
 /****************************************************************************************** 
  * [23] This function open a directory, that must exist in the file system, returning 
- * a DIR pointer on the directory in user space.
- ******************************************************************************************
- * @ pathname   : pathname (can be relative or absolute).
+ * a DIR pointer on the dirent array in user space.
+ ******************************************************************************************
+ * @ pathname   : [in]  pathname (can be relative or absolute).
  * @ dirp       : [out] buffer for pointer on user directory (DIR).
  * @ return 0 if success / returns -1 if failure.
@@ -341 +341 @@
  * next directory entry in the directory identified by the <dirp> argument.
  ******************************************************************************************
- * @ dirp     : user pointer identifying the searched directory.
- * @ dentp    : [out] buffer for pointer on user direntory entry (dirent).
+ * @ dirp     : [in]  user pointer on dirent array identifying the open directory.
+ * @ buffer   : [out] pointer on user buffer for a pointer on dirent in user space.
  * @ return O if success / returns -1 if failure.
  *****************************************************************************************/
 int sys_readdir( DIR            * dirp,
-                 struct dirent ** dentp );
+                 struct dirent ** buffer );
 
 /****************************************************************************************** 
@@ -352 +352 @@
  * all structures associated with the <dirp> pointer.
  ******************************************************************************************
- * @ dirp     : user pointer identifying the directory.
+ * @ dirp     : [in] user pointer on dirent array identifying the open directory.
  * @ return 0 if success / returns -1 if failure.
  *****************************************************************************************/
@@ -575 +575 @@
  * [43] This debug function displays on the kernel terminal TXT0 an user defined string,
  * or the current state of a kernel structure, identified by the <type> argument.
- * The <arg0> and <arg1> arguments depends on the structure type:
+ * The <arg0>, <arg1>, and <arg2> arguments depends on the structure type:
  * - DISPLAY_STRING          : an user defined string
  * - DISPLAY_VMM             : VSL and GPT for a process identified by <pid>.
@@ -583 +583 @@
  * - DISPLAY_VFS             : all files registered in the VFS cache. 
  * - DISPLAY_CHDEV           : all registered channel devices.
- * - DISPLAY_DQDT            : all DQDT nodes.
+ * - DISPLAY_DQDT            : all DQDT nodes curren values.
+ * - DISPLAY_BUSYLOCKS       : all busylocks taken by one thread.
+ * - DISPLAY_MAPPER          : one page of a given mapper.
  ******************************************************************************************
  * type      : [in] type of display 
  * arg0      : [in] type dependant argument.
  * arg1      : [in] type dependant argument.
+ * arg2      : [in] type dependant argument.
  * @ return 0 if success / return -1 if illegal arguments
  *****************************************************************************************/
 int sys_display( reg_t  type,
                  reg_t  arg0,
-                 reg_t  arg1 );
+                 reg_t  arg1,
+                 reg_t  arg2 );
 
 /******************************************************************************************