Signed-off-by: Alejandro Colomar <[email protected]>
---
man/man3/posix_memalign.3 | 64 ++--------------------------
man/man3/valloc.3 | 89 ++++++++++++++++++++++++++++++++++++++-
2 files changed, 91 insertions(+), 62 deletions(-)
diff --git a/man/man3/posix_memalign.3 b/man/man3/posix_memalign.3
index b3b27e5bb..2f664eb4e 100644
--- a/man/man3/posix_memalign.3
+++ b/man/man3/posix_memalign.3
@@ -5,7 +5,7 @@
.\"
.TH posix_memalign 3 (date) "Linux man-pages (unreleased)"
.SH NAME
-posix_memalign, aligned_alloc, valloc
+posix_memalign, aligned_alloc
\-
allocate aligned memory
.SH LIBRARY
@@ -17,7 +17,6 @@ .SH SYNOPSIS
.P
.BI "int posix_memalign(void **" memptr ", size_t " alignment ", size_t " size
);
.BI "void *aligned_alloc(size_t " alignment ", size_t " size );
-.BI "[[deprecated]] void *valloc(size_t " size );
.fi
.P
.RS -4
@@ -34,17 +33,6 @@ .SH SYNOPSIS
.nf
_ISOC11_SOURCE
.fi
-.P
-.BR valloc ():
-.nf
- Since glibc 2.12:
- (_XOPEN_SOURCE >= 500) && !(_POSIX_C_SOURCE >= 200112L)
- || /* glibc >= 2.19: */ _DEFAULT_SOURCE
- || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
- Before glibc 2.12:
- _BSD_SOURCE || _XOPEN_SOURCE >= 500
-.\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
-.fi
.SH DESCRIPTION
.BR posix_memalign ()
allocates
@@ -74,21 +62,10 @@ .SH DESCRIPTION
.IR alignment ,
which must be a power of two.
.P
-The obsolete function
-.BR valloc ()
-allocates
-.I size
-bytes and returns a pointer to the allocated memory.
-The memory address will be a multiple of the page size.
-It is equivalent to
-.IR "memalign(sysconf(_SC_PAGESIZE),size)" .
-.P
For all of these functions, the memory is not zeroed.
.SH RETURN VALUE
-.BR aligned_alloc (),
-and
-.BR valloc ()
-return a pointer to the allocated memory on success.
+.BR aligned_alloc ()
+returns a pointer to the allocated memory on success.
On error, NULL is returned, and
.I errno
is set
@@ -131,11 +108,6 @@ .SH ATTRIBUTES
.BR aligned_alloc (),
.BR posix_memalign ()
T} Thread safety MT-Safe
-T{
-.na
-.nh
-.BR valloc ()
-T} Thread safety MT-Unsafe init
.TE
.SH STANDARDS
.TP
@@ -145,9 +117,6 @@ .SH STANDARDS
.TP
.BR posix_memalign ()
POSIX.1-2024.
-.TP
-.BR valloc ()
-None.
.SH HISTORY
.TP
.BR aligned_alloc ()
@@ -158,29 +127,12 @@ .SH HISTORY
.BR posix_memalign ()
glibc 2.1.91.
POSIX.1d, POSIX.1-2001.
-.TP
-.BR valloc ()
-glibc 2.0.
-3.0BSD.
-Documented as obsolete in 4.3BSD,
-and as legacy in SUSv2.
.\"
.SS Headers
Everybody agrees that
.BR posix_memalign ()
is declared in
.IR <stdlib.h> .
-.P
-According to SUSv2,
-.BR valloc ()
-is declared in
-.IR <stdlib.h> .
-.\" Libc4,5 and
-glibc declares it in
-.IR <malloc.h> ,
-and also in
-.I <stdlib.h>
-if suitable feature test macros are defined (see above).
.SH NOTES
On many systems there are alignment restrictions, for example, on buffers
used for direct block device I/O.
@@ -200,16 +152,6 @@ .SH NOTES
.BR posix_memalign ()
can be freed using
.BR free (3).
-Some systems provide no way to reclaim memory allocated with
-.BR valloc ()
-(see
-.BR memalign (3)).
-.\" Other systems allow passing the result of
-.\" .IR valloc ()
-.\" to
-.\" .IR free (3),
-.\" but not to
-.\" .IR realloc (3).
.P
The glibc
.BR malloc (3)
diff --git a/man/man3/valloc.3 b/man/man3/valloc.3
index 791d4c801..cc3543612 100644
--- a/man/man3/valloc.3
+++ b/man/man3/valloc.3
@@ -1 +1,88 @@
-.so man3/posix_memalign.3
+'\" t
+.\" Copyright, the authors of the Linux man-pages project
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.TH valloc 3 (date) "Linux man-pages (unreleased)"
+.SH NAME
+valloc
+\-
+page-aligned memory allocation
+.SH LIBRARY
+Standard C library
+.RI ( libc ,\~ \-lc )
+.SH SYNOPSIS
+.nf
+.B #include <stdlib.h>
+.P
+.BI "[[deprecated]] void *valloc(size_t " size );
+.fi
+.P
+.RS -4
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.RE
+.P
+.BR valloc ():
+.nf
+ Since glibc 2.12:
+ (_XOPEN_SOURCE >= 500) && !(_POSIX_C_SOURCE >= 200112L)
+ || /* glibc >= 2.19: */ _DEFAULT_SOURCE
+ || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
+ Before glibc 2.12:
+ _BSD_SOURCE || _XOPEN_SOURCE >= 500
+.\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
+.fi
+.SH DESCRIPTION
+.BR valloc ()
+allocates
+.I size
+bytes and returns a pointer to the allocated memory.
+The memory address will be a multiple of the page size.
+.P
+It is equivalent to
+.IR "memalign(sysconf(_SC_PAGESIZE),size)" .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbx lb lb
+l l l.
+Interface Attribute Value
+T{
+.na
+.nh
+.BR valloc ()
+T} Thread safety MT-Unsafe init
+.TE
+.SH VERSIONS
+According to SUSv2,
+.BR valloc ()
+is declared in
+.IR <stdlib.h> .
+.\" Libc4,5 and
+glibc declares it in
+.IR <malloc.h> ,
+and also in
+.I <stdlib.h>
+if suitable feature test macros are defined (see above).
+.SH STANDARDS
+BSD, GNU.
+.SH HISTORY
+glibc 2.0.
+3.0BSD.
+Documented as obsolete in 4.3BSD,
+and as legacy in SUSv2.
+.\"
+.SH CAVEATS
+See
+.BR memalign (3).
+.\" Other systems allow passing the result of
+.\" .IR valloc ()
+.\" to
+.\" .IR free (3),
+.\" but not to
+.\" .IR realloc (3).
+.SH SEE ALSO
+.BR memalign (3)
--
2.51.0
