firestring_malloc(3) [debian man page]

firestring_malloc(3)					     Library Functions Manual					      firestring_malloc(3)

NAME

       firestring_malloc - malloc(3) with internal result checking

SYNOPSIS

       #include <firestring.h>
       -lfirestring

       void *firestring_malloc(const size_t size)

DESCRIPTION

       firestring_malloc()  acts  exactly  like  malloc(3)  except  that  it detects malloc failures, prints an error and exit(3) with exit status
       EXIT_FAILURE.  In most programs, malloc failures are unrecoverable, and this is the preferred behaviour.

RETURN VALUE

       If firestring_malloc() returns, it always returns a new memory area of size bytes. It never returns NULL.

AUTHOR

       Ian Gulliver <ian@penguinhosting.net>

SEE ALSO

       libfirestring(3)

								    2002-03-31						      firestring_malloc(3)

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 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 that alter
     the standard behavior of the zone.  The returned malloc zone can be used to provide custom allocation and deallocation behavior, and to
     retrieve additional information about the allocations in that zone.

     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