mem.c

Go to the documentation of this file.

/***********************************************************************
 Freeciv - Copyright (C) 1996 - A Kjeldberg, L Gregersen, P Unold
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.
 
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
***********************************************************************/
 
/**********************************************************************
*
* This module contains freeciv-specific memory management functions
*
**********************************************************************/
 
#ifdef HAVE_CONFIG_H
#include <fc_config.h>
#endif
 
#include <stdlib.h>
#include <string.h>
 
/* utility */
#include "fcintl.h"
#include "log.h"
#include "shared.h"             /* TRUE, FALSE */
 
#include "mem.h"
 
/******************************************************************/
static void handle_alloc_failure(size_t size, const char *called_as,
                                 int line, const char *file)
{
  log_fatal("Out of memory trying to %s " SIZE_T_PRINTF " bytes at line %d of %s.",
            called_as, size, line, file);
 
  exit(EXIT_FAILURE);
}
 
#ifdef FREECIV_DEBUG
/******************************************************************/
static void sanity_check_size(size_t size, const char *called_as,
                              int line, const char *file)
{
  /* There used to be a sanity check here that would abort if more than
   * 30 megabytes were allocated. Unfortunately this didn't work because
   * savegame loading can potentially use a huge amount of memory for large
   * games. Another problem is it doesn't help much because there's nothing
   * preventing a large number of smaller allocations. */
 
  if (size == 0) {
    log_verbose("Warning: %s with size " SIZE_T_PRINTF " at line %d of %s",
                called_as, size, line, file);
  }
}
#endif /* FREECIV_DEBUG */
 
/******************************************************************/
void *fc_real_malloc(size_t size,
                     const char *called_as, int line, const char *file)
{
  void *ptr;
 
#ifdef FREECIV_DEBUG
  sanity_check_size(size, called_as, line, file);
#endif /* FREECIV_DEBUG */
 
  /* Some systems return NULL on malloc(0)
   * According to ANSI C, the return is implementation-specific, 
   * this is a safe guard. Having the extra byte is, of course, harmless. */
#ifndef MALLOC_ZERO_OK
  size = MAX(size, 1);
#endif
 
  ptr = malloc(size);
  if (ptr == NULL) {
    handle_alloc_failure(size, called_as, line, file);
  }
 
  return ptr;
}
 
/******************************************************************/
void *fc_real_realloc(void *ptr, size_t size,
                      const char *called_as, int line, const char *file)
{
  void *new_ptr;
 
  if (!ptr) {
    return fc_real_malloc(size, called_as, line, file);
  }
 
#ifdef FREECIV_DEBUG
  sanity_check_size(size, called_as, line, file);
#endif /* FREECIV_DEBUG */
 
  new_ptr = realloc(ptr, size);
  if (!new_ptr) {
    handle_alloc_failure(size, called_as, line, file);
  }
 
  return new_ptr;
}
 
/******************************************************************/
void *fc_real_calloc(size_t nelem, size_t elsize,
                     const char *called_as, int line, const char *file)
{
  size_t size = nelem * elsize; /* Potential overflow */
  void *ptr;
 
  ptr = fc_real_malloc(size, called_as, line, file);
  memset(ptr, 0, size);
 
  return ptr;
}
 
/******************************************************************/
char *real_fc_strdup(const char *str,
                     const char *called_as, int line, const char *file)
{
  char *dest = fc_real_malloc(strlen(str) + 1, called_as, line, file);
 
  /* No need to check whether dest is non-NULL! */
  strcpy(dest, str);
 
  return dest;
}