bsdmalloc.h

Go to the documentation of this file.

/* =============
 * apeNEXT/nlibc
 * =============
 *
 * $Id: bsdmalloc.h,v 1.6 2005/10/27 20:04:59 morinl Exp $
 * -------------------------------------------------------------------------- */

#ifndef _NLIBC_BSDMALLOC_H_
#define _NLIBC_BSDMALLOC_H_

#include <nlibc.h>

/*
 * Copyright (c) 1983 Regents of the University of California.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *      This product includes software developed by the University of
 *      California, Berkeley and its contributors.
 * 4. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

/*static char *sccsid = "from: @(#)malloc.c     5.11 (Berkeley) 2/23/91";*/

/*
 * malloc.c (Caltech) 2/21/82
 * Chris Kingsley, kingsley@cit-20.
 *
 * This is a very fast storage allocator.  It allocates blocks of a small 
 * number of different sizes, and keeps free lists of each size.  Blocks that
 * don't exactly fit are passed up to the next larger size.  In this 
 * implementation, the available sizes are 2^n-4 (or 2^n-10) bytes long.
 * This is designed for use in a virtual memory environment.
 */

#include <unistd.h>

#if !defined(__cflow_processed) || defined(_uses_getpagesize_bsdmalloc_h)
inline int getpagesize() { 
  return 0x200;
}
#endif // _uses_getpagesize_bsdmalloc_h

static void morecore();
static int findbucket();

/*
 * The overhead on a block is at least 4 bytes.  When free, this space
 * contains a pointer to the next free block, and the bottom two bits must
 * be zero.  When in use, the first byte is set to MAGIC, and the second
 * byte is the size index.  The remaining bytes are for alignment.
 * If range checking is enabled then a second word holds the size of the
 * requested block, less 1, rounded up to a multiple of sizeof(RMAGIC).
 * The order of elements is critical: ov_magic must overlay the low order
 * bits of ov_next, and ov_magic can not be a valid ov_next bit pattern.
 */

// some namespace protection
#define overhead __malloc_overhead
#define pagebucket __malloc_pagebucket
#define pagesz __malloc_pagesz
#define nmalloc __malloc_nmalloc
#define realloc_srchlen __malloc_realloc_srchlen

union   overhead {
        union   overhead *ov_next;      /* when free */
        struct {
                unsigned        ovu_magic;      /* magic number */
                unsigned        ovu_index;      /* bucket # */
#ifdef RCHECK
                unsigned        ovu_rmagic;     /* range magic number */
                unsigned        ovu_size;       /* actual block size */
#endif // RCHECK
        } ovu;
#define ov_magic        ovu.ovu_magic
#define ov_index        ovu.ovu_index
#define ov_rmagic       ovu.ovu_rmagic
#define ov_size         ovu.ovu_size
};

#define MAGIC           0xef            /* magic # on accounting info */
#define RMAGIC          0x5555          /* magic # on range info */

#ifdef RCHECK
#define RSLOP           sizeof (unsigned)
#else
#define RSLOP           0
#endif  // RCHECK


/*
 * nextf[i] is the pointer to the next free block of size 2^(i+3).  The
 * smallest allocatable block is 8 words (128 bytes).  The overhead information
 * precedes the data area returned to the user.
 */
#define NBUCKETS 30
static  union overhead *nextf[NBUCKETS];

static  int pagebucket = 0;             /* page size bucket */
static  int pagesz = 0;                 /* page size */

#ifdef MSTATS
/*
 * nmalloc[i] is the difference between the number of mallocs and frees
 * for a given block size.
 */
static  unsigned nmalloc[NBUCKETS];
#include <stdio.h>
#endif // MSTATS

#if defined(DEBUG) || defined(RCHECK)
#define MALLOC_ASSERT(p)   if (!(p)) botch("p")
#include <stdio.h>

