config_cache.h

Go to the documentation of this file.

/*

  Copyright (C) 2000, 2001 Silicon Graphics, Inc.  All Rights Reserved.

  This program is free software; you can redistribute it and/or modify it
  under the terms of version 2 of the GNU General Public License as
  published by the Free Software Foundation.

  This program is distributed in the hope that it would be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  

  Further, this software is distributed without any warranty that it is
  free of the rightful claim of any third person regarding infringement 
  or the like.  Any license provided herein, whether implied or 
  otherwise, applies only to this software file.  Patent licenses, if 
  any, provided herein do not apply to combinations of this program with 
  other software, or any other product whatsoever.  

  You should have received a copy of the GNU General Public License along
  with this program; if not, write the Free Software Foundation, Inc., 59
  Temple Place - Suite 330, Boston MA 02111-1307, USA.

  Contact information:  Silicon Graphics, Inc., 1600 Amphitheatre Pky,
  Mountain View, CA 94043, or:

  http://www.sgi.com

  For further information regarding this notice, see:

  http://oss.sgi.com/projects/GenInfo/NoticeExplan

*/


/* This may look like C code, but it is really -*- C++ -*-
 *
 * ====================================================================
 * ====================================================================
 *
 *
 * Revision history:
 *  14-Nov-96 - Original Version, duplicated from cache_parameters.h.
 *
 * Description:
 *
 * This is the description of the memory hierarcy.  It is only used
 * to determine how to SNL transform and for prefetching.  There's no
 * need to model memory hierarchy levels that are to be ignored during
 * transformation.  E.g. typically, there's no need to model main
 * memory.
 *
 * For instructions on adding new memory hierarchy configuration
 * parameters, see the header for config_lno.h.
 *
 * ====================================================================
 * ====================================================================
 */

#ifndef config_cache_INCLUDED
#define config_cache_INCLUDED

#ifdef _KEEP_RCS_ID
/*REFERENCED*/
#endif /* _KEEP_RCS_ID */

/*
 * NOTE: this file is included by lnodriver.c and therefore needs to be
 * compilable in C.  This is accomplished by declaring everything as structs
 * with public fields, and then having member functions be protected by
 * conditional compilation (conditional on C++).
 */

typedef enum MHD_TYPE {
  MHD_TYPE_NONE=222,
  MHD_TYPE_CACHE,
  MHD_TYPE_MEM
} MHD_TYPE;

typedef struct MHD_LEVEL {
  MHD_TYPE  Type;
  INT64   Size;
  INT64   Effective_Size;
  INT32   Line_Size;
  INT32   Clean_Miss_Penalty;
  INT32   Dirty_Miss_Penalty;
  INT32   Associativity;
  INT32   TLB_Entries;
  INT32   Page_Size;
  BOOL    Prefetch_Level;
  INT32   TLB_Clean_Miss_Penalty;
  INT32   TLB_Dirty_Miss_Penalty;

  double  Typical_Outstanding;
  double  Load_Op_Overlap_1;
  double  Load_Op_Overlap_2;
  INT32   Pct_Excess_Writes_Nonhidable;

  /* Used just for option setting: */
  char *  CS_string;
  BOOL    CMP_Set;      /* Clean_Miss_Penalty was set explicitly */
  BOOL    DMP_Set;      /* Dirty_Miss_Penalty was set explicitly */
  BOOL    Is_Mem_Level;
  BOOL    Is_Mem_Level_Set;
  INT32   Miss_Penalty;
  BOOL    Miss_Penalty_Set;
  BOOL    TLB_CMP_Set;  /* TLB_Clean_Miss_Penalty set explicitly */
  BOOL    TLB_DMP_Set;  /* TLB_Dirty_Miss_Penalty set explicitly */
  INT32   TLB_Miss_Penalty;
  BOOL    TLB_MP_Set;

#if defined(_LANGUAGE_C_PLUS_PLUS)
  MHD_LEVEL() : Type(MHD_TYPE_NONE),
                Size(-1), Line_Size(-1),
                Clean_Miss_Penalty(-1), Dirty_Miss_Penalty(-1),
                Associativity(-1), Effective_Size(-1),
                TLB_Entries(-1), Page_Size(-1), Prefetch_Level (-1),
                TLB_Clean_Miss_Penalty(-1), TLB_Dirty_Miss_Penalty(-1),
                Typical_Outstanding(-1.0),
                Load_Op_Overlap_1(-1.0), Load_Op_Overlap_2(-1.0),
                Pct_Excess_Writes_Nonhidable(-1),
                CS_string (NULL), CMP_Set (FALSE), DMP_Set (FALSE),
                Is_Mem_Level(-1), Is_Mem_Level_Set(FALSE),
                Miss_Penalty(-1), Miss_Penalty_Set(FALSE),
                TLB_CMP_Set (FALSE), TLB_DMP_Set (FALSE),
                TLB_Miss_Penalty(-1), TLB_MP_Set(FALSE) {}
  MHD_LEVEL(MHD_TYPE type, INT64 cs, INT32 ls, INT32 cmp, INT32 dmp,
            INT32 assoc, INT32 entries, INT32 pagesz,
            INT32 tlb_cmp, INT32 tlb_dmp,
            double outstanding, double op_overlap_1, double op_overlap_2,
            INT32 pct_excess_writes_nonhidable);
  MHD_LEVEL(const MHD_LEVEL& x) { *this = x; }
  ~MHD_LEVEL() {}

  MHD_LEVEL& operator = (const MHD_LEVEL&);

  void      Print(FILE* f) const;
  void      Merge_Options(const MHD_LEVEL& o);
  BOOL      Valid() const;
  BOOL      TLB_Valid() const;

 private:
  void      Compute_Effective_Size();
#endif

} MHD_LEVEL;

/* Don't forget to modify config_lno.c as well */
#define MHD_MAX_LEVELS 4

typedef struct MHD {
  INT32     Loop_Overhead_Base;
  INT32     Loop_Overhead_Memref;
  BOOL      Non_Blocking_Loads;
  INT32     TLB_Trustworthiness;
  BOOL      TLB_NoBlocking_Model;
  MHD_LEVEL L[MHD_MAX_LEVELS];

#if defined(_LANGUAGE_C_PLUS_PLUS)
  INT       First();
  INT       Next(INT);
  void      Merge_Options(const MHD&);
  void      Initialize();
  void      Print(FILE*) const;

  MHD() : Non_Blocking_Loads(-1),
          Loop_Overhead_Base(-1),
          Loop_Overhead_Memref(-1),
          TLB_Trustworthiness(-1),
          TLB_NoBlocking_Model(-1) {}
  ~MHD() {}

 private:

  MHD(const MHD&);                /* undefined */
#endif
} MHD;

extern MHD Mhd;
extern MHD Mhd_Options;

#endif /* config_cache_INCLUDED */