Mac Developer Library Developer
Search

 

This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




MALLOC_ZONE_MALLOC(3)    BSD Library Functions Manual    MALLOC_ZONE_MALLOC(3)

NAME
     malloc_create_zone, malloc_destroy_zone, malloc_default_zone, malloc_zone_from_ptr, malloc_zone_malloc,
     malloc_zone_calloc, malloc_zone_valloc, malloc_zone_realloc, malloc_zone_memalign, malloc_zone_free --zone-based -zone-based
     zone-based memory allocation

SYNOPSIS
     #include <malloc/malloc.h>

     malloc_zone_t *
     malloc_create_zone(vm_size_t start_size, unsigned flags);

     void
     malloc_destroy_zone(malloc_zone_t *zone);

     malloc_zone_t *
     malloc_default_zone(void);

     malloc_zone_t *
     malloc_zone_from_ptr(const void *ptr);

     void *
     malloc_zone_malloc(malloc_zone_t *zone, size_t size);

     void *
     malloc_zone_calloc(malloc_zone_t *zone, size_t num_items, size_t size);

     void *
     malloc_zone_valloc(malloc_zone_t *zone, size_t size);

     void *
     malloc_zone_realloc(malloc_zone_t *zone, void *ptr, size_t size);

     void *
     malloc_zone_memalign(malloc_zone_t *zone, size_t alignment, size_t size);

     void
     malloc_zone_free(malloc_zone_t *zone, void *ptr);

DESCRIPTION
     The malloc_create_zone() function creates a malloc zone, advising an initial allocation of start_size
     bytes, and specifying flags The returned malloc zone can be used to provide custom allocation and deal-location deallocation
     location behavior, and to retrieve additional information about the allocations in that zone.  At
     present there are no client settable flag values recognized by malloc_create_zone(), the flags argument
     should always be passed as zero.

     The malloc_destroy_zone() function deallocates all memory associated with objects in zone as well as
     zone itself.

     The malloc_default_zone() function returns the default system malloc zone, used by malloc(3), and
     free(3).

     The malloc_zone_from_ptr() function returns a pointer to the malloc zone which contains ptr or NULL, if
     the pointer does not point to an allocated object in any current malloc zone.

     The malloc_zone_malloc(), malloc_zone_calloc(), malloc_zone_valloc(), malloc_zone_realloc(),
     malloc_zone_memalign(), and malloc_zone_free() perform the same task on zone as their non-prefixed
     variants, malloc(3), calloc(3), valloc(3), realloc(3), posix_memalign(3), and free(3) perform on the
     default system malloc zone.

RETURN VALUES
     The malloc_create_zone(), malloc_default_zone(), and malloc_zone_from_ptr() functions return a pointer
     to a malloc_zone_t structure, or NULL if there was an error.

     The malloc_zone_malloc(), malloc_zone_calloc(), malloc_zone_valloc(), malloc_zone_realloc(), and
     malloc_zone_memalign() functions return a pointer to allocated memory.  If there is an error, they
     return a NULL pointer.  They are not required to set errno.

SEE ALSO
     malloc(3), posix_memalign(3)

BSD                              Aug 13, 2008                              BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback