diff dynload/dynload.3 @ 248:ab23f9f2934a

- BeOS impl for dlGetLibraryPath - more dynload doc clarifications
author Tassilo Philipp
date Fri, 05 May 2017 13:13:43 +0200
parents 2a77747a5496
children 7cb8a0aaf638
line wrap: on
line diff
--- a/dynload/dynload.3	Thu May 04 23:53:05 2017 +0200
+++ b/dynload/dynload.3	Fri May 05 13:13:43 2017 +0200
@@ -78,6 +78,7 @@
 .Ar bufSize
 >= return value > 1, a null-terminted string with the path to the library should be in
 .Ar sOut .
+If it returns 0, the library name wasn't able to be found. Please note that this might happen in some rare cases, so make sure to always check.
 .Pp
 The dlSyms* functions can be used to iterate over symbols. Since they can be used on libraries that are not linked, they are made
 for symbol name lookups, not to get symbols' addresses. For that refer to
@@ -97,9 +98,15 @@
 must point to a loaded symbol.
 .Sh BUGS
 .Fn dlGetLibraryPath
-and
+is not thread-safe on Darwin (macOS, iOS, ...) and OpenBSD.
 .Fn dlSymsInit
-are not thread-safe on Darwin (macOS, iOS, ...).
+is not thread-safe on Darwin.
+.Fn dlGetLibraryPath
+will not work on Haiku when the library in question doesn't have the (default)
+.Fn _init
+and
+.Fn _fini
+symbols exported (rare, but possible).
 .Sh SEE ALSO
 .Xr dyncall 3 ,
 .Xr dyncallback 3