GCC Middle and Back End API Reference
params.h File Reference
#include "params.def"
Include dependency graph for params.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  param_info

Macros

#define INVALID_PARAM_VAL   (-1)
#define DEFPARAM(enumerator, option, msgid, default, min, max)   enumerator,
#define PARAM_VALUE(ENUM)   ((int) global_options.x_param_values[(int) ENUM])
#define MAX_INLINE_INSNS_SINGLE   PARAM_VALUE (PARAM_MAX_INLINE_INSNS_SINGLE)
#define MAX_INLINE_INSNS   PARAM_VALUE (PARAM_MAX_INLINE_INSNS)
#define MAX_INLINE_SLOPE   PARAM_VALUE (PARAM_MAX_INLINE_SLOPE)
#define MIN_INLINE_INSNS   PARAM_VALUE (PARAM_MIN_INLINE_INSNS)
#define MAX_INLINE_INSNS_AUTO   PARAM_VALUE (PARAM_MAX_INLINE_INSNS_AUTO)
#define MAX_VARIABLE_EXPANSIONS   PARAM_VALUE (PARAM_MAX_VARIABLE_EXPANSIONS)
#define MIN_VECT_LOOP_BOUND   PARAM_VALUE (PARAM_MIN_VECT_LOOP_BOUND)
#define MAX_DELAY_SLOT_INSN_SEARCH   PARAM_VALUE (PARAM_MAX_DELAY_SLOT_INSN_SEARCH)
#define MAX_DELAY_SLOT_LIVE_SEARCH   PARAM_VALUE (PARAM_MAX_DELAY_SLOT_LIVE_SEARCH)
#define MAX_PENDING_LIST_LENGTH   PARAM_VALUE (PARAM_MAX_PENDING_LIST_LENGTH)
#define MAX_GCSE_MEMORY   ((size_t) PARAM_VALUE (PARAM_MAX_GCSE_MEMORY))
#define MAX_GCSE_INSERTION_RATIO   ((size_t) PARAM_VALUE (PARAM_MAX_GCSE_INSERTION_RATIO))
#define GCSE_AFTER_RELOAD_PARTIAL_FRACTION   PARAM_VALUE (PARAM_GCSE_AFTER_RELOAD_PARTIAL_FRACTION)
#define GCSE_AFTER_RELOAD_CRITICAL_FRACTION   PARAM_VALUE (PARAM_GCSE_AFTER_RELOAD_CRITICAL_FRACTION)
#define GCSE_COST_DISTANCE_RATIO   PARAM_VALUE (PARAM_GCSE_COST_DISTANCE_RATIO)
#define GCSE_UNRESTRICTED_COST   PARAM_VALUE (PARAM_GCSE_UNRESTRICTED_COST)
#define MAX_HOIST_DEPTH   PARAM_VALUE (PARAM_MAX_HOIST_DEPTH)
#define MAX_UNROLLED_INSNS   PARAM_VALUE (PARAM_MAX_UNROLLED_INSNS)
#define MAX_SMS_LOOP_NUMBER   PARAM_VALUE (PARAM_MAX_SMS_LOOP_NUMBER)
#define SMS_MAX_II_FACTOR   PARAM_VALUE (PARAM_SMS_MAX_II_FACTOR)
#define SMS_DFA_HISTORY   PARAM_VALUE (PARAM_SMS_DFA_HISTORY)
#define SMS_LOOP_AVERAGE_COUNT_THRESHOLD   PARAM_VALUE (PARAM_SMS_LOOP_AVERAGE_COUNT_THRESHOLD)
#define INTEGER_SHARE_LIMIT   PARAM_VALUE (PARAM_INTEGER_SHARE_LIMIT)
#define MAX_LAST_VALUE_RTL   PARAM_VALUE (PARAM_MAX_LAST_VALUE_RTL)
#define MIN_VIRTUAL_MAPPINGS   PARAM_VALUE (PARAM_MIN_VIRTUAL_MAPPINGS)
#define VIRTUAL_MAPPINGS_TO_SYMS_RATIO   PARAM_VALUE (PARAM_VIRTUAL_MAPPINGS_TO_SYMS_RATIO)
#define MAX_FIELDS_FOR_FIELD_SENSITIVE   ((size_t) PARAM_VALUE (PARAM_MAX_FIELDS_FOR_FIELD_SENSITIVE))
#define MAX_SCHED_READY_INSNS   PARAM_VALUE (PARAM_MAX_SCHED_READY_INSNS)
#define PREFETCH_LATENCY   PARAM_VALUE (PARAM_PREFETCH_LATENCY)
#define SIMULTANEOUS_PREFETCHES   PARAM_VALUE (PARAM_SIMULTANEOUS_PREFETCHES)
#define L1_CACHE_SIZE   PARAM_VALUE (PARAM_L1_CACHE_SIZE)
#define L1_CACHE_LINE_SIZE   PARAM_VALUE (PARAM_L1_CACHE_LINE_SIZE)
#define L2_CACHE_SIZE   PARAM_VALUE (PARAM_L2_CACHE_SIZE)
#define USE_CANONICAL_TYPES   PARAM_VALUE (PARAM_USE_CANONICAL_TYPES)
#define IRA_MAX_LOOPS_NUM   PARAM_VALUE (PARAM_IRA_MAX_LOOPS_NUM)
#define IRA_MAX_CONFLICT_TABLE_SIZE   PARAM_VALUE (PARAM_IRA_MAX_CONFLICT_TABLE_SIZE)
#define IRA_LOOP_RESERVED_REGS   PARAM_VALUE (PARAM_IRA_LOOP_RESERVED_REGS)
#define SWITCH_CONVERSION_BRANCH_RATIO   PARAM_VALUE (PARAM_SWITCH_CONVERSION_BRANCH_RATIO)
#define LOOP_INVARIANT_MAX_BBS_IN_LOOP   PARAM_VALUE (PARAM_LOOP_INVARIANT_MAX_BBS_IN_LOOP)
#define SLP_MAX_INSNS_IN_BB   PARAM_VALUE (PARAM_SLP_MAX_INSNS_IN_BB)
#define MIN_INSN_TO_PREFETCH_RATIO   PARAM_VALUE (PARAM_MIN_INSN_TO_PREFETCH_RATIO)
#define PREFETCH_MIN_INSN_TO_MEM_RATIO   PARAM_VALUE (PARAM_PREFETCH_MIN_INSN_TO_MEM_RATIO)
#define MIN_NONDEBUG_INSN_UID   PARAM_VALUE (PARAM_MIN_NONDEBUG_INSN_UID)
#define MAX_STORES_TO_SINK   PARAM_VALUE (PARAM_MAX_STORES_TO_SINK)
#define ALLOW_LOAD_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_LOAD_DATA_RACES)
#define ALLOW_STORE_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_STORE_DATA_RACES)
#define ALLOW_PACKED_LOAD_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_PACKED_LOAD_DATA_RACES)
#define ALLOW_PACKED_STORE_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_PACKED_STORE_DATA_RACES)

