about summary refs log tree commit diff
path: root/manual/llio.texi
diff options
context:
space:
mode:
authorOndřej Bílka <neleai@seznam.cz>2013-12-02 23:32:42 +0100
committerOndřej Bílka <neleai@seznam.cz>2013-12-02 23:33:37 +0100
commit416e014536950a77183013fa4c86cb42dfd322a9 (patch)
treef2f254ad9c69a3ae1ef89a8922ac45e8cb3bda64 /manual/llio.texi
parent9d17796a97dd81fca8f9bdf7dd03b888c2233a37 (diff)
downloadglibc-416e014536950a77183013fa4c86cb42dfd322a9.tar.gz
glibc-416e014536950a77183013fa4c86cb42dfd322a9.tar.xz
glibc-416e014536950a77183013fa4c86cb42dfd322a9.zip
Document shm_open.
Diffstat (limited to 'manual/llio.texi')
-rw-r--r--manual/llio.texi27
1 files changed, 27 insertions, 0 deletions
diff --git a/manual/llio.texi b/manual/llio.texi
index dd0eaa3cb9..b6c926060e 100644
--- a/manual/llio.texi
+++ b/manual/llio.texi
@@ -1471,6 +1471,33 @@ There is no existing mapping in at least part of the given region.
 @end table
 @end deftypefun
 
+@comment sys/mman.h
+@comment POSIX
+@deftypefn Function int shm_open (const char *@var{name}, int @var{oflag}, mode_t @var{mode})
+
+This function returns a file descriptor that can be used to allocate shared
+memory via mmap. Unrelated processes can use same @var{name} to create or
+open existing shared memory objects.
+
+A @var{name} argument specifies the shared memory object to be opened.
+In @theglibc{} it must be a string smaller than @code{NAME_MAX} bytes starting
+with an optional slash but containing no other slashes.
+
+The semantics of @var{oflag} and @var{mode} arguments is same as in @code{open}.
+
+@code{shm_open} returns the file descriptor on success or @math{-1} on error.
+On failure @code{errno} is set.
+@end deftypefn
+
+@deftypefn Function int shm_unlink (const char *@var{name})
+
+This function is inverse of @code{shm_open} and removes the object with
+the given @var{name} previously created by @code{shm_open}.
+
+@code{shm_unlink} returns @math{0} on success or @math{-1} on error.
+On failure @code{errno} is set.
+@end deftypefn
+
 @node Waiting for I/O
 @section Waiting for Input or Output
 @cindex waiting for input or output