summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJason King <jason.brian.king@gmail.com>2019-04-19 15:33:24 +0000
committerJason King <jason.brian.king@gmail.com>2019-04-19 15:33:24 +0000
commitd79a44f35cd3fa007564084ebaf25ba1e5f5edf3 (patch)
treebfd3806682908cf9c0ec62a4318f563f159663de
parent1c1e677a902f56dba0db06bc7a4d2d0f7561c90a (diff)
downloadrust-libc-d79a44f35cd3fa007564084ebaf25ba1e5f5edf3.tar.gz
Added doc comment w/ links explaining the difference between 32-bit and 64-bit libc for readdir_r
-rw-r--r--src/unix/mod.rs6
1 files changed, 6 insertions, 0 deletions
diff --git a/src/unix/mod.rs b/src/unix/mod.rs
index b85e8461eb..8c01e9a9f5 100644
--- a/src/unix/mod.rs
+++ b/src/unix/mod.rs
@@ -609,6 +609,12 @@ extern {
#[cfg_attr(target_os = "macos", link_name = "readdir$INODE64")]
#[cfg_attr(target_os = "netbsd", link_name = "__readdir30")]
#[cfg_attr(target_os = "freebsd", link_name = "readdir@FBSD_1.0")]
+ /// The 64-bit libc on Solaris and illumos only has readdir_r. If a
+ /// 32-bit Solaris or illumos target is ever created, it should use
+ /// __posix_readdir_r. See libc(3LIB) on Solaris or illumos:
+ /// https://illumos.org/man/3lib/libc
+ /// https://docs.oracle.com/cd/E36784_01/html/E36873/libc-3lib.html
+ /// https://www.unix.com/man-page/opensolaris/3LIB/libc/
pub fn readdir(dirp: *mut ::DIR) -> *mut ::dirent;
#[cfg_attr(target_os = "macos", link_name = "readdir_r$INODE64")]
#[cfg_attr(target_os = "netbsd", link_name = "__readdir_r30")]