Typedefs

typedef struct param_info param_info
typedef enum compiler_param compiler_param

Enumerations

enum  compiler_param { DEFPARAM, DEFPARAM }

Functions

size_t get_num_compiler_params (void)
void add_params (const param_info params[], size_t n)
void set_param_value (const char *name, int value, int *params, int *params_set)
void maybe_set_param_value (compiler_param num, int value, int *params, int *params_set)
void set_default_param_value (compiler_param num, int value)
void global_init_params (void)
void finish_params (void)
int default_param_value (compiler_param num)
void init_param_values (int *params)

Variables

param_infocompiler_params

Macro Definition Documentation

#define ALLOW_LOAD_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_LOAD_DATA_RACES)
#define ALLOW_PACKED_LOAD_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_PACKED_LOAD_DATA_RACES)
#define ALLOW_PACKED_STORE_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_PACKED_STORE_DATA_RACES)
#define ALLOW_STORE_DATA_RACES   PARAM_VALUE (PARAM_ALLOW_STORE_DATA_RACES)
#define DEFPARAM (   enumerator,
  option,
  msgid,
  default,
  min,
  max 
)    enumerator,
#define GCSE_AFTER_RELOAD_CRITICAL_FRACTION   PARAM_VALUE (PARAM_GCSE_AFTER_RELOAD_CRITICAL_FRACTION)
#define GCSE_AFTER_RELOAD_PARTIAL_FRACTION   PARAM_VALUE (PARAM_GCSE_AFTER_RELOAD_PARTIAL_FRACTION)
#define GCSE_COST_DISTANCE_RATIO   PARAM_VALUE (PARAM_GCSE_COST_DISTANCE_RATIO)
#define GCSE_UNRESTRICTED_COST   PARAM_VALUE (PARAM_GCSE_UNRESTRICTED_COST)
#define INTEGER_SHARE_LIMIT   PARAM_VALUE (PARAM_INTEGER_SHARE_LIMIT)

