Merge branch 'change/remove-sys_dirent_h-include' into 'master'

change(newlib): prepare dirent.h to remove

Closes IDF-10675 and LLVM-330

See merge request espressif/esp-idf!41608

Author: Lapshin

components/newlib/platform_include/sys/dirent.h

@@ -12,11 +12,7 @@
 #include <errno.h>
 #include <sys/param.h>
 #include <stdlib.h>
-#ifdef __clang__ // TODO LLVM-330
-#include <sys/dirent.h>
-#else
 #include <dirent.h>
-#endif
 #include "unity.h"
 #include "esp_heap_caps.h"
 #include "esp_vfs.h"

components/newlib/test_apps/newlib/main/test_misc.c

@@ -21,11 +21,7 @@
 #include <sys/time.h>
 #include <sys/termios.h>
 #include <sys/poll.h>
-#ifdef __clang__ // TODO LLVM-330
-#include <sys/dirent.h>
-#else
 #include <dirent.h>
-#endif
 #include <string.h>
 #include "sdkconfig.h"
 

components/vfs/include/esp_vfs.h

@@ -19,11 +19,7 @@
 #include <sys/time.h>
 #include <sys/termios.h>
 #include <sys/poll.h>
-#ifdef __clang__ // TODO LLVM-330
-#include <sys/dirent.h>
-#else
 #include <dirent.h>
-#endif
 #include <string.h>
 #include "sdkconfig.h"
 

components/vfs/include/esp_vfs_ops.h

@@ -10,11 +10,7 @@
 #include <string.h>
 #include <errno.h>
 #include <sys/fcntl.h>
-#ifdef __clang__ // TODO LLVM-330
-#include <sys/dirent.h>
-#else
 #include <dirent.h>
-#endif
 #include "esp_vfs.h"
 #include "unity.h"
 #include "esp_log.h"

components/vfs/test_apps/main/test_vfs_paths.c

@@ -93,6 +93,39 @@ Warn when an explicitly defaulted function is deleted by the compiler. That can
        C(const C&&) = default; /* Implicitly deleted.  */
     };
 
+``sys/dirent.h`` No Longer Includes Function Prototypes
+-------------------------------------------------------
+
+Issue
+^^^^^^
+
+Compilation errors may occur in code that previously worked with the old toolchain. For example:
+
+.. code-block:: c
+
+    #include <sys/dirent.h>
+    /* .... */
+    DIR* dir = opendir("test_dir");
+    /* .... */
+    /**
+     * Compile error:
+     * test.c: In function 'test_opendir':
+     * test.c:100:16: error: implicit declaration of function 'opendir' [-Werror=implicit-function-declaration]
+     *   100 |     DIR* dir = opendir(path);
+     *       |                ^~~~~~~
+     */
+
+Solution
+^^^^^^^^^
+
+To resolve this issue, the correct header must be included. Refactor the code like this:
+
+.. code-block:: c
+
+    #include <dirent.h>
+    /* .... */
+    DIR* dir = opendir("test_dir");
+
 Picolibc
 --------
 

docs/en/migration-guides/release-6.x/6.0/toolchain.rst

@@ -93,6 +93,39 @@ GCC 版本更新说明
        C(const C&&) = default; /* 被隐式删除  */
     };
 
+``sys/dirent.h`` 不再包含一些函数原型
+-------------------------------------------------------
+
+问题
+^^^^^^
+
+使用旧工具链的代码可能会出现编译错误。例如：
+
+.. code-block:: c
+
+    #include <sys/dirent.h>
+    /* .... */
+    DIR* dir = opendir("test_dir");
+    /* .... */
+    /**
+     * Compile error:
+     * test.c: In function 'test_opendir':
+     * test.c:100:16: error: implicit declaration of function 'opendir' [-Werror=implicit-function-declaration]
+     *   100 |     DIR* dir = opendir(path);
+     *       |                ^~~~~~~
+     */
+
+解决方法
+^^^^^^^^^
+
+包含正确的头文件即可解决此问题。请将代码重构如下：
+
+.. code-block:: c
+
+    #include <dirent.h>
+    /* .... */
+    DIR* dir = opendir("test_dir");
+
 Picolibc
 --------
 

docs/zh_CN/migration-guides/release-6.x/6.0/toolchain.rst

@@ -433,7 +433,7 @@
     match_to_output: True
 
 -
-    re: "implicit declaration of function '(opendir|readdir|telldir|seekdir|rewinddir|closedir|readdir_r|scandir|alphasort)'"
+    re: "implicit declaration of function '(opendir|readdir|telldir|seekdir|rewinddir|closedir|readdir_r|scandir|alphasort|dirfd|fdclosedir|fdopendir|scandirat|versionsort|posix_getdents)'"
     hint: "Please include <dirent.h> (not <sys/dirent.h>)"
 
 -