Loading...
--- libmalloc/libmalloc-140.40.1/man/malloc.3
+++ libmalloc/libmalloc-374.40.6/man/malloc.3
@@ -27,7 +27,8 @@
.Nm malloc ,
.Nm realloc ,
.Nm reallocf ,
-.Nm valloc
+.Nm valloc ,
+.Nm aligned_alloc
.Nd memory allocation
.Sh SYNOPSIS
.In stdlib.h
@@ -56,6 +57,11 @@
.Fc
.Ft void *
.Fo valloc
+.Fa "size_t size"
+.Fc
+.Ft void *
+.Fo aligned_alloc
+.Fa "size_t alignment"
.Fa "size_t size"
.Fc
.Sh DESCRIPTION
@@ -70,6 +76,9 @@
The allocated memory is aligned such that it can be used for any data type,
including AltiVec- and SSE-related types.
The
+.Fn aligned_alloc
+function allocates memory with the requested alignment.
+The
.Fn free
function frees allocations that were created via the preceding allocation
functions.
@@ -95,6 +104,14 @@
.Fa size
bytes of memory and returns a pointer to the allocated memory.
The allocated memory is aligned on a page boundary.
+.Pp
+The
+.Fn aligned_alloc
+function allocates
+.Fa size
+bytes of memory with an alignment specified by
+.Fa alignment
+and returns a pointer to the allocated memory.
.Pp
The
.Fn realloc
@@ -154,8 +171,9 @@
.Fn malloc ,
.Fn realloc ,
.Fn reallocf ,
+.Fn valloc ,
and
-.Fn valloc
+.Fn aligned_alloc
functions return a pointer to allocated memory.
If there is an error, they return a
.Dv NULL
@@ -163,6 +181,23 @@
.Va errno
to
.Er ENOMEM .
+.Pp
+In addition,
+.Fn aligned_alloc
+returns a
+.Dv NULL
+pointer and sets
+.Va errno
+to
+.Er EINVAL
+if
+.Fa size
+is not an integral multiple of
+.Fa alignment ,
+or if
+.Fa alignment
+is not a power of 2 at least as large as
+.Fn sizeof "void *" .
.Pp
For
.Fn realloc ,
@@ -183,10 +218,13 @@
The following environment variables change the behavior of the
allocation-related functions.
.Bl -tag -width ".Ev MallocStackLoggingNoCompact"
-.It Ev MallocLogFile <f>
-Create/append messages to the given file path
-.Fa <f>
-instead of writing to the standard error.
+.It Ev MallocDebugReport
+If set, specifies where messages are written. Set to "stderr" to write messages
+to the standard error stream, "none" to discard all messages and "crash" to
+write messages to standard error only for a condition that is about to cause a
+crash. When not set, message are written to the standard error stream if it
+appears to be a terminal (that is, if isatty(STDERR_FILENO) returns a non-zero
+value) and are otherwise discarded.
.It Ev MallocGuardEdges
If set, add a guard page before and after each large block.
.It Ev MallocDoNotProtectPrelude
@@ -227,7 +265,9 @@
freshly allocated memory will fail.
Also if set, fill memory that has been deallocated with 0x55 bytes.
This increases the likelihood that a program will fail due to accessing memory
-that is no longer allocated.
+that is no longer allocated. Note that due to the way in which freed memory is
+managed internally, the 0x55 pattern may not appear in some parts of a
+deallocated memory block.
.It Ev MallocCheckHeapStart <s>
If set, specifies the number of allocations
.Fa <s>