4.3BSD/usr/man/man3/valloc.3c

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)valloc.3c	6.2 (Berkeley) 5/12/86
.\"
.TH VALLOC 3C "May 12, 1986"
.UC 3
.SH NAME
valloc \- aligned memory allocator
.SH SYNOPSIS
.nf
.B char *valloc(size)
.B unsigned size;
.fi
.SH DESCRIPTION
.ft B
Valloc is obsoleted by the current version of malloc,
which aligns page-sized and larger allocations.
.ft R
.PP
.I Valloc
allocates
.I size
bytes aligned on a page boundary.
It is implemented by calling
.IR malloc (3)
with a slightly larger request, saving the true beginning of the block
allocated, and returning a properly aligned pointer.
.SH DIAGNOSTICS
.I Valloc
returns a null pointer (0) if there is no available memory
or if the arena has been detectably corrupted by storing outside the bounds
of a block.
.SH BUGS
.I Vfree
isn't implemented.