Skip to content

R
riscv-gcc-1
Commit 914d25dc by Joern Rennecke Committed by Joern Rennecke
Options

tm.texi (TARGET_INIT_LIBFUNCS): Put @findex entries in order of appearance. 

	* doc/tm.texi (TARGET_INIT_LIBFUNCS): Put @findex entries in order of
	appearance.

	(TARGET_LEGITIMATE_ADDRESS_P): Add return type.
	Fix markup for strict argument.

	(TARGET_SCHED_REORDER2): Fix argument types.

	(TARGET_SCHED_DFA_PRE_CYCLE_INSN): Fix return type.
	(TARGET_SCHED_DFA_POST_CYCLE_INSN): Likewise.

	(TARGET_SCHED_DFA_PRE_ADVANCE_CYCLE): Fix name.
	(TARGET_SCHED_DFA_POST_ADVANCE_CYCLE): Likewise.

	(TARGET_SCHED_FIRST_CYCLE_MULTIPASS_DFA_LOOKAHEAD_GUARD):
	Add argument name.

	(TARGET_SCHED_ALLOC_SCHED_CONTEXT): Remove duplicate documentation.
	(TARGET_SCHED_INIT_SCHED_CONTEXT): Likewise.
	(TARGET_SCHED_SET_SCHED_CONTEXT): Likewise.
	(TARGET_SCHED_CLEAR_SCHED_CONTEXT): Likewise.
	(TARGET_SCHED_FREE_SCHED_CONTEXT): Likewise.

	(TARGET_SCHED_SET_SCHED_CONTEXT): Fix typo.

	(TARGET_SCHED_GEN_SPEC_CHECK): Fix name.

	(TARGET_ASM_RELOC_RW_MASK): Add return type.
	(TARGET_MANGLE_DECL_ASSEMBLER_NAME): Fix return type.

	(TARGET_STRIP_NAME_ENCODING): Fix markup of return type and parameter.

	(TARGET_ASM_FILE_START): Put @findex before paragraph start.
	Use prototype.

	(TARGET_ASM_NAMED_SECTION): Fix argument list.

	(TARGET_HAVE_NAMED_SECTIONS): Use @deftypevr.
	(TARGET_HAVE_SWITCHABLE_BSS_SECTIONS): Likewise.

	(TARGET_ASM_RECORD_GCC_SWITCHES_SECTION): Use @deftypevr.

	(TARGET_ASM_ASSEMBLE_VISIBILITY): Fix argument types.

	(TARGET_ASM_MARK_DECL_PRESERVED): Fix argument and markup
	referring to it.  Fix language.

	(TARGET_HAVE_CTORS_DTORS): Use @deftypevr.

	(TARGET_ASM_FINAL_POSTSCAN_INSN): Adjust name of first argument.

	(TARGET_ASM_EMIT_UNWIND_LABEL): Add argument types.

	(TARGET_ASM_EMIT_EXCEPT_TABLE_LABEL): Add type to argument.

	(TARGET_UNWIND_EMIT): Remove space between 'FILE *' and
	'@var{stream}.  Remove stray 'and'.

	(TARGET_ARM_EABI_UNWINDER): Use @deftypevr.

	(TARGET_ASM_OUTPUT_DWARF_DTPREL): Adjust name of first argument.

	(TARGET_SET_DEFAULT_TYPE_ATTRIBUTES): Add missing article.

	(TARGET_OPTION_VALID_ATTRIBUTE_P): Fix name, it was 
	misspelled as TARGET_VALID_OPTION_ATTRIBUTE_P.

	(TARGET_GET_PCH_VALIDITY): Put 'void *' in braces.
	Fix description of return value.
	Rename argument "sz" to "len."

	(TARGET_CXX_GUARD_MASK_BIT): Add missing article.
	Clarify meaning of 'true' return value.

	(TARGET_SHIFT_TRUNCATION_MASK): Fix return type.

	(TARGET_MODE_REP_EXTENDED): Fix two inconsisent uses of
	rep_mode versus mode_rep.

	(TARGET_HANDLE_PRAGMA_EXTERN_PREFIX): Document.

	(TARGET_BUILTIN_DECL): Fix name.

	(TARGET_COMMUTATIVE_P): Fix type of first argument.

	(TARGET_SET_CURRENT_FUNCTION): Mention possibility of cfun being NULL.

	(TARGET_BRANCH_TARGET_REGISTER_CLASS): Fix return type.

	(TARGET_USE_LOCAL_THUNK_ALIAS_P): Document as macro instead of hook.

	(TARGET_RELAXED_ORDERING): Use @deftypevr.

	(TARGET_GET_DRAP_RTX): Note that this is a hook.
	Clarify language.

