summaryrefslogtreecommitdiff
path: root/newlib/libc/stdlib/mlock.c
diff options
context:
space:
mode:
authorChristopher Faylor <me+cygwin@cgf.cx>2000-02-17 19:39:46 +0000
committerChristopher Faylor <me+cygwin@cgf.cx>2000-02-17 19:39:46 +0000
commit43b55bace5fad27af5da7a99784667363b92c45d (patch)
tree17fe82f6ba0d93b76d10dd73d4945ab81b69db40 /newlib/libc/stdlib/mlock.c
parent8dabd7496a9eeaca2a7180c0a176059ba9229bb2 (diff)
downloadgdb-SNAPSHOT.tar.gz
import newlib-2000-02-17 snapshotnewlib-2000-02-17SNAPSHOT
Diffstat (limited to 'newlib/libc/stdlib/mlock.c')
-rw-r--r--newlib/libc/stdlib/mlock.c50
1 files changed, 50 insertions, 0 deletions
diff --git a/newlib/libc/stdlib/mlock.c b/newlib/libc/stdlib/mlock.c
new file mode 100644
index 00000000000..e7f7242cec1
--- /dev/null
+++ b/newlib/libc/stdlib/mlock.c
@@ -0,0 +1,50 @@
+/*
+FUNCTION
+<<__malloc_lock>>, <<__malloc_unlock>>--lock malloc pool
+
+INDEX
+ __malloc_lock
+INDEX
+ __malloc_unlock
+
+ANSI_SYNOPSIS
+ #include <malloc.h>
+ void __malloc_lock (void *<[reent]>);
+ void __malloc_unlock (void *<[reent]>);
+
+TRAD_SYNOPSIS
+ void __malloc_lock(<[reent]>)
+ char *<[reent]>;
+
+ void __malloc_unlock(<[reent]>)
+ char *<[reent]>;
+
+DESCRIPTION
+The <<malloc>> family of routines call these functions when they need
+to lock the memory pool. The version of these routines supplied in
+the library does not do anything. If multiple threads of execution
+can call <<malloc>>, or if <<malloc>> can be called reentrantly, then
+you need to define your own versions of these functions in order to
+safely lock the memory pool during a call. If you do not, the memory
+pool may become corrupted.
+
+A call to <<malloc>> may call <<__malloc_lock>> recursively; that is,
+the sequence of calls may go <<__malloc_lock>>, <<__malloc_lock>>,
+<<__malloc_unlock>>, <<__malloc_unlock>>. Any implementation of these
+routines must be careful to avoid causing a thread to wait for a lock
+that it already holds.
+*/
+
+#include <malloc.h>
+
+void
+__malloc_lock (ptr)
+ struct _reent *ptr;
+{
+}
+
+void
+__malloc_unlock (ptr)
+ struct _reent *ptr;
+{
+}