Referenced by int_cst_hash_eq().

#define INVALID_PARAM_VAL   (-1)

params.h - Run-time parameters. Copyright (C) 2001-2013 Free Software Foundation, Inc. Written by Mark Mitchell mark@.nosp@m.code.nosp@m.sourc.nosp@m.ery..nosp@m.com.

This file is part of GCC.

GCC 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 3, or (at your option) any later version.

GCC 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 GCC; see the file COPYING3. If not see http://www.gnu.org/licenses/. This module provides a means for setting integral parameters dynamically. Instead of encoding magic numbers in various places, use this module to organize all the magic numbers in a single place. The values of the parameters can be set on the command-line, thereby providing a way to control the amount of effort spent on particular optimization passes, or otherwise tune the behavior of the compiler.

Since their values can be set on the command-line, these parameters should not be used for non-dynamic memory allocation. No parameter shall have this value.

#define IRA_LOOP_RESERVED_REGS   PARAM_VALUE (PARAM_IRA_LOOP_RESERVED_REGS)
#define IRA_MAX_CONFLICT_TABLE_SIZE   PARAM_VALUE (PARAM_IRA_MAX_CONFLICT_TABLE_SIZE)
#define IRA_MAX_LOOPS_NUM   PARAM_VALUE (PARAM_IRA_MAX_LOOPS_NUM)
#define L1_CACHE_LINE_SIZE   PARAM_VALUE (PARAM_L1_CACHE_LINE_SIZE)
#define L1_CACHE_SIZE   PARAM_VALUE (PARAM_L1_CACHE_SIZE)
#define L2_CACHE_SIZE   PARAM_VALUE (PARAM_L2_CACHE_SIZE)
#define LOOP_INVARIANT_MAX_BBS_IN_LOOP   PARAM_VALUE (PARAM_LOOP_INVARIANT_MAX_BBS_IN_LOOP)
#define MAX_DELAY_SLOT_INSN_SEARCH   PARAM_VALUE (PARAM_MAX_DELAY_SLOT_INSN_SEARCH)
#define MAX_DELAY_SLOT_LIVE_SEARCH   PARAM_VALUE (PARAM_MAX_DELAY_SLOT_LIVE_SEARCH)

Referenced by return_insn_p().

#define MAX_FIELDS_FOR_FIELD_SENSITIVE   ((size_t) PARAM_VALUE (PARAM_MAX_FIELDS_FOR_FIELD_SENSITIVE))
#define MAX_GCSE_INSERTION_RATIO   ((size_t) PARAM_VALUE (PARAM_MAX_GCSE_INSERTION_RATIO))
#define MAX_GCSE_MEMORY   ((size_t) PARAM_VALUE (PARAM_MAX_GCSE_MEMORY))

Referenced by print_ldst_list().

#define MAX_HOIST_DEPTH   PARAM_VALUE (PARAM_MAX_HOIST_DEPTH)
#define MAX_INLINE_INSNS   PARAM_VALUE (PARAM_MAX_INLINE_INSNS)
#define MAX_INLINE_INSNS_AUTO   PARAM_VALUE (PARAM_MAX_INLINE_INSNS_AUTO)
#define MAX_INLINE_INSNS_SINGLE   PARAM_VALUE (PARAM_MAX_INLINE_INSNS_SINGLE)

