util.h

Go to the documentation of this file.

#ifndef __UTIL_H__
#define __UTIL_H__

/*
 Copyright (c) 2006-2010 Trevor Williams

 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 of the License, 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.

 You should have received a copy of the GNU General Public License along with this program;
 if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#include <stdio.h>

#include "defines.h"
#include "profiler.h"


#define malloc_safe(x)         malloc_safe1(x,__FILE__,__LINE__,profile_index)

#define malloc_safe_nolimit(x) malloc_safe_nolimit1(x,__FILE__,__LINE__,profile_index)

#define strdup_safe(x)         strdup_safe1(x,__FILE__,__LINE__,profile_index)

#define realloc_safe(x,y,z)    realloc_safe1(x,(((x)!=NULL)?y:0),z,__FILE__,__LINE__,profile_index)

#define calloc_safe(x,y)       calloc_safe1(x,y,__FILE__,__LINE__,profile_index)

#ifdef TESTMODE
#define free_safe(x,y)         free_safe2(x,(((x)!=NULL)?y:0),__FILE__, __LINE__,profile_index)
#else
#define free_safe(x,y)         free_safe1(x,profile_index)
#endif


void set_quiet( bool value );

void set_terse( bool value );

void set_debug( bool value );

void set_testmode();

void print_output( const char* msg, int type, const char* file, int line );

bool check_option_value( int argc, const char** argv, int option_index );

bool is_variable( const char* token );

bool is_legal_filename( const char* token );

bool is_func_unit( const char* token );

const char* get_basename( /*@returned@*/ const char* str );

char* get_dirname( char* str );

char* get_absolute_path( const char* filename );

char* get_relative_path( const char* abs_path );

bool directory_exists( const char* dir );

void directory_load( const char* dir, const str_link* ext_head, str_link** file_head, str_link** file_tail );

bool file_exists( const char* file );

bool util_readline(
            FILE*  file,
  /*@out@*/ char** line,
  /*@out@*/ unsigned int*   line_size
);

bool get_quoted_string(
            FILE* file,
  /*@out@*/ char* line
);

char* substitute_env_vars( const char* value );

void scope_extract_front( const char* scope, /*@out@*/char* front, /*@out@*/char* rest );

void scope_extract_back( const char* scope, /*@out@*/char* back, /*@out@*/char* rest );

void scope_extract_scope( const char* scope, const char* front, /*@out@*/char* back );

/*@only@*/ char* scope_gen_printable( const char* str );

bool scope_compare( const char* str1, const char* str2 );

bool scope_local( const char* scope );

str_link* get_next_vfile( str_link* curr, const char* mod );

/*@only@*/ void* malloc_safe1( size_t size, const char* file, int line, unsigned int profile_index );

/*@only@*/ void* malloc_safe_nolimit1( size_t size, const char* file, int line, unsigned int profile_index );

void free_safe1( /*@only@*/ /*@out@*/ /*@null@*/ void* ptr, unsigned int profile_index ) /*@releases ptr@*/;

void free_safe2( /*@only@*/ /*@out@*/ /*@null@*/ void* ptr, size_t size, const char* file, int line, unsigned int profile_index ) /*@releases ptr@*/;

/*@only@*/ char* strdup_safe1( const char* str, const char* file, int line, unsigned int profile_index );

/*@only@*/ void* realloc_safe1(
  /*@null@*/ void*        ptr,
             size_t       old_size,
             size_t       size,
             const char*  file,
             int          line,
             unsigned int profile_index
);

/*@only@*/ void* calloc_safe1(
  size_t       num,
  size_t       size,
  const char*  file,
  int          line,
  unsigned int profile_index
);

void gen_char_string(
  /*@out@*/ char* spaces,
            char  c,
            int   num_spaces
);

char* remove_underscores(
  char* str
);

#ifdef HAVE_SYS_TIME_H

void timer_clear( /*@out@*/ timer** tm );

void timer_start( /*@out@*/ timer** tm );

void timer_stop( /*@out@*/ timer** tm );

char* timer_to_string( timer* tm );
#endif

const char* get_funit_type( int type );

void calc_miss_percent(
            int    hits,
            int    total,
  /*@out@*/ int*   misses,
  /*@out@*/ float* percent );

void set_timestep( sim_time* st, char* value );

void read_command_file(
            const char* cmd_file,
  /*@out@*/ char***     arg_list,
  /*@out@*/ int*        arg_num
);

void gen_exclusion_id(
  char* excl_id,
  char  type,
  int   id
);

#endif