CbC/CbC_gcc: gcc/doc/tm.texi.in comparison

comparison gcc/doc/tm.texi.in @ 145:1830386684a0

gcc-9.2.0

author	anatofuz
date	Thu, 13 Feb 2020 11:34:05 +0900
parents	84e7813d76e9
children

comparison

equal deleted inserted replaced

-:84e7813d76e9
+:1830386684a0
-@c Copyright (C) 1988-2018 Free Software Foundation, Inc.
+@c Copyright (C) 1988-2020 Free Software Foundation, Inc.
 @c This is part of the GCC manual.
 @c For copying conditions, see the file gcc.texi.
 @node Target Macros
 @chapter Target Description Macros and Functions
 * Target Attributes::   Defining target-specific uses of @code{__attribute__}.
 * Emulated TLS::        Emulated TLS support.
 * MIPS Coprocessors::   MIPS coprocessor support and how to customize it.
 * PCH Target::          Validity checking for precompiled headers.
 * C++ ABI::             Controlling C++ ABI changes.
+* D Language and ABI::  Controlling D ABI changes.
 * Named Address Spaces:: Adding support for named address spaces
 * Misc::                Everything else.
 @end menu
 @node Target Structure
 @file{common/common-target-def.h}.  If targets initialize
 @code{targetm_common} themselves, they should set
 @code{target_has_targetm_common=yes} in @file{config.gcc}; otherwise a
 default definition is used.
+Similarly, there is a @code{targetdm} variable for hooks that are
+specific to the D language front end, documented as ``D Target Hook''.
+This is declared in @file{d/d-target.h}, the initializer
+@code{TARGETDM_INITIALIZER} in @file{d/d-target-def.h}.  If targets
+initialize @code{targetdm} themselves, they should set
+@code{target_has_targetdm=yes} in @file{config.gcc}; otherwise a default
+definition is used.
 @node Driver
 @section Controlling the Compilation Driver, @file{gcc}
 @cindex driver
 @cindex controlling the compilation driver
 @code{optimize} attribute.
 @end deftypevr
 @hook TARGET_OPTION_INIT_STRUCT
-@hook TARGET_OPTION_DEFAULT_PARAMS
-@hook TARGET_OPTION_VALIDATE_PARAM
 @defmac SWITCHABLE_TARGET
 Some targets need to switch between substantially different subtargets
 during compilation.  For example, the MIPS target has one subtarget for
 the traditional MIPS architecture and another for MIPS16.  Source code
 can switch between these two subarchitectures using the @code{mips16}
 @end defmac
 @defmac MAX_OFILE_ALIGNMENT
 Biggest alignment supported by the object file format of this machine.
 Use this macro to limit the alignment which can be specified using the
-@code{__attribute__ ((aligned (@var{n})))} construct.  If not defined,
+@code{__attribute__ ((aligned (@var{n})))} construct for functions and
-the default value is @code{BIGGEST_ALIGNMENT}.
+objects with static storage duration.  The alignment of automatic
+objects may exceed the object file format maximum up to the maximum
+supported by GCC.  If not defined, the default value is
+@code{BIGGEST_ALIGNMENT}.
 On systems that use ELF, the default (in @file{config/elfos.h}) is
 the largest supported 32-bit ELF section alignment representable on
-a 32-bit host e.g. @samp{(((uint64_t) 1 << 28) * 8)}.
+a 32-bit host e.g.@: @samp{(((uint64_t) 1 << 28) * 8)}.
 On 32-bit ELF the largest supported section alignment in bits is
 @samp{(0x80000000 * 8)}, but this is not representable on 32-bit hosts.
 @end defmac
 @hook TARGET_STATIC_RTX_ALIGNMENT
 function calls.
 If a register has 0 in @code{CALL_USED_REGISTERS}, the compiler
 automatically saves it on function entry and restores it on function
 exit, if the register is used within the function.
+Exactly one of @code{CALL_USED_REGISTERS} and @code{CALL_REALLY_USED_REGISTERS}
+must be defined.  Modern ports should define @code{CALL_REALLY_USED_REGISTERS}.
 @end defmac
 @defmac CALL_REALLY_USED_REGISTERS
 @cindex call-used register
 @cindex call-clobbered register
 @cindex call-saved register
 Like @code{CALL_USED_REGISTERS} except this macro doesn't require
 that the entire set of @code{FIXED_REGISTERS} be included.
 (@code{CALL_USED_REGISTERS} must be a superset of @code{FIXED_REGISTERS}).