From-SVN: r155972
parent 095ae514
Showing with 167 additions and 86 deletions
gcc/ChangeLog
2010-01-17 Joern Rennecke <amylaar@spamcop.net>
* doc/tm.texi (TARGET_INIT_LIBFUNCS): Put @findex entries in order of
appearance.
(TARGET_LEGITIMATE_ADDRESS_P): Add return type.
Fix markup for strict argument.
(TARGET_SCHED_REORDER2): Fix argument types.
(TARGET_SCHED_DFA_PRE_CYCLE_INSN): Fix return type.
(TARGET_SCHED_DFA_POST_CYCLE_INSN): Likewise.
(TARGET_SCHED_DFA_PRE_ADVANCE_CYCLE): Fix name.
(TARGET_SCHED_DFA_POST_ADVANCE_CYCLE): Likewise.
(TARGET_SCHED_FIRST_CYCLE_MULTIPASS_DFA_LOOKAHEAD_GUARD):
Add argument name.
(TARGET_SCHED_ALLOC_SCHED_CONTEXT): Remove duplicate documentation.
(TARGET_SCHED_INIT_SCHED_CONTEXT): Likewise.
(TARGET_SCHED_SET_SCHED_CONTEXT): Likewise.
(TARGET_SCHED_CLEAR_SCHED_CONTEXT): Likewise.
(TARGET_SCHED_FREE_SCHED_CONTEXT): Likewise.
(TARGET_SCHED_SET_SCHED_CONTEXT): Fix typo.
(TARGET_SCHED_GEN_SPEC_CHECK): Fix name.
(TARGET_ASM_RELOC_RW_MASK): Add return type.
(TARGET_MANGLE_DECL_ASSEMBLER_NAME): Fix return type.
(TARGET_STRIP_NAME_ENCODING): Fix markup of return type and parameter.
(TARGET_ASM_FILE_START): Put @findex before paragraph start.
Use prototype.
(TARGET_ASM_NAMED_SECTION): Fix argument list.
(TARGET_HAVE_NAMED_SECTIONS): Use @deftypevr.
(TARGET_HAVE_SWITCHABLE_BSS_SECTIONS): Likewise.
(TARGET_ASM_RECORD_GCC_SWITCHES_SECTION): Use @deftypevr.
(TARGET_ASM_ASSEMBLE_VISIBILITY): Fix argument types.
(TARGET_ASM_MARK_DECL_PRESERVED): Fix argument and markup
referring to it. Fix language.
(TARGET_HAVE_CTORS_DTORS): Use @deftypevr.
(TARGET_ASM_FINAL_POSTSCAN_INSN): Adjust name of first argument.
(TARGET_ASM_EMIT_UNWIND_LABEL): Add argument types.
(TARGET_ASM_EMIT_EXCEPT_TABLE_LABEL): Add type to argument.
(TARGET_UNWIND_EMIT): Remove space between 'FILE *' and
'@var{stream}. Remove stray 'and'.
(TARGET_ARM_EABI_UNWINDER): Use @deftypevr.
(TARGET_ASM_OUTPUT_DWARF_DTPREL): Adjust name of first argument.
(TARGET_SET_DEFAULT_TYPE_ATTRIBUTES): Add missing article.
(TARGET_OPTION_VALID_ATTRIBUTE_P): Fix name, it was
misspelled as TARGET_VALID_OPTION_ATTRIBUTE_P.
(TARGET_GET_PCH_VALIDITY): Put 'void *' in braces.
Fix description of return value.
Rename argument "sz" to "len."
(TARGET_CXX_GUARD_MASK_BIT): Add missing article.
Clarify meaning of 'true' return value.
(TARGET_SHIFT_TRUNCATION_MASK): Fix return type.
(TARGET_MODE_REP_EXTENDED): Fix two inconsisent uses of
rep_mode versus mode_rep.
(TARGET_HANDLE_PRAGMA_EXTERN_PREFIX): Document.
(TARGET_BUILTIN_DECL): Fix name.
(TARGET_COMMUTATIVE_P): Fix type of first argument.
(TARGET_SET_CURRENT_FUNCTION): Mention possibility of cfun being NULL.
(TARGET_BRANCH_TARGET_REGISTER_CLASS): Fix return type.
(TARGET_USE_LOCAL_THUNK_ALIAS_P): Document as macro instead of hook.
(TARGET_RELAXED_ORDERING): Use @deftypevr.
(TARGET_GET_DRAP_RTX): Note that this is a hook.
Clarify language.
2010-01-16 Harsha Jagasia <harsha.jagasia@amd.com> 2010-01-16 Harsha Jagasia <harsha.jagasia@amd.com>
PR target/42664 PR target/42664
......
gcc/doc/tm.texi
...@@ -5253,8 +5253,8 @@ provide alternate names for GCC's internal library functions if there ...@@ -5253,8 +5253,8 @@ provide alternate names for GCC's internal library functions if there
are ABI-mandated names that the compiler should provide. are ABI-mandated names that the compiler should provide.
@end defmac @end defmac
@findex init_one_libfunc
@findex set_optab_libfunc @findex set_optab_libfunc
@findex init_one_libfunc
@deftypefn {Target Hook} void TARGET_INIT_LIBFUNCS (void) @deftypefn {Target Hook} void TARGET_INIT_LIBFUNCS (void)
This hook should declare additional library routines or rename This hook should declare additional library routines or rename
existing ones, using the functions @code{set_optab_libfunc} and existing ones, using the functions @code{set_optab_libfunc} and
...@@ -5412,12 +5412,12 @@ the maximum number that @code{TARGET_LEGITIMATE_ADDRESS_P} would ever ...@@ -5412,12 +5412,12 @@ the maximum number that @code{TARGET_LEGITIMATE_ADDRESS_P} would ever
accept. accept.
@end defmac @end defmac
@deftypefn {Target Hook} TARGET_LEGITIMATE_ADDRESS_P (enum machine_mode @var{mode}, rtx @var{x}, bool @var{strict}) @deftypefn {Target Hook} bool TARGET_LEGITIMATE_ADDRESS_P (enum machine_mode @var{mode}, rtx @var{x}, bool @var{strict})
A function that returns whether @var{x} (an RTX) is a legitimate memory A function that returns whether @var{x} (an RTX) is a legitimate memory
address on the target machine for a memory operand of mode @var{mode}. address on the target machine for a memory operand of mode @var{mode}.
Legitimate addresses are defined in two variants: a strict variant and a Legitimate addresses are defined in two variants: a strict variant and a
non-strict one. The @code{strict} parameter chooses which variant is non-strict one. The @var{strict} parameter chooses which variant is
desired by the caller. desired by the caller.
The strict variant is used in the reload pass. It must be defined so The strict variant is used in the reload pass. It must be defined so
...@@ -6422,7 +6422,7 @@ can issue this cycle; normally this is just @code{issue_rate}. See also ...@@ -6422,7 +6422,7 @@ can issue this cycle; normally this is just @code{issue_rate}. See also
@samp{TARGET_SCHED_REORDER2}. @samp{TARGET_SCHED_REORDER2}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} int TARGET_SCHED_REORDER2 (FILE *@var{file}, int @var{verbose}, rtx *@var{ready}, int *@var{n_ready}, @var{clock}) @deftypefn {Target Hook} int TARGET_SCHED_REORDER2 (FILE *@var{file}, int @var{verbose}, rtx *@var{ready}, int *@var{n_readyp}, int @var{clock})
Like @samp{TARGET_SCHED_REORDER}, but called at a different time. That Like @samp{TARGET_SCHED_REORDER}, but called at a different time. That
function is called whenever the scheduler starts a new cycle. This one function is called whenever the scheduler starts a new cycle. This one
is called once per iteration over a cycle, immediately after is called once per iteration over a cycle, immediately after
...@@ -6475,7 +6475,7 @@ This is the cleanup hook corresponding to @code{TARGET_SCHED_INIT_GLOBAL}. ...@@ -6475,7 +6475,7 @@ This is the cleanup hook corresponding to @code{TARGET_SCHED_INIT_GLOBAL}.
@var{verbose} is the verbose level provided by @option{-fsched-verbose-@var{n}}. @var{verbose} is the verbose level provided by @option{-fsched-verbose-@var{n}}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} int TARGET_SCHED_DFA_PRE_CYCLE_INSN (void) @deftypefn {Target Hook} rtx TARGET_SCHED_DFA_PRE_CYCLE_INSN (void)
The hook returns an RTL insn. The automaton state used in the The hook returns an RTL insn. The automaton state used in the
pipeline hazard recognizer is changed as if the insn were scheduled pipeline hazard recognizer is changed as if the insn were scheduled
when the new simulated processor cycle starts. Usage of the hook may when the new simulated processor cycle starts. Usage of the hook may
...@@ -6489,7 +6489,7 @@ when the new simulated processor cycle starts. ...@@ -6489,7 +6489,7 @@ when the new simulated processor cycle starts.
The hook can be used to initialize data used by the previous hook. The hook can be used to initialize data used by the previous hook.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} int TARGET_SCHED_DFA_POST_CYCLE_INSN (void) @deftypefn {Target Hook} rtx TARGET_SCHED_DFA_POST_CYCLE_INSN (void)
The hook is analogous to @samp{TARGET_SCHED_DFA_PRE_CYCLE_INSN} but used The hook is analogous to @samp{TARGET_SCHED_DFA_PRE_CYCLE_INSN} but used
to changed the state as if the insn were scheduled when the new to changed the state as if the insn were scheduled when the new
simulated processor cycle finishes. simulated processor cycle finishes.
...@@ -6500,14 +6500,14 @@ The hook is analogous to @samp{TARGET_SCHED_INIT_DFA_PRE_CYCLE_INSN} but ...@@ -6500,14 +6500,14 @@ The hook is analogous to @samp{TARGET_SCHED_INIT_DFA_PRE_CYCLE_INSN} but
used to initialize data used by the previous hook. used to initialize data used by the previous hook.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_DFA_PRE_CYCLE_ADVANCE (void) @deftypefn {Target Hook} void TARGET_SCHED_DFA_PRE_ADVANCE_CYCLE (void)
The hook to notify target that the current simulated cycle is about to finish. The hook to notify target that the current simulated cycle is about to finish.
The hook is analogous to @samp{TARGET_SCHED_DFA_PRE_CYCLE_INSN} but used The hook is analogous to @samp{TARGET_SCHED_DFA_PRE_CYCLE_INSN} but used
to change the state in more complicated situations - e.g., when advancing to change the state in more complicated situations - e.g., when advancing
state on a single insn is not enough. state on a single insn is not enough.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_DFA_POST_CYCLE_ADVANCE (void) @deftypefn {Target Hook} void TARGET_SCHED_DFA_POST_ADVANCE_CYCLE (void)
The hook to notify target that new simulated cycle has just started. The hook to notify target that new simulated cycle has just started.
The hook is analogous to @samp{TARGET_SCHED_DFA_POST_CYCLE_INSN} but used The hook is analogous to @samp{TARGET_SCHED_DFA_POST_CYCLE_INSN} but used
to change the state in more complicated situations - e.g., when advancing to change the state in more complicated situations - e.g., when advancing
...@@ -6543,11 +6543,11 @@ schedules to choose the best one. ...@@ -6543,11 +6543,11 @@ schedules to choose the best one.
The default is no multipass scheduling. The default is no multipass scheduling.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} int TARGET_SCHED_FIRST_CYCLE_MULTIPASS_DFA_LOOKAHEAD_GUARD (rtx) @deftypefn {Target Hook} int TARGET_SCHED_FIRST_CYCLE_MULTIPASS_DFA_LOOKAHEAD_GUARD (rtx @var{insn})
This hook controls what insns from the ready insn queue will be This hook controls what insns from the ready insn queue will be
considered for the multipass insn scheduling. If the hook returns considered for the multipass insn scheduling. If the hook returns
zero for insn passed as the parameter, the insn will be not chosen to zero for @var{insn}, the insn will be not chosen to
be issued. be issued.
The default is that any ready insns can be chosen to be issued. The default is that any ready insns can be chosen to be issued.
...@@ -6606,30 +6606,7 @@ beginning of the block. Otherwise, make a copy of the current context in ...@@ -6606,30 +6606,7 @@ beginning of the block. Otherwise, make a copy of the current context in
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_SET_SCHED_CONTEXT (void *@var{tc}) @deftypefn {Target Hook} void TARGET_SCHED_SET_SCHED_CONTEXT (void *@var{tc})
Copy target scheduling context pointer to by @var{tc} to the current context. Copy target scheduling context pointed to by @var{tc} to the current context.
@end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_CLEAR_SCHED_CONTEXT (void *@var{tc})
Deallocate internal data in target scheduling context pointed to by @var{tc}.
@end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_FREE_SCHED_CONTEXT (void *@var{tc})
Deallocate a store for target scheduling context pointed to by @var{tc}.
@end deftypefn
@deftypefn {Target Hook} {void *} TARGET_SCHED_ALLOC_SCHED_CONTEXT (void)
Return a pointer to a store large enough to hold target scheduling context.
@end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_INIT_SCHED_CONTEXT (void *@var{tc}, bool @var{clean_p})
Initialize store pointed to by @var{tc} to hold target scheduling context.
It @var{clean_p} is true then initialize @var{tc} as if scheduler is at the
beginning of the block. Otherwise, make a copy of the current context in
@var{tc}.
@end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_SET_SCHED_CONTEXT (void *@var{tc})
Copy target scheduling context pointer to by @var{tc} to the current context.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_SCHED_CLEAR_SCHED_CONTEXT (void *@var{tc}) @deftypefn {Target Hook} void TARGET_SCHED_CLEAR_SCHED_CONTEXT (void *@var{tc})
...@@ -6657,7 +6634,7 @@ for @var{insn}. It should return nonzero, if the corresponding check ...@@ -6657,7 +6634,7 @@ for @var{insn}. It should return nonzero, if the corresponding check
instruction should branch to recovery code, or zero otherwise. instruction should branch to recovery code, or zero otherwise.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} rtx TARGET_SCHED_GEN_CHECK (rtx @var{insn}, rtx @var{label}, int @var{mutate_p}) @deftypefn {Target Hook} rtx TARGET_SCHED_GEN_SPEC_CHECK (rtx @var{insn}, rtx @var{label}, int @var{mutate_p})
This hook is called by the insn scheduler to generate a pattern for recovery This hook is called by the insn scheduler to generate a pattern for recovery
check instruction. If @var{mutate_p} is zero, then @var{insn} is a check instruction. If @var{mutate_p} is zero, then @var{insn} is a
speculative instruction for which the check should be generated. speculative instruction for which the check should be generated.
...@@ -6872,7 +6849,7 @@ any assembly code, and before calling any of the section-returning hooks ...@@ -6872,7 +6849,7 @@ any assembly code, and before calling any of the section-returning hooks
described below. described below.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} TARGET_ASM_RELOC_RW_MASK (void) @deftypefn {Target Hook} int TARGET_ASM_RELOC_RW_MASK (void)
Return a mask describing how relocations should be treated when Return a mask describing how relocations should be treated when
selecting sections. Bit 1 should be set if global relocations selecting sections. Bit 1 should be set if global relocations
should be placed in a read-write section; bit 0 should be set if should be placed in a read-write section; bit 0 should be set if
...@@ -6940,7 +6917,7 @@ constants in @code{flag_pic} mode in @code{data_section} and everything ...@@ -6940,7 +6917,7 @@ constants in @code{flag_pic} mode in @code{data_section} and everything
else in @code{readonly_data_section}. else in @code{readonly_data_section}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_MANGLE_DECL_ASSEMBLER_NAME (tree @var{decl}, tree @var{id}) @deftypefn {Target Hook} tree TARGET_MANGLE_DECL_ASSEMBLER_NAME (tree @var{decl}, tree @var{id})
Define this hook if you need to postprocess the assembler name generated Define this hook if you need to postprocess the assembler name generated
by target-independent code. The @var{id} provided to this hook will be by target-independent code. The @var{id} provided to this hook will be
the computed name (e.g., the macro @code{DECL_NAME} of the @var{decl} in C, the computed name (e.g., the macro @code{DECL_NAME} of the @var{decl} in C,
...@@ -6988,7 +6965,7 @@ in @file{varasm.c}, sets a number of commonly-useful bits in ...@@ -6988,7 +6965,7 @@ in @file{varasm.c}, sets a number of commonly-useful bits in
before overriding it. before overriding it.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} const char *TARGET_STRIP_NAME_ENCODING (const char *name) @deftypefn {Target Hook} {const char *} TARGET_STRIP_NAME_ENCODING (const char *@var{name})
Decode @var{name} and return the real name part, sans Decode @var{name} and return the real name part, sans
the characters that @code{TARGET_ENCODE_SECTION_INFO} the characters that @code{TARGET_ENCODE_SECTION_INFO}
may have added. may have added.
...@@ -7095,8 +7072,8 @@ instructions do. ...@@ -7095,8 +7072,8 @@ instructions do.
@c prevent bad page break with this line @c prevent bad page break with this line
This describes the overall framework of an assembly file. This describes the overall framework of an assembly file.
@deftypefn {Target Hook} void TARGET_ASM_FILE_START ()
@findex default_file_start @findex default_file_start
@deftypefn {Target Hook} void TARGET_ASM_FILE_START (void)
Output to @code{asm_out_file} any text which the assembler expects to Output to @code{asm_out_file} any text which the assembler expects to
find at the beginning of a file. The default behavior is controlled find at the beginning of a file. The default behavior is controlled
by two flags, documented below. Unless your target's assembler is by two flags, documented below. Unless your target's assembler is
...@@ -7184,26 +7161,24 @@ A C statement to output something to the assembler file to handle a ...@@ -7184,26 +7161,24 @@ A C statement to output something to the assembler file to handle a
macro is not defined, nothing is output for a @samp{#ident} directive. macro is not defined, nothing is output for a @samp{#ident} directive.
@end defmac @end defmac
@deftypefn {Target Hook} void TARGET_ASM_NAMED_SECTION (const char *@var{name}, unsigned int @var{flags}, unsigned int @var{align}) @deftypefn {Target Hook} void TARGET_ASM_NAMED_SECTION (const char *@var{name}, unsigned int @var{flags}, tree @var{decl})
Output assembly directives to switch to section @var{name}. The section Output assembly directives to switch to section @var{name}. The section
should have attributes as specified by @var{flags}, which is a bit mask should have attributes as specified by @var{flags}, which is a bit mask
of the @code{SECTION_*} flags defined in @file{output.h}. If @var{align} of the @code{SECTION_*} flags defined in @file{output.h}. If @var{decl}
is nonzero, it contains an alignment in bytes to be used for the section, is non-NULL, it is the @code{VAR_DECL} or @code{FUNCTION_DECL} with which
otherwise some target default should be used. Only targets that must this section is associated.
specify an alignment within the section directive need pay attention to
@var{align} -- we will still use @code{ASM_OUTPUT_ALIGN}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} bool TARGET_HAVE_NAMED_SECTIONS @deftypevr {Target Hook} bool TARGET_HAVE_NAMED_SECTIONS
This flag is true if the target supports @code{TARGET_ASM_NAMED_SECTION}. This flag is true if the target supports @code{TARGET_ASM_NAMED_SECTION}.
@end deftypefn @end deftypevr
@anchor{TARGET_HAVE_SWITCHABLE_BSS_SECTIONS} @anchor{TARGET_HAVE_SWITCHABLE_BSS_SECTIONS}
@deftypefn {Target Hook} bool TARGET_HAVE_SWITCHABLE_BSS_SECTIONS @deftypevr {Target Hook} bool TARGET_HAVE_SWITCHABLE_BSS_SECTIONS
This flag is true if we can create zeroed data by switching to a BSS This flag is true if we can create zeroed data by switching to a BSS
section and then using @code{ASM_OUTPUT_SKIP} to allocate the space. section and then using @code{ASM_OUTPUT_SKIP} to allocate the space.
This is true on most ELF targets. This is true on most ELF targets.
@end deftypefn @end deftypevr
@deftypefn {Target Hook} {unsigned int} TARGET_SECTION_TYPE_FLAGS (tree @var{decl}, const char *@var{name}, int @var{reloc}) @deftypefn {Target Hook} {unsigned int} TARGET_SECTION_TYPE_FLAGS (tree @var{decl}, const char *@var{name}, int @var{reloc})
Choose a set of section attributes for use by @code{TARGET_ASM_NAMED_SECTION} Choose a set of section attributes for use by @code{TARGET_ASM_NAMED_SECTION}
...@@ -7263,11 +7238,11 @@ provided by the @code{TARGET_ASM_RECORD_GCC_SWITCHES_SECTION} target ...@@ -7263,11 +7238,11 @@ provided by the @code{TARGET_ASM_RECORD_GCC_SWITCHES_SECTION} target
hook. hook.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} {const char *} TARGET_ASM_RECORD_GCC_SWITCHES_SECTION @deftypevr {Target Hook} {const char *} TARGET_ASM_RECORD_GCC_SWITCHES_SECTION
This is the name of the section that will be created by the example This is the name of the section that will be created by the example
ELF implementation of the @code{TARGET_ASM_RECORD_GCC_SWITCHES} target ELF implementation of the @code{TARGET_ASM_RECORD_GCC_SWITCHES} target
hook. hook.
@end deftypefn @end deftypevr
@need 2000 @need 2000
@node Data Output @node Data Output
...@@ -7802,7 +7777,7 @@ setting the @code{DECL_ONE_ONLY} flag is enough to mark a declaration to ...@@ -7802,7 +7777,7 @@ setting the @code{DECL_ONE_ONLY} flag is enough to mark a declaration to
be emitted as one-only. be emitted as one-only.
@end defmac @end defmac
@deftypefn {Target Hook} void TARGET_ASM_ASSEMBLE_VISIBILITY (tree @var{decl}, const char *@var{visibility}) @deftypefn {Target Hook} void TARGET_ASM_ASSEMBLE_VISIBILITY (tree @var{decl}, int @var{visibility})
This target hook is a function to output to @var{asm_out_file} some This target hook is a function to output to @var{asm_out_file} some
commands that will make the symbol(s) associated with @var{decl} have commands that will make the symbol(s) associated with @var{decl} have
hidden, protected or internal visibility as specified by @var{visibility}. hidden, protected or internal visibility as specified by @var{visibility}.
...@@ -7844,10 +7819,10 @@ pseudo-op to declare a library function name external. The name of the ...@@ -7844,10 +7819,10 @@ pseudo-op to declare a library function name external. The name of the
library function is given by @var{symref}, which is a @code{symbol_ref}. library function is given by @var{symref}, which is a @code{symbol_ref}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_ASM_MARK_DECL_PRESERVED (tree @var{decl}) @deftypefn {Target Hook} void TARGET_ASM_MARK_DECL_PRESERVED (const char *@var{symbol})
This target hook is a function to output to @var{asm_out_file} an assembler This target hook is a function to output to @var{asm_out_file} an assembler
directive to annotate used symbol. Darwin target use .no_dead_code_strip directive to annotate @var{symbol} as used. The Darwin target uses the
directive. .no_dead_code_strip directive.
@end deftypefn @end deftypefn
@defmac ASM_OUTPUT_LABELREF (@var{stream}, @var{name}) @defmac ASM_OUTPUT_LABELREF (@var{stream}, @var{name})
...@@ -8215,11 +8190,11 @@ of objects. If zero, the compiler will issue an error message upon ...@@ -8215,11 +8190,11 @@ of objects. If zero, the compiler will issue an error message upon
encountering an @code{init_priority} attribute. encountering an @code{init_priority} attribute.
@end defmac @end defmac
@deftypefn {Target Hook} bool TARGET_HAVE_CTORS_DTORS @deftypevr {Target Hook} bool TARGET_HAVE_CTORS_DTORS
This value is true if the target supports some ``native'' method of This value is true if the target supports some ``native'' method of
collecting constructors and destructors to be run at startup and exit. collecting constructors and destructors to be run at startup and exit.
It is false if we must use @command{collect2}. It is false if we must use @command{collect2}.
@end deftypefn @end deftypevr
@deftypefn {Target Hook} void TARGET_ASM_CONSTRUCTOR (rtx @var{symbol}, int @var{priority}) @deftypefn {Target Hook} void TARGET_ASM_CONSTRUCTOR (rtx @var{symbol}, int @var{priority})
If defined, a function that outputs assembler code to arrange to call If defined, a function that outputs assembler code to arrange to call
...@@ -8361,7 +8336,7 @@ writing conditional output routines in those patterns. ...@@ -8361,7 +8336,7 @@ writing conditional output routines in those patterns.
If this macro is not defined, it is equivalent to a null statement. If this macro is not defined, it is equivalent to a null statement.
@end defmac @end defmac
@deftypefn {Target Hook} void TARGET_ASM_FINAL_POSTSCAN_INSN (FILE *@var{FILE}, rtx @var{insn}, rtx *@var{opvec}, int @var{noperands}) @deftypefn {Target Hook} void TARGET_ASM_FINAL_POSTSCAN_INSN (FILE *@var{file}, rtx @var{insn}, rtx *@var{opvec}, int @var{noperands})
If defined, this target hook is a function which is executed just after the If defined, this target hook is a function which is executed just after the
output of assembler code for @var{insn}, to change the mode of the assembler output of assembler code for @var{insn}, to change the mode of the assembler
if necessary. if necessary.
...@@ -8579,7 +8554,7 @@ If this macro is not defined, nothing special is output at the end of ...@@ -8579,7 +8554,7 @@ If this macro is not defined, nothing special is output at the end of
the jump-table. the jump-table.
@end defmac @end defmac
@deftypefn {Target Hook} void TARGET_ASM_EMIT_UNWIND_LABEL (@var{stream}, @var{decl}, @var{for_eh}, @var{empty}) @deftypefn {Target Hook} void TARGET_ASM_EMIT_UNWIND_LABEL (FILE *@var{stream}, tree @var{decl}, int @var{for_eh}, int @var{empty})
This target hook emits a label at the beginning of each FDE@. It This target hook emits a label at the beginning of each FDE@. It
should be defined on targets where FDEs need special labels, and it should be defined on targets where FDEs need special labels, and it
should write the appropriate label, for the FDE associated with the should write the appropriate label, for the FDE associated with the
...@@ -8591,7 +8566,7 @@ true if this is a placeholder label for an omitted FDE@. ...@@ -8591,7 +8566,7 @@ true if this is a placeholder label for an omitted FDE@.
The default is that FDEs are not given nonlocal labels. The default is that FDEs are not given nonlocal labels.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_ASM_EMIT_EXCEPT_TABLE_LABEL (@var{stream}) @deftypefn {Target Hook} void TARGET_ASM_EMIT_EXCEPT_TABLE_LABEL (FILE *@var{stream})
This target hook emits a label at the beginning of the exception table. This target hook emits a label at the beginning of the exception table.
It should be defined on targets where it is desirable for the table It should be defined on targets where it is desirable for the table
to be broken up according to function. to be broken up according to function.
...@@ -8599,8 +8574,8 @@ to be broken up according to function. ...@@ -8599,8 +8574,8 @@ to be broken up according to function.
The default is that no label is emitted. The default is that no label is emitted.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} void TARGET_UNWIND_EMIT (FILE * @var{stream}, rtx @var{insn}) @deftypefn {Target Hook} void TARGET_UNWIND_EMIT (FILE *@var{stream}, rtx @var{insn})
This target hook emits and assembly directives required to unwind the This target hook emits assembly directives required to unwind the
given instruction. This is only used when TARGET_UNWIND_INFO is set. given instruction. This is only used when TARGET_UNWIND_INFO is set.
@end deftypefn @end deftypefn
...@@ -8725,12 +8700,12 @@ if the reference was output. Returning @code{false} will cause the ...@@ -8725,12 +8700,12 @@ if the reference was output. Returning @code{false} will cause the
reference to be output using the normal Dwarf2 routines. reference to be output using the normal Dwarf2 routines.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} bool TARGET_ARM_EABI_UNWINDER @deftypevr {Target Hook} bool TARGET_ARM_EABI_UNWINDER
This hook should be set to @code{true} on targets that use an ARM EABI This flag should be set to @code{true} on targets that use an ARM EABI
based unwinding library, and @code{false} on other targets. This effects based unwinding library, and @code{false} on other targets. This effects
the format of unwinding tables, and how the unwinder in entered after the format of unwinding tables, and how the unwinder in entered after
running a cleanup. The default is @code{false}. running a cleanup. The default is @code{false}.
@end deftypefn @end deftypevr
@node Alignment Output @node Alignment Output
@subsection Assembler Commands for Alignment @subsection Assembler Commands for Alignment
...@@ -9207,7 +9182,7 @@ is used on some systems to avoid garbage collecting a DWARF table which ...@@ -9207,7 +9182,7 @@ is used on some systems to avoid garbage collecting a DWARF table which
is referenced by a function. is referenced by a function.
@end defmac @end defmac
@deftypefn {Target Hook} void TARGET_ASM_OUTPUT_DWARF_DTPREL (FILE *@var{FILE}, int @var{size}, rtx @var{x}) @deftypefn {Target Hook} void TARGET_ASM_OUTPUT_DWARF_DTPREL (FILE *@var{file}, int @var{size}, rtx @var{x})
If defined, this target hook is a function which outputs a DTP-relative If defined, this target hook is a function which outputs a DTP-relative
reference to the given TLS symbol of the specified size. reference to the given TLS symbol of the specified size.
@end deftypefn @end deftypefn
...@@ -9485,7 +9460,7 @@ supposed always to be compatible. ...@@ -9485,7 +9460,7 @@ supposed always to be compatible.
@deftypefn {Target Hook} void TARGET_SET_DEFAULT_TYPE_ATTRIBUTES (tree @var{type}) @deftypefn {Target Hook} void TARGET_SET_DEFAULT_TYPE_ATTRIBUTES (tree @var{type})
If defined, this target hook is a function which assigns default attributes to If defined, this target hook is a function which assigns default attributes to
newly defined @var{type}. the newly defined @var{type}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} tree TARGET_MERGE_TYPE_ATTRIBUTES (tree @var{type1}, tree @var{type2}) @deftypefn {Target Hook} tree TARGET_MERGE_TYPE_ATTRIBUTES (tree @var{type1}, tree @var{type2})
...@@ -9555,7 +9530,7 @@ attributes, @code{false} otherwise. By default, if a function has a ...@@ -9555,7 +9530,7 @@ attributes, @code{false} otherwise. By default, if a function has a
target specific attribute attached to it, it will not be inlined. target specific attribute attached to it, it will not be inlined.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} bool TARGET_VALID_OPTION_ATTRIBUTE_P (tree @var{fndecl}, tree @var{name}, tree @var{args}, int @var{flags}) @deftypefn {Target Hook} bool TARGET_OPTION_VALID_ATTRIBUTE_P (tree @var{fndecl}, tree @var{name}, tree @var{args}, int @var{flags})
This hook is called to parse the @code{attribute(option("..."))}, and This hook is called to parse the @code{attribute(option("..."))}, and
it allows the function to set different target machine compile time it allows the function to set different target machine compile time
options for the current function that might be different than the options for the current function that might be different than the
...@@ -9722,9 +9697,10 @@ Default: empty. ...@@ -9722,9 +9697,10 @@ Default: empty.
@section Parameters for Precompiled Header Validity Checking @section Parameters for Precompiled Header Validity Checking
@cindex parameters, precompiled headers @cindex parameters, precompiled headers
@deftypefn {Target Hook} void *TARGET_GET_PCH_VALIDITY (size_t *@var{sz}) @deftypefn {Target Hook} {void *} TARGET_GET_PCH_VALIDITY (size_t *@var{len})
This hook returns the data needed by @code{TARGET_PCH_VALID_P} and sets This hook returns a pointer to the data needed by
@samp{*@var{sz}} to the size of the data in bytes. @code{TARGET_PCH_VALID_P} and sets
@samp{*@var{len}} to the size of the data in bytes.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} {const char *} TARGET_PCH_VALID_P (const void *@var{data}, size_t @var{sz}) @deftypefn {Target Hook} {const char *} TARGET_PCH_VALID_P (const void *@var{data}, size_t @var{sz})
...@@ -9762,8 +9738,8 @@ default is long_long_integer_type_node. ...@@ -9762,8 +9738,8 @@ default is long_long_integer_type_node.
@deftypefn {Target Hook} bool TARGET_CXX_GUARD_MASK_BIT (void) @deftypefn {Target Hook} bool TARGET_CXX_GUARD_MASK_BIT (void)
This hook determines how guard variables are used. It should return This hook determines how guard variables are used. It should return
@code{false} (the default) if first byte should be used. A return value of @code{false} (the default) if the first byte should be used. A return value of
@code{true} indicates the least significant bit should be used. @code{true} indicates that only the least significant bit should be used.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} tree TARGET_CXX_GET_COOKIE_SIZE (tree @var{type}) @deftypefn {Target Hook} tree TARGET_CXX_GET_COOKIE_SIZE (tree @var{type})
...@@ -10103,7 +10079,7 @@ You need not define this macro if it would always have the value of zero. ...@@ -10103,7 +10079,7 @@ You need not define this macro if it would always have the value of zero.
@end defmac @end defmac
@anchor{TARGET_SHIFT_TRUNCATION_MASK} @anchor{TARGET_SHIFT_TRUNCATION_MASK}
@deftypefn {Target Hook} int TARGET_SHIFT_TRUNCATION_MASK (enum machine_mode @var{mode}) @deftypefn {Target Hook} {unsigned HOST_WIDE_INT} TARGET_SHIFT_TRUNCATION_MASK (enum machine_mode @var{mode})
This function describes how the standard shift patterns for @var{mode} This function describes how the standard shift patterns for @var{mode}
deal with shifts by negative amounts or by more than the width of the mode. deal with shifts by negative amounts or by more than the width of the mode.
@xref{shift patterns}. @xref{shift patterns}.
...@@ -10152,7 +10128,7 @@ otherwise. (Currently, none of the targets use zero-extended ...@@ -10152,7 +10128,7 @@ otherwise. (Currently, none of the targets use zero-extended
representation this way so unlike @code{LOAD_EXTEND_OP}, representation this way so unlike @code{LOAD_EXTEND_OP},
@code{TARGET_MODE_REP_EXTENDED} is expected to return either @code{TARGET_MODE_REP_EXTENDED} is expected to return either
@code{SIGN_EXTEND} or @code{UNKNOWN}. Also no target extends @code{SIGN_EXTEND} or @code{UNKNOWN}. Also no target extends
@var{mode} to @var{mode_rep} so that @var{mode_rep} is not the next @var{mode} to @var{rep_mode} so that @var{rep_mode} is not the next
widest integral mode and currently we take advantage of this fact.) widest integral mode and currently we take advantage of this fact.)
Similarly to @code{LOAD_EXTEND_OP} you may return a non-@code{UNKNOWN} Similarly to @code{LOAD_EXTEND_OP} you may return a non-@code{UNKNOWN}
...@@ -10466,6 +10442,10 @@ Define this macro, as well as ...@@ -10466,6 +10442,10 @@ Define this macro, as well as
arguments of @samp{#pragma pack}. arguments of @samp{#pragma pack}.
@end defmac @end defmac
@deftypevr {Target Hook} bool TARGET_HANDLE_PRAGMA_EXTERN_PREFIX
True if @code{#pragma extern_prefix} is to be supported.
@end deftypevr
@defmac TARGET_DEFAULT_PACK_STRUCT @defmac TARGET_DEFAULT_PACK_STRUCT
If your target requires a structure packing default other than 0 (meaning If your target requires a structure packing default other than 0 (meaning
the machine default), define this macro to the necessary value (in bytes). the machine default), define this macro to the necessary value (in bytes).
...@@ -10655,7 +10635,7 @@ only language front ends that use those two functions will call ...@@ -10655,7 +10635,7 @@ only language front ends that use those two functions will call
@samp{TARGET_INIT_BUILTINS}. @samp{TARGET_INIT_BUILTINS}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} tree TARGET_BUILTIN_FUNCTION (unsigned @var{code}, bool @var{initialize_p}) @deftypefn {Target Hook} tree TARGET_BUILTIN_DECL (unsigned @var{code}, bool @var{initialize_p})
Define this hook if you have any machine-specific built-in functions Define this hook if you have any machine-specific built-in functions
that need to be defined. It should be a function that returns the that need to be defined. It should be a function that returns the
builtin function declaration for the builtin function code @var{code}. builtin function declaration for the builtin function code @var{code}.
...@@ -10722,7 +10702,7 @@ filling of delay slots can result in branches being redirected, and this ...@@ -10722,7 +10702,7 @@ filling of delay slots can result in branches being redirected, and this
may in turn cause a branch offset to overflow. may in turn cause a branch offset to overflow.
@end defmac @end defmac
@deftypefn {Target Hook} bool TARGET_COMMUTATIVE_P (rtx @var{x}, @var{outer_code}) @deftypefn {Target Hook} bool TARGET_COMMUTATIVE_P (const_rtx @var{x}, int @var{outer_code})
This target hook returns @code{true} if @var{x} is considered to be commutative. This target hook returns @code{true} if @var{x} is considered to be commutative.
Usually, this is just COMMUTATIVE_P (@var{x}), but the HP PA doesn't consider Usually, this is just COMMUTATIVE_P (@var{x}), but the HP PA doesn't consider
PLUS to be commutative inside a MEM@. @var{outer_code} is the rtx code PLUS to be commutative inside a MEM@. @var{outer_code} is the rtx code
...@@ -10775,6 +10755,8 @@ GCC sets @code{cfun} to a dummy function context during initialization of ...@@ -10775,6 +10755,8 @@ GCC sets @code{cfun} to a dummy function context during initialization of
some parts of the back end. The hook function is not invoked in this some parts of the back end. The hook function is not invoked in this
situation; you need not worry about the hook being invoked recursively, situation; you need not worry about the hook being invoked recursively,
or when the back end is in a partially-initialized state. or when the back end is in a partially-initialized state.
@code{cfun} might be @code{NULL} to indicate processing at top level,
outside of any function scope.
@end deftypefn @end deftypefn
@defmac TARGET_OBJECT_SUFFIX @defmac TARGET_OBJECT_SUFFIX
...@@ -10829,7 +10811,7 @@ cannot_modify_jumps_past_reload_p () ...@@ -10829,7 +10811,7 @@ cannot_modify_jumps_past_reload_p ()
@end smallexample @end smallexample
@end deftypefn @end deftypefn
@deftypefn {Target Hook} int TARGET_BRANCH_TARGET_REGISTER_CLASS (void) @deftypefn {Target Hook} {enum reg_class} TARGET_BRANCH_TARGET_REGISTER_CLASS (void)
This target hook returns a register class for which branch target register This target hook returns a register class for which branch target register
optimizations should be applied. All registers in this class should be optimizations should be applied. All registers in this class should be
usable interchangeably. After reload, registers in this class will be usable interchangeably. After reload, registers in this class will be
...@@ -10889,13 +10871,13 @@ systems, this is used for Framework includes, which have semantics ...@@ -10889,13 +10871,13 @@ systems, this is used for Framework includes, which have semantics
that are different from @option{-I}. that are different from @option{-I}.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} bool TARGET_USE_LOCAL_THUNK_ALIAS_P (tree @var{fndecl}) @defmac bool TARGET_USE_LOCAL_THUNK_ALIAS_P (tree @var{fndecl})
This target hook returns @code{true} if it is safe to use a local alias This target macro returns @code{true} if it is safe to use a local alias
for a virtual function @var{fndecl} when constructing thunks, for a virtual function @var{fndecl} when constructing thunks,
@code{false} otherwise. By default, the hook returns @code{true} for all @code{false} otherwise. By default, the macro returns @code{true} for all
functions, if a target supports aliases (i.e.@: defines functions, if a target supports aliases (i.e.@: defines
@code{ASM_OUTPUT_DEF}), @code{false} otherwise, @code{ASM_OUTPUT_DEF}), @code{false} otherwise,
@end deftypefn @end defmac
@defmac TARGET_FORMAT_TYPES @defmac TARGET_FORMAT_TYPES
If defined, this macro is the name of a global variable containing If defined, this macro is the name of a global variable containing
...@@ -10926,7 +10908,7 @@ routine for target specific customizations of the system printf ...@@ -10926,7 +10908,7 @@ routine for target specific customizations of the system printf
and scanf formatter settings. and scanf formatter settings.
@end defmac @end defmac
@deftypefn {Target Hook} bool TARGET_RELAXED_ORDERING @deftypevr {Target Hook} bool TARGET_RELAXED_ORDERING
If set to @code{true}, means that the target's memory model does not If set to @code{true}, means that the target's memory model does not
guarantee that loads which do not depend on one another will access guarantee that loads which do not depend on one another will access
main memory in the order of the instruction stream; if ordering is main memory in the order of the instruction stream; if ordering is
...@@ -10934,7 +10916,7 @@ important, an explicit memory barrier must be used. This is true of ...@@ -10934,7 +10916,7 @@ important, an explicit memory barrier must be used. This is true of
many recent processors which implement a policy of ``relaxed,'' many recent processors which implement a policy of ``relaxed,''
``weak,'' or ``release'' memory consistency, such as Alpha, PowerPC, ``weak,'' or ``release'' memory consistency, such as Alpha, PowerPC,
and ia64. The default is @code{false}. and ia64. The default is @code{false}.
@end deftypefn @end deftypevr
@deftypefn {Target Hook} {const char *} TARGET_INVALID_ARG_FOR_UNPROTOTYPED_FN (const_tree @var{typelist}, const_tree @var{funcdecl}, const_tree @var{val}) @deftypefn {Target Hook} {const char *} TARGET_INVALID_ARG_FOR_UNPROTOTYPED_FN (const_tree @var{typelist}, const_tree @var{funcdecl}, const_tree @var{val})
If defined, this macro returns the diagnostic message when it is If defined, this macro returns the diagnostic message when it is
...@@ -11018,9 +11000,10 @@ necessary. ...@@ -11018,9 +11000,10 @@ necessary.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} rtx TARGET_GET_DRAP_RTX (void) @deftypefn {Target Hook} rtx TARGET_GET_DRAP_RTX (void)
Define this macro to an rtx for Dynamic Realign Argument Pointer if a This hook should return an rtx for Dynamic Realign Argument Pointer (DRAP) if a
different argument pointer register is needed to access the function's different argument pointer register is needed to access the function's
argument list when stack is aligned. argument list due to stack realignment. Return @code{NULL} if no DRAP
is needed.
@end deftypefn @end deftypefn
@deftypefn {Target Hook} bool TARGET_ALLOCATE_STACK_SLOTS_FOR_ARGS (void) @deftypefn {Target Hook} bool TARGET_ALLOCATE_STACK_SLOTS_FOR_ARGS (void)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment