xref: /csrg-svn/lib/libc/stdlib/alloca.3 (revision 61180)
1*61180Sbostic.\" Copyright (c) 1980, 1991, 1993
2*61180Sbostic.\"	The Regents of the University of California.  All rights reserved.
348913Scael.\"
448913Scael.\" %sccs.include.redist.man%
548913Scael.\"
6*61180Sbostic.\"     @(#)alloca.3	8.1 (Berkeley) 06/04/93
748913Scael.\"
848913Scael.Dd
948913Scael.Dt ALLOCA 3
1048913Scael.Os BSD 4
1148913Scael.Sh NAME
1248913Scael.Nm alloca
1348913Scael.Nd memory allocator
1448913Scael.Sh SYNOPSIS
1548913Scael.Fd #include <stdlib.h>
1648913Scael.Ft void *
1748913Scael.Fn alloca "size_t size"
1848913Scael.Sh DESCRIPTION
1948913ScaelThe
2048913Scael.Fn alloca
2148913Scaelfunction
2248913Scaelallocates
2348913Scael.Fa size
2448913Scaelbytes of space in the stack frame of the caller.
2548913ScaelThis temporary space is automatically freed on
2648913Scaelreturn.
2748913Scael.Sh RETURN VALUES
2848913ScaelThe
2948913Scael.Fn alloca
3048913Scaelfunction returns a pointer to the beginning of the allocated space.
3148913ScaelIf the allocation failed, a
3248913Scael.Dv NULL
3348913Scaelpointer is returned.
3448913Scael.Sh SEE ALSO
3548913Scael.Xr brk 2 ,
3648913Scael.Xr pagesize 2
3748913Scael.Xr calloc 3 ,
3848913Scael.Xr malloc 3 ,
3948913Scael.Xr realloc 3 ,
4048913Scael.Sh BUGS
4148913ScaelThe
4248913Scael.Fn alloca
4348913Scaelfunction
4448913Scaelis machine dependent; its use is discouraged.
4548913Scael.\" .Sh HISTORY
4648913Scael.\" The
4748913Scael.\" .Fn alloca
4848913Scael.\" function appeared in
4948913Scael.\" .Bx ?? .
5048913Scael.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd
5148913Scael.\" The first man page (or link to a man page that I can find at the
5248913Scael.\" moment is 4.3...
53