Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MALLOC(3)		 BSD Library Functions Manual		     MALLOC(3)

NAME
     malloc, --	general	memory allocation function

SYNOPSIS
     #include <stdlib.h>

     void *
     malloc(size_t size);

DESCRIPTION
     The malloc() function allocates uninitialized space for an	object whose
     size is specified by size.	 The malloc() function maintains multiple
     lists of free blocks according to size, allocating	space from the appro-
     priate list.

     The allocated space is suitably aligned (after possible pointer coercion)
     for storage of any	type of	object.	If the space is	of pagesize or larger,
     the memory	returned will be page-aligned.

RETURN VALUES
     The malloc() function returns a pointer to	the allocated space if suc-
     cessful; otherwise	a null pointer is returned.

SEE ALSO
     brk(2), pagesize(2), free(3), calloc(3), alloca(3), realloc(3), memory(3)

STANDARDS
     The malloc() function conforms to ANSI X3.159-1989	("ANSI C89").

BUGS
     The current implementation	of malloc does not always fail gracefully when
     system memory limits are approached.  It may fail to allocate memory when
     larger free blocks	could be broken	up, or when limits are exceeded	be-
     cause the size is rounded up.  It is optimized for	sizes that are powers
     of	two.

4th Berkeley Distribution	 June 29, 1991	     4th Berkeley Distribution

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | STANDARDS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=malloc&sektion=3&manpath=FreeBSD+1.1.5.1-RELEASE>

home | help