[PATCH v1 07/12] man/man3/{posix_memalign,pvalloc}.3: Split pvalloc() from posix_memalign(3)
From: Alejandro Colomar <alx@kernel.org>
Date: 2025-12-10 12:40:21
Subsystem:
the rest · Maintainer:
Linus Torvalds
Signed-off-by: Alejandro Colomar <alx@kernel.org> --- man/man3/posix_memalign.3 | 26 ++++----------------- man/man3/pvalloc.3 | 49 ++++++++++++++++++++++++++++++++++++++- 2 files changed, 52 insertions(+), 23 deletions(-)
diff --git a/man/man3/posix_memalign.3 b/man/man3/posix_memalign.3
index 3271292b7..b3b27e5bb 100644
--- a/man/man3/posix_memalign.3
+++ b/man/man3/posix_memalign.3@@ -5,7 +5,8 @@ .\" .TH posix_memalign 3 (date) "Linux man-pages (unreleased)" .SH NAME -posix_memalign, aligned_alloc, valloc, pvalloc \- +posix_memalign, aligned_alloc, valloc +\- allocate aligned memory .SH LIBRARY Standard C library
@@ -17,10 +18,6 @@ .SH SYNOPSIS .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 ); -.P -.B #include <malloc.h> -.P -.BI "[[deprecated]] void *pvalloc(size_t " size ); .fi .P .RS -4
@@ -86,19 +83,11 @@ .SH DESCRIPTION It is equivalent to .IR "memalign(sysconf(_SC_PAGESIZE),size)" . .P -The obsolete function -.BR pvalloc () -is similar to -.BR valloc (), -but rounds the size of the allocation up to -the next multiple of the system page size. -.P For all of these functions, the memory is not zeroed. .SH RETURN VALUE .BR aligned_alloc (), -.BR valloc (), and -.BR pvalloc () +.BR valloc () return a pointer to the allocated memory on success. On error, NULL is returned, and .I errno
@@ -145,8 +134,7 @@ .SH ATTRIBUTES T{ .na .nh -.BR valloc (), -.BR pvalloc () +.BR valloc () T} Thread safety MT-Unsafe init .TE .SH STANDARDS
@@ -160,9 +148,6 @@ .SH STANDARDS .TP .BR valloc () None. -.TP -.BR pvalloc () -GNU. .SH HISTORY .TP .BR aligned_alloc ()
@@ -179,9 +164,6 @@ .SH HISTORY 3.0BSD. Documented as obsolete in 4.3BSD, and as legacy in SUSv2. -.TP -.BR pvalloc () -glibc 2.0. .\" .SS Headers Everybody agrees that
diff --git a/man/man3/pvalloc.3 b/man/man3/pvalloc.3
index 791d4c801..2f6e21813 100644
--- a/man/man3/pvalloc.3
+++ b/man/man3/pvalloc.3@@ -1 +1,48 @@ -.so man3/posix_memalign.3 +'\" t +.\" Copyright, the authors of the Linux man-pages project +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.TH pvalloc 3 (date) "Linux man-pages (unreleased)" +.SH NAME +pvalloc +\- +page-sized page-aligned memory allocation +.SH LIBRARY +Standard C library +.RI ( libc ,\~ \-lc ) +.SH SYNOPSIS +.nf +.B #include <malloc.h> +.P +.BI "[[deprecated]] void *pvalloc(size_t " size ); +.fi +.SH DESCRIPTION +.BR pvalloc () +is similar to +.BR valloc (), +but rounds the size of the allocation up to +the next multiple of the system page 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 pvalloc () +T} Thread safety MT-Unsafe init +.TE +.SH STANDARDS +GNU. +.SH HISTORY +glibc 2.0. +.SH CAVEATS +See +.BR valloc (3). +.SH SEE ALSO +.BR valloc (3)
--
2.51.0