Rename two directories: headers -> posix-headers, functions -> posix-functions.

[gnulib.git] / doc / posix-functions / shmat.texi

diff --git a/doc/posix-functions/shmat.texi b/doc/posix-functions/shmat.texi
new file mode 100644 (file)
index 0000000..3ac0e3c
--- /dev/null
+++ b/doc/posix-functions/shmat.texi
@@ -0,0 +1,26 @@
+@node shmat
+@section @code{shmat}
+@findex shmat
+
+POSIX specification: @url{http://www.opengroup.org/susv3xsh/shmat.html}
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on some platforms:
+mingw, BeOS.
+@item
+Attempts to @code{shmat} into a previously malloc-ed region fail on SunOS 4,
+with @code{errno} set to @code{EINVAL}, even if there is an @code{munmap} call
+in between.
+@item
+On Linux, the flag @code{SHM_REMAP} is needed in order to force @code{shmat}
+to replace existing memory mappings in the specify address range.  On other
+platforms, it is not needed.
+@end itemize