-This macro is optional.  If not specified, it defaults to the value
-of @code{CALL_USED_REGISTERS}.
+Exactly one of @code{CALL_USED_REGISTERS} and @code{CALL_REALLY_USED_REGISTERS}
-@end defmac
+must be defined.  Modern ports should define @code{CALL_REALLY_USED_REGISTERS}.
+@end defmac
+@cindex call-used register
+@cindex call-clobbered register
+@cindex call-saved register
+@hook TARGET_FNTYPE_ABI
+@hook TARGET_INSN_CALLEE_ABI
 @cindex call-used register
 @cindex call-clobbered register
 @cindex call-saved register
 @hook TARGET_HARD_REGNO_CALL_PART_CLOBBERED
+@hook TARGET_GET_MULTILIB_ABI_NAME
 @findex fixed_regs
 @findex call_used_regs
 @findex global_regs
 @findex reg_names
 @hook TARGET_SCALAR_MODE_SUPPORTED_P
 @hook TARGET_VECTOR_MODE_SUPPORTED_P
+@hook TARGET_COMPATIBLE_VECTOR_TYPES_P
 @hook TARGET_ARRAY_MODE
 @hook TARGET_ARRAY_MODE_SUPPORTED_P
 @hook TARGET_LIBGCC_FLOATING_MODE_SUPPORTED_P
 @hook TARGET_LOAD_RETURNED_BOUNDS
 @hook TARGET_STORE_RETURNED_BOUNDS
-@hook TARGET_SETUP_INCOMING_VARARG_BOUNDS
 @node Trampolines
 @section Support for Nested Functions
 @cindex support for nested functions
 @cindex trampolines for nested functions
 @cindex descriptors for nested functions
 macro, a reasonable default is used.
 @end defmac
 @hook TARGET_LIBC_HAS_FUNCTION
+@hook TARGET_LIBC_HAS_FAST_FUNCTION
 @defmac NEXT_OBJC_RUNTIME
 Set this macro to 1 to use the "NeXT" Objective-C message sending conventions
 by default.  This calling convention involves passing the object, the selector
 and the method arguments all at once to the method-lookup library function.
 This is the usual setting when targeting Darwin/Mac OS X systems, which have
 @hook TARGET_VECTORIZE_VECTOR_ALIGNMENT_REACHABLE
 @hook TARGET_VECTORIZE_VEC_PERM_CONST
-@hook TARGET_VECTORIZE_BUILTIN_CONVERSION
 @hook TARGET_VECTORIZE_BUILTIN_VECTORIZED_FUNCTION
 @hook TARGET_VECTORIZE_BUILTIN_MD_VECTORIZED_FUNCTION
 @hook TARGET_VECTORIZE_SUPPORT_VECTOR_MISALIGNMENT
 @hook TARGET_VECTORIZE_PREFERRED_SIMD_MODE
 @hook TARGET_VECTORIZE_SPLIT_REDUCTION
-@hook TARGET_VECTORIZE_AUTOVECTORIZE_VECTOR_SIZES
+@hook TARGET_VECTORIZE_AUTOVECTORIZE_VECTOR_MODES
+@hook TARGET_VECTORIZE_RELATED_MODE
 @hook TARGET_VECTORIZE_GET_MASK_MODE
 @hook TARGET_VECTORIZE_EMPTY_MASK_IS_EXPENSIVE
 @hook TARGET_SIMD_CLONE_ADJUST
 @hook TARGET_SIMD_CLONE_USABLE
 @hook TARGET_SIMT_VF
+@hook TARGET_OMP_DEVICE_KIND_ARCH_ISA
 @hook TARGET_GOACC_VALIDATE_DIMS
 @hook TARGET_GOACC_DIM_LIMIT
 when the condition code is set this way some bits (such as the overflow
 bit) are not set in the same way as a test instruction, so that a different
 branch instruction must be used for some conditional branches.  When
 this happens, use the machine mode of the condition code register to
 record different formats of the condition code register.  Modes can
-also be used to record which compare instruction (e.g. a signed or an
+also be used to record which compare instruction (e.g.@: a signed or an
 unsigned comparison) produced the condition codes.
 If other modes than @code{CCmode} are required, add them to
 @file{@var{machine}-modes.def} and define @code{SELECT_CC_MODE} to choose
 a mode given an operand of a compare.  This is needed because the modes
 If this macro is not defined, nothing special is output at the end of
 the jump-table.
 @end defmac
+@hook TARGET_ASM_POST_CFI_STARTPROC
 @hook TARGET_ASM_EMIT_UNWIND_LABEL
 @hook TARGET_ASM_EMIT_EXCEPT_TABLE_LABEL
 @hook TARGET_ASM_EMIT_EXCEPT_PERSONALITY
 @var{lab1} minus @var{lab2}, using an integer of the given @var{size}.
 @end defmac
 @defmac ASM_OUTPUT_DWARF_VMS_DELTA (@var{stream}, @var{size}, @var{label1}, @var{label2})
 A C statement to issue assembly directives that create a difference
-between the two given labels in system defined units, e.g. instruction
+between the two given labels in system defined units, e.g.@: instruction
 slots on IA64 VMS, using an integer of the given size.
 @end defmac
 @defmac ASM_OUTPUT_DWARF_OFFSET (@var{stream}, @var{size}, @var{label}, @var{offset}, @var{section})
 A C statement to issue assembly directives that create a
 on this implementation detail.
 @end defmac
 @hook TARGET_INSERT_ATTRIBUTES
+@hook TARGET_HANDLE_GENERIC_ATTRIBUTE
 @hook TARGET_FUNCTION_ATTRIBUTE_INLINABLE_P
 @hook TARGET_OPTION_VALID_ATTRIBUTE_P
 @hook TARGET_OPTION_SAVE
 @hook TARGET_CXX_USE_ATEXIT_FOR_CXA_ATEXIT
 @hook TARGET_CXX_ADJUST_CLASS_AT_DEFINITION
 @hook TARGET_CXX_DECL_MANGLING_CONTEXT
+@node D Language and ABI
+@section D ABI parameters
+@cindex parameters, d abi
+@hook TARGET_D_CPU_VERSIONS
+@hook TARGET_D_OS_VERSIONS
+@hook TARGET_D_CRITSEC_SIZE
 @node Named Address Spaces
 @section Adding support for named address spaces
 @cindex named address spaces
 @hook TARGET_EXPAND_BUILTIN
 @hook TARGET_RESOLVE_OVERLOADED_BUILTIN
+@hook TARGET_CHECK_BUILTIN_CALL
 @hook TARGET_FOLD_BUILTIN
 @hook TARGET_GIMPLE_FOLD_BUILTIN
 @hook TARGET_COMPARE_VERSION_PRIORITY
 @hook TARGET_GET_FUNCTION_VERSIONS_DISPATCHER
 @hook TARGET_GENERATE_VERSION_DISPATCHER_BODY
+@hook TARGET_PREDICT_DOLOOP_P
+@hook TARGET_HAVE_COUNT_REG_DECR_P
+@hook TARGET_DOLOOP_COST_FOR_GENERIC
+@hook TARGET_DOLOOP_COST_FOR_ADDRESS
 @hook TARGET_CAN_USE_DOLOOP_P
 @hook TARGET_INVALID_WITHIN_DOLOOP
 Define this macro for systems like AIX, where the linker discards
 object files that are not referenced from @code{main} and uses export
 lists.
 @end defmac
-@defmac MODIFY_JNI_METHOD_CALL (@var{mdecl})
-Define this macro to a C expression representing a variant of the
-method call @var{mdecl}, if Java Native Interface (JNI) methods
-must be invoked differently from other methods on your target.
-For example, on 32-bit Microsoft Windows, JNI methods must be invoked using
-the @code{stdcall} calling convention and this macro is then
-defined as this expression:
-@smallexample
-build_type_attribute_variant (@var{mdecl},
-build_tree_list
-(get_identifier ("stdcall"),
-NULL))
-@end smallexample
-@end defmac
 @hook TARGET_CANNOT_MODIFY_JUMPS_P
-@hook TARGET_BRANCH_TARGET_REGISTER_CLASS
-@hook TARGET_BRANCH_TARGET_REGISTER_CALLEE_SAVED
 @hook TARGET_HAVE_CONDITIONAL_EXECUTION
 @hook TARGET_GEN_CCMP_FIRST
 @hook TARGET_PROMOTED_TYPE
 @hook TARGET_CONVERT_TO_TYPE
+@hook TARGET_VERIFY_TYPE_CONTEXT
 @defmac OBJC_JBLEN
 This macro determines the size of the objective C jump buffer for the
 NeXT runtime. By default, OBJC_JBLEN is defined to an innocuous value.
 @end defmac

Mercurial > hg > CbC > CbC_gcc

comparison gcc/doc/tm.texi.in @ 145:1830386684a0