[libcxx] Document windows specifics regarding file_type and perms. NFC.
This was requested in the review of D98138.
Differential Revision: https://reviews.llvm.org/D98155
GitOrigin-RevId: b9f169fb7dcd09721a4487801873a61a1e20da7e
diff --git a/include/filesystem b/include/filesystem
index 58a1ef2..372b28f 100644
--- a/include/filesystem
+++ b/include/filesystem
@@ -276,6 +276,8 @@
uintmax_t available;
};
+// On Windows, the library never identifies files as block, character, fifo
+// or socket.
enum class _LIBCPP_ENUM_VIS file_type : signed char {
none = 0,
not_found = -1,
@@ -289,6 +291,10 @@
unknown = 8
};
+// On Windows, these permission bits map to one single readonly flag per
+// file, and the executable bit is always returned as set. When setting
+// permissions, as long as the write bit is set for either owner, group or
+// others, the readonly flag is cleared.
enum class _LIBCPP_ENUM_VIS perms : unsigned {
none = 0,