Macros for the various parameters.

#define MAX_INLINE_SLOPE   PARAM_VALUE (PARAM_MAX_INLINE_SLOPE)
#define MAX_LAST_VALUE_RTL   PARAM_VALUE (PARAM_MAX_LAST_VALUE_RTL)
#define MAX_PENDING_LIST_LENGTH   PARAM_VALUE (PARAM_MAX_PENDING_LIST_LENGTH)
#define MAX_SCHED_READY_INSNS   PARAM_VALUE (PARAM_MAX_SCHED_READY_INSNS)
#define MAX_SMS_LOOP_NUMBER   PARAM_VALUE (PARAM_MAX_SMS_LOOP_NUMBER)
#define MAX_STORES_TO_SINK   PARAM_VALUE (PARAM_MAX_STORES_TO_SINK)
#define MAX_UNROLLED_INSNS   PARAM_VALUE (PARAM_MAX_UNROLLED_INSNS)
#define MAX_VARIABLE_EXPANSIONS   PARAM_VALUE (PARAM_MAX_VARIABLE_EXPANSIONS)
#define MIN_INLINE_INSNS   PARAM_VALUE (PARAM_MIN_INLINE_INSNS)
#define MIN_INSN_TO_PREFETCH_RATIO   PARAM_VALUE (PARAM_MIN_INSN_TO_PREFETCH_RATIO)
#define MIN_NONDEBUG_INSN_UID   PARAM_VALUE (PARAM_MIN_NONDEBUG_INSN_UID)

Referenced by mark_label_nuses().

#define MIN_VECT_LOOP_BOUND   PARAM_VALUE (PARAM_MIN_VECT_LOOP_BOUND)
#define MIN_VIRTUAL_MAPPINGS   PARAM_VALUE (PARAM_MIN_VIRTUAL_MAPPINGS)
#define PARAM_VALUE (   ENUM)    ((int) global_options.x_param_values[(int) ENUM])
#define PREFETCH_LATENCY   PARAM_VALUE (PARAM_PREFETCH_LATENCY)
#define PREFETCH_MIN_INSN_TO_MEM_RATIO   PARAM_VALUE (PARAM_PREFETCH_MIN_INSN_TO_MEM_RATIO)
#define SIMULTANEOUS_PREFETCHES   PARAM_VALUE (PARAM_SIMULTANEOUS_PREFETCHES)
#define SLP_MAX_INSNS_IN_BB   PARAM_VALUE (PARAM_SLP_MAX_INSNS_IN_BB)
#define SMS_DFA_HISTORY   PARAM_VALUE (PARAM_SMS_DFA_HISTORY)
#define SMS_LOOP_AVERAGE_COUNT_THRESHOLD   PARAM_VALUE (PARAM_SMS_LOOP_AVERAGE_COUNT_THRESHOLD)
#define SMS_MAX_II_FACTOR   PARAM_VALUE (PARAM_SMS_MAX_II_FACTOR)
#define SWITCH_CONVERSION_BRANCH_RATIO   PARAM_VALUE (PARAM_SWITCH_CONVERSION_BRANCH_RATIO)
#define USE_CANONICAL_TYPES   PARAM_VALUE (PARAM_USE_CANONICAL_TYPES)
#define VIRTUAL_MAPPINGS_TO_SYMS_RATIO   PARAM_VALUE (PARAM_VIRTUAL_MAPPINGS_TO_SYMS_RATIO)

Typedef Documentation

The parameters in use by language-independent code.

typedef struct param_info param_info

The information associated with each parameter.


Enumeration Type Documentation

The parameters in use by language-independent code.

Enumerator:
DEFPARAM 

params.def - Run-time parameters. Copyright (C) 2001-2013 Free Software Foundation, Inc. Written by Mark Mitchell mark@.nosp@m.code.nosp@m.sourc.nosp@m.ery..nosp@m.com.

This file is part of GCC.

GCC 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 3, or (at your option) any later version.

GCC 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 GCC; see the file COPYING3. If not see http://www.gnu.org/licenses/. This file contains definitions for language-independent parameters. The DEFPARAM macro takes 6 arguments:

  • The enumeral corresponding to this parameter.
  • The name that can be used to set this parameter using the command-line option `–param <name>=

'.

  • A help string explaining how the parameter is used.
  • A default value for the parameter.
  • The minimum acceptable value for the parameter.
  • The maximum acceptable value for the parameter (if greater than the minimum).

Be sure to add an entry to invoke.texi summarizing the parameter. When branch is predicted to be taken with probability lower than this threshold (in percent), then it is considered well predictable.

DEFPARAM 

params.def - Run-time parameters. Copyright (C) 2001-2013 Free Software Foundation, Inc. Written by Mark Mitchell mark@.nosp@m.code.nosp@m.sourc.nosp@m.ery..nosp@m.com.

This file is part of GCC.

GCC 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 3, or (at your option) any later version.

GCC 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 GCC; see the file COPYING3. If not see http://www.gnu.org/licenses/. This file contains definitions for language-independent parameters. The DEFPARAM macro takes 6 arguments:

  • The enumeral corresponding to this parameter.
  • The name that can be used to set this parameter using the command-line option `–param <name>=

'.

  • A help string explaining how the parameter is used.
  • A default value for the parameter.
  • The minimum acceptable value for the parameter.
  • The maximum acceptable value for the parameter (if greater than the minimum).

Be sure to add an entry to invoke.texi summarizing the parameter. When branch is predicted to be taken with probability lower than this threshold (in percent), then it is considered well predictable.


Function Documentation

void add_params ( const param_info  params[],
size_t  n 
)

Add the N PARAMS to the current list of compiler parameters.

int default_param_value ( compiler_param  num)

Return the default value of parameter NUM.

void finish_params ( void  )

Note that all parameters have been added and all default values set.

References gcc_assert, and params_finished.

size_t get_num_compiler_params ( void  )

Returns the number of entries in the table, for the use by plugins.

Return the current value of num_compiler_params, for the benefit of plugins that use parameters as features.

void global_init_params ( void  )

Add all parameters and default values that can be set in both the driver and the compiler proper.

References params_finished.

void init_param_values ( int *  params)

Initialize an array PARAMS with default values of the parameters.

void maybe_set_param_value ( compiler_param  num,
int  value,
int *  params,
int *  params_set 
)

Set the value of the parameter given by NUM to VALUE, implicitly, if it has not been set explicitly by the user, in the table PARAMS using PARAMS_SET to indicate which have been explicitly set.

Set the value of the parameter given by NUM to VALUE in PARAMS and PARAMS_SET, implicitly, if it has not been set explicitly by the user.

void set_default_param_value ( compiler_param  num,
int  value 
)

Set the default value of a parameter given by NUM to VALUE, before option processing.

void set_param_value ( const char *  name,
int  value,
int *  params,
int *  params_set 
)

Set the VALUE associated with the parameter given by NAME in the table PARAMS using PARAMS_SET to indicate which have been explicitly set.

Set the VALUE associated with the parameter given by NAME in PARAMS and PARAMS_SET.

 Make sure nobody tries to set a parameter to an invalid value.   
 Scan the parameter table to find a matching entry.   
 If we didn't find this parameter, issue an error message.   

Variable Documentation

param_info* compiler_params

An array containing the compiler parameters and their current values.

params.c - Run-time parameters. Copyright (C) 2001-2013 Free Software Foundation, Inc. Written by Mark Mitchell mark@.nosp@m.code.nosp@m.sourc.nosp@m.ery..nosp@m.com.

This file is part of GCC.

GCC 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 3, or (at your option) any later version.

GCC 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 GCC; see the file COPYING3. If not see http://www.gnu.org/licenses/. An array containing the compiler parameters and their current values.

Referenced by wrap_help().