#ifndef __HAS_MAIN
/* extern void botch(char *s); */
#else
#if !defined(__cflow_processed) || defined(_uses_botch_bsdmalloc_h)
static void botch(char *s)
{
        fprintf(stderr, "\r\nassertion botched: %s\r\n", s);
        abort();
}
#endif // _uses_botch_bsdmalloc_h
#endif // Has Main

#else
#define MALLOC_ASSERT(p)
#endif  // DEBUG && RCHECK

#define w_sizeof(OBJ) (sizeof_aligned(OBJ)>>4)

#define malloc(BYTES)  wmalloc(((BYTES)+15)>>4)

#ifndef __HAS_MAIN
extern void * wmalloc(size_t nwords);
#else
#if !defined(__cflow_processed) || defined(_uses_wmalloc_bsdmalloc_h)
void * wmalloc(size_t nwords)
{
        register union overhead *op;
        register int bucket, n;
        register unsigned amt;

        /*
         * First time malloc is called, setup page size and
         * align break pointer so all data will be page aligned.
         * Also, make sure that nextf[] is initialized to zero
         */
        if (pagesz == 0) {
                pagesz = n = getpagesize();
                op = (union overhead *)w_sbrk(w_sizeof(union overhead));
                n = n - w_sizeof(*op) - ((int)op & (n - 1));
                if (n < 0)
                        n += pagesz;
                if (n) {
                        if (w_sbrk(n) == (char *)-1)
                                return (NULL);
                }
                bucket = 0;
                amt = 8;
                while (pagesz > amt) {
                        amt <<= 1;
                        bucket++;
                }
                pagebucket = bucket;
                memset(nextf, 0, NBUCKETS * sizeof_aligned(union overhead *));
#ifdef MSTATS
                memset(nmalloc, 0, NBUCKETS * sizeof_aligned(unsigned));
#endif // MSTATS
        }
        /*
         * Convert amount of memory requested into closest block size
         * stored in hash buckets which satisfies request.
         * Account for space used per block for accounting.
         */
        if (nwords <= (n = pagesz - w_sizeof(*op) - RSLOP)) {
#ifndef RCHECK
                amt = 8;        /* size of first bucket */
                bucket = 0;
#else
                amt = 16;       /* size of first bucket */
                bucket = 1;
#endif // RCHECK
                n = -(int)(w_sizeof(*op) + RSLOP);
        } else {
                amt = pagesz;
                bucket = pagebucket;
        }
        while (nwords > amt + n) {
                amt <<= 1;
                if (amt == 0)
                        return (NULL);
                bucket++;
        }
        /*
         * If nothing in hash bucket right now,
         * request more memory from the system.
         */
        if ((op = nextf[bucket]) == NULL) {
                morecore(bucket);
                if ((op = nextf[bucket]) == NULL)
                        return (NULL);
        }
        /* remove from linked list */
        nextf[bucket] = op->ov_next;
        op->ov_magic = MAGIC;
        op->ov_index = bucket;
#ifdef MSTATS
        nmalloc[bucket]++;
#endif // MSTATS
#ifdef RCHECK
        /*
         * Record allocated size of block and
         * bound space with magic numbers.
         */
        op->ov_size = (nwords + RSLOP - 1) & ~(RSLOP - 1);
        op->ov_rmagic = RMAGIC;
        *(unsigned *)((unsigned)(op + 1) + op->ov_size) = RMAGIC;
#endif // RCHECK
        return ((char *)(op + 1));
}
#endif // _uses_wmalloc_bsdmalloc_h
#endif // Has Main

/*
 * Allocate more memory to the indicated bucket.
 */
#ifndef __HAS_MAIN
#else
#if !defined(__cflow_processed) || defined(_uses_morecore_bsdmalloc_h)
static void morecore(int bucket)
{
        register union overhead *op;
        register int sz;                /* size of desired block [words] */
        int amt;                        /* amount to allocate [words] */
        int nblks;                      /* how many blocks we get */

        sz = 1 << (bucket + 3);
#ifdef DEBUG
        MALLOC_ASSERT(sz > 0);
#else
        if (sz <= 0)
                return;
#endif // DEBUG
        if (sz < pagesz) {
                amt = pagesz;
                nblks = amt / sz;
        } else {
                amt = sz + pagesz;
                nblks = 1;
        }
        op = (union overhead *)w_sbrk(amt);
        /* no more room! */
        if ((int)op == -1)
                return;
        /*
         * Add new memory allocated to that on
         * free list for this hash bucket.
         */
        nextf[bucket] = op;
        while (--nblks > 0) {
                op->ov_next = (union overhead *)((unsigned)op + sz);
                op = (union overhead *)((unsigned)op + sz);
        }
        op->ov_next = NULL;
} 
#endif // _uses_morecore_bsdmalloc_h
#endif // Has Main


#ifndef __HAS_MAIN
extern void free(void *cp);
#else
#if !defined(__cflow_processed) || defined(_uses_free_bsdmalloc_h)
void free(void *cp)
{   
        register int size;
        register union overhead *op;

        if (cp == NULL)
                return;
        op = (union overhead *)((unsigned)cp - w_sizeof (union overhead));
#ifdef DEBUG
        MALLOC_ASSERT(op->ov_magic == MAGIC);           /* make sure it was in use */
#else
        if (op->ov_magic != MAGIC)
                return;                         /* sanity */
#endif // DEBUG
#ifdef RCHECK
        MALLOC_ASSERT(op->ov_rmagic == RMAGIC);
        MALLOC_ASSERT(*(unsigned *)((unsigned)(op + 1) + op->ov_size) == RMAGIC);
#endif // RCHECK
        size = op->ov_index;
        MALLOC_ASSERT(size < NBUCKETS);
        op->ov_next = nextf[size];      /* also clobbers ov_magic */
        nextf[size] = op;
#ifdef MSTATS
        nmalloc[size]--;
#endif // MSTATS
}
#endif // _uses_free_bsdmalloc_h
#endif // Has Main

/*
 * When a program attempts "storage compaction" as mentioned in the
 * old malloc man page, it realloc's an already freed block.  Usually
 * this is the last block it freed; occasionally it might be farther
 * back.  We have to search all the free lists for the block in order
 * to determine its bucket: 1st we make one pass thru the lists
 * checking only the first block in each; if that fails we search
 * ``realloc_srchlen'' blocks in each list for a match (the variable
 * is extern so the caller can modify it).  If that fails we just copy
 * however many bytes was given to realloc() and hope it's not huge.
 */
int realloc_srchlen = 4;        /* 4 should be plenty, -1 =>'s whole list */

#define realloc(PTR, NBYTES)  wrealloc(PTR,((NBYTES)+15)>>4)

#ifndef __HAS_MAIN
extern void *wrealloc(void *cp, size_t nwords);
#else
#if !defined(__cflow_processed) || defined(_uses_wrealloc_bsdmalloc_h)
void *wrealloc(void *cp, size_t nwords)
{
        register unsigned onb;
        register int i;
        union overhead *op;
        char *res;
        int was_alloced = 0;

        if (cp == NULL)
                return (wmalloc(nwords));
        op = (union overhead *)((unsigned)cp - w_sizeof (union overhead));
        if (op->ov_magic == MAGIC) {
                was_alloced++;
                i = op->ov_index;
        } else {
                /*
                 * Already free, doing "compaction".
                 *
                 * Search for the old block of memory on the
                 * free list.  First, check the most common
                 * case (last element free'd), then (this failing)
                 * the last ``realloc_srchlen'' items free'd.
                 * If all lookups fail, then assume the size of
                 * the memory block being realloc'd is the
                 * largest possible (so that all "nwords" of new
                 * memory are copied into).  Note that this could cause
                 * a memory fault if the old area was tiny, and the moon
                 * is gibbous.  However, that is very unlikely.
                 */
                if ((i = findbucket(op, 1)) < 0 &&
                    (i = findbucket(op, realloc_srchlen)) < 0)
                        i = NBUCKETS;
        }
        onb = 1 << (i + 3);
        if (onb < pagesz)
                onb -= w_sizeof (*op) + RSLOP;
        else
                onb += pagesz - w_sizeof (*op) - RSLOP;
        /* avoid the copy if same size block */
        if (was_alloced) {
                if (i) {
                        i = 1 << (i + 2);
                        if (i < pagesz)
                                i -= w_sizeof (*op) + RSLOP;
                        else
                                i += pagesz - w_sizeof (*op) - RSLOP;
                }
                if (nwords <= onb && nwords > i) {
#ifdef RCHECK
                        op->ov_size = (nwords + RSLOP - 1) & ~(RSLOP - 1);
                        *(unsigned *)((unsigned)(op + 1) + op->ov_size) = RMAGIC;
#endif // RCHECK
                        return(cp);
                } else
                        free(cp);
        }
        if ((res = wmalloc(nwords)) == NULL)
                return (NULL);
        if (cp != res)          /* common optimization if "compacting" */
                wmemcpy(res, cp, (nwords < onb) ? nwords : onb);
        return (res);
}
#endif // _uses_realloc_bsdmalloc_h
#endif // Has Main

#define calloc(N,BYTESIZE) wcalloc((N),((BYTESIZE+15)>>4))

#if !defined(__cflow_processed) || defined(_uses_wcalloc_bsdmalloc_h)
inline void *wcalloc(size_t nmemb, size_t words)
{
   void *p = wmalloc( nmemb * words );
   if( p ) { 
        wmemset(p,0,nmemb * words);
   }
   return p;
}
#endif // _uses_wcalloc_bsdmalloc_h

/*
 * Search ``srchlen'' elements of each free list for a block whose
 * header starts at ``freep''.  If srchlen is -1 search the whole list.
 * Return bucket number, or -1 if not found.
 */

#ifndef __HAS_MAIN
#else
#if !defined(__cflow_processed) || defined(_uses_findbucket_bsdmalloc_h)
static int findbucket( union overhead *freep, int srchlen)
{
        register union overhead *p;
        register int i, j;

        for (i = 0; i < NBUCKETS; i++) {
                j = 0;
                for (p = nextf[i]; p && j != srchlen; p = p->ov_next) {
                        if (p == freep)
                                return (i);
                        j++;
                }
        }
        return (-1);
}
#endif // _uses_findbucket_bsdmalloc_h
#endif // Has Main

#ifdef MSTATS
/*
 * mstats - print out statistics about malloc
 * 
 * Prints two lines of numbers, one showing the length of the free list
 * for each size category, the second showing the number of mallocs -
 * frees for each size category.
 */

#ifndef __HAS_MAIN
extern int mstats(char *s);
#else
#if !defined(__cflow_processed) || defined(_uses_mstats_bsdmalloc_h)
int mstats(char *s)
{
        register int i, j;
        register union overhead *p;
        int totfree = 0,
        totused = 0;

        fprintf(stderr, "Memory allocation statistics %s\nfree:\t", s);
        for (i = 0; i < NBUCKETS; i++) {
                for (j = 0, p = nextf[i]; p; p = p->ov_next, j++)
                        ;
                fprintf(stderr, " %d", j);
                totfree += j * (1 << (i + 3));
        }
        fprintf(stderr, "\nused:\t");
        for (i = 0; i < NBUCKETS; i++) {
                fprintf(stderr, " %d", nmalloc[i]);
                totused += nmalloc[i] * (1 << (i + 3));
        }
        fprintf(stderr, "\n\tTotal in use: %d, total free: %d\n",
            totused, totfree);
}
#endif // _uses_mstats_bsdmalloc_h
#endif // Has Main

#endif // MSTATS

#undef overhead
#undef pagebucket
#undef pagesz
#undef nmalloc
#undef realloc_srchlen

#endif // _BSDMALLOC_H_

---