xref: /original-bsd/lib/libc/gen/valloc.3 (revision 79cf7955)
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) 05/12/86

VALLOC 3C ""
C 3
NAME
valloc - aligned memory allocator
SYNOPSIS
 char *valloc(size)  unsigned size; 
DESCRIPTION
Valloc is obsoleted by the current version of malloc, which aligns page-sized and larger allocations.

Valloc allocates size bytes aligned on a page boundary. It is implemented by calling malloc (3) with a slightly larger request, saving the true beginning of the block allocated, and returning a properly aligned pointer.

DIAGNOSTICS
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.
BUGS
Vfree isn't implemented.