usr/src/lib/libc/gen/valloc.3

.\" 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.3    6.2 (Berkeley) %G%
.\"
.TH VALLOC 3C ""
.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.