summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOndřej Bílka <neleai@seznam.cz>2013-12-18 11:16:47 +0100
committerOndřej Bílka <neleai@seznam.cz>2013-12-18 11:18:19 +0100
commit4d84e6addd62bdc256627af334ba85489112e008 (patch)
tree80f2393fbeb80130ac22b8dd3ea12a2c83f35173
parent1818483b15d22016b0eae41d37ee91cc87b37510 (diff)
Update documentation after dropping PER_THREAD conditional.
In probes documentation we described what happens when PER_THREAD is disabled which is now not relevant.
-rw-r--r--ChangeLog5
-rw-r--r--manual/probes.texi40
2 files changed, 11 insertions, 34 deletions
diff --git a/ChangeLog b/ChangeLog
index da4b5a3b57..84bf75e2da 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2013-12-18 Ondřej Bílka <neleai@seznam.cz>
+
+ * manual/probes.texi: Remove cases when per-thread arenas are
+ disabled.
+
2013-12-18 Andreas Schwab <schwab@suse.de>
* sysdeps/i386/i686/multiarch/strstr.c: Remove.
diff --git a/manual/probes.texi b/manual/probes.texi
index 7ba7bd32c3..437d10dbbe 100644
--- a/manual/probes.texi
+++ b/manual/probes.texi
@@ -23,9 +23,7 @@ arguments.
@section Memory Allocation Probes
These probes are designed to signal relatively unusual situations within
-the virtual memory subsystem of @theglibc{}. The location and the
-availability of some probes depend on whether per-thread arenas are
-enabled (the default) or disabled at the time @theglibc{} is compiled.
+the virtual memory subsystem of @theglibc{}.
@deftp Probe memory_sbrk_more (void *@var{$arg1}, size_t @var{$arg2})
This probe is triggered after the main arena is extended by calling
@@ -116,7 +114,7 @@ arena to reuse, and (temporarily) reserved it for exclusive use.
Argument @var{$arg1} is a pointer to the newly-selected arena, and
@var{$arg2} is a pointer to the arena previously used by that thread.
-When per-thread arenas are enabled, this occurs within
+This occurs within
@code{reused_arena}, right after the mutex mentioned in probe
@code{memory_arena_reuse_wait} is acquired; argument @var{$arg1} will
point to the same arena. In this configuration, this will usually only
@@ -125,11 +123,6 @@ the main arena, but a subsequent allocation from it fails: then, and
only then, may we switch to another arena to retry that allocations, and
for further allocations within that thread.
-When per-thread arenas are disabled, this occurs within
-@code{arena_get2}, whenever the mutex for the previously-selected arena
-cannot be immediately acquired.
-@end deftp
-
@deftp Probe memory_arena_reuse_wait (void *@var{$arg1}, void *@var{$arg2}, void *@var{$arg3})
This probe is triggered when @code{malloc} is about to wait for an arena
to become available for reuse. Argument @var{$arg1} holds a pointer to
@@ -137,7 +130,7 @@ the mutex the thread is going to wait on, @var{$arg2} is a pointer to a
newly-chosen arena to be reused, and @var{$arg3} is a pointer to the
arena previously used by that thread.
-When per-thread arenas are enabled, this occurs within
+This occurs within
@code{reused_arena}, when a thread first tries to allocate memory or
needs a retry after a failure to allocate from the main arena, there
isn't any free arena, the maximum number of arenas has been reached, and
@@ -145,29 +138,10 @@ an existing arena was chosen for reuse, but its mutex could not be
immediately acquired. The mutex in @var{$arg1} is the mutex of the
selected arena.
-When per-thread arenas are disabled, this occurs within
-@code{arena_get2}, when a thread first tries to allocate memory or the
-mutex of the arena it previously used could not be immediately acquired,
-and none of the existing arenas could be immediately reserved for
-exclusive use. The mutex in @var{$arg1} is that of the list of arenas,
-and since the arena won't have been selected yet, @var{$arg2} will be
-@code{NULL}.
-@end deftp
-
@deftp Probe memory_arena_reuse_free_list (void *@var{$arg1})
This probe is triggered when @code{malloc} has chosen an arena that is
in the free list for use by a thread, within the @code{get_free_list}
-function. This probe is only available when @code{malloc} is configured
-to use per-thread arenas. The argument @var{$arg1} holds a pointer to
-the selected arena.
-@end deftp
-
-@deftp Probe memory_arena_reuse_realloc (void *@var{$arg1})
-This probe is triggered within @code{realloc}, as the arena of the
-current thread is changed to match that in which the given address was
-allocated. This probe is @emph{not} available when @code{malloc} is
-configured to use per-thread arenas. The argument @var{$arg1} holds a
-pointer to the newly-selected arena.
+function. The argument @var{$arg1} holds a pointer to the selected arena.
@end deftp
@deftp Probe memory_mallopt (int @var{$arg1}, int @var{$arg2})
@@ -237,8 +211,7 @@ This probe is triggered shortly after the @code{memory_mallopt} probe,
when the parameter to be changed is @code{M_ARENA_TEST}, and the
requested value is in an acceptable range. Argument @var{$arg1} is the
requested value, and @var{$arg2} is the previous value of this
-@code{malloc} parameter. This probe is only available when per-thread
-arenas are enabled.
+@code{malloc} parameter.
@end deftp
@deftp Probe memory_mallopt_arena_max (int @var{$arg1}, int @var{$arg2})
@@ -246,8 +219,7 @@ This probe is triggered shortly after the @code{memory_mallopt} probe,
when the parameter to be changed is @code{M_ARENA_MAX}, and the
requested value is in an acceptable range. Argument @var{$arg1} is the
requested value, and @var{$arg2} is the previous value of this
-@code{malloc} parameter. This probe is only available when per-thread
-arenas are enabled.
+@code{malloc} parameter.
@end deftp
@deftp Probe memory_mallopt_free_dyn_thresholds (int @var{$arg1}, int @var{$arg2})