darkkirb/old-cross-binutils
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Update ns32k docs.

Browse source
This commit is contained in:
Doug Evans 1997-11-05 00:15:22 +00:00
parent 525d929e49
commit 86cb8d868d
1 changed files with 46 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
gas/doc/internals.texi
View file

@ -469,7 +469,8 @@ This normally indicates the symbol to use when relaxing the frag according to
@item fr_opcode
Points to the lowest-addressed byte of the opcode, for use in relaxation.
@item fr_pcrel_adjust
@item fr_opcode_frag
@itemx fr_opcode_offset
@itemx fr_bsr
These fields are only used in the NS32k configuration. But since @code{struct
frag} is defined before the CPU-specific header files are included, they must
@ -511,6 +512,13 @@ The variable characters are to be repeated @code{fr_offset} times. If
@code{fr_offset} is 0, this frag has a length of @code{fr_fix}. Most frags
have this type.
@item rs_leb128
This state is used to implement the DWARF ``little endian base 128''
variable length number format. The @code{fr_symbol} is always an expression
symbol, as constant expressions are emitted directly. The @code{fr_offset}
field is used during relaxation to hold the previous size of the number so
that we can determine if the fragment changed size.
@item rs_machine_dependent
Displacement relaxation is to be done on this frag. The target is indicated by
@code{fr_symbol} and @code{fr_offset}, and @code{fr_subtype} indicates the
@ -621,18 +629,18 @@ second switches on the entire target to set the shell variable @code{fmt}.
The configure script uses the value of @code{cpu_type} to select two files in
the @file{config} directory: @file{tc-@var{CPU}.c} and @file{tc-@var{CPU}.h}.
The configuration process will create symlinks to these files from
@file{targ-cpu.c} and @file{targ-cpu.h} in the build directory.
The configuration process will create a file named @file{targ-cpu.h} in the
build directory which includes @file{tc-@var{CPU}.h}.
The configure script also uses the value of @code{fmt} to select two files:
@file{obj-@var{fmt}.c} and @file{obj-@var{fmt}.h}. The configuration process
will create symlinks to these files from @file{obj-format.h} and
@file{obj-format.c}.
will create a file named @file{obj-format.h} in the build directory which
includes @file{obj-@var{fmt}.h}.
You can also set the emulation in the configure script by setting the @code{em}
variable. Normally the default value of @samp{generic} is fine. The
configuration process will create a symlink from @file{targ-env.h} to
@file{te-@var{em}.h}.
configuration process will create a file named @file{targ-env.h} in the build
directory which includes @file{te-@var{em}.h}.
Porting GAS to a new CPU requires writing the @file{tc-@var{CPU}} files.
Porting GAS to a new object file format requires writing the
@ -895,7 +903,7 @@ GAS will call it at the end of the assembly.
@item md_flush_pending_output
@cindex md_flush_pending_output
If you define this macro, GAS will it each time it skips any space because of a
If you define this macro, GAS will call it each time it skips any space because of a
space filling or alignment or data allocation pseudo-op.
@item TC_PARSE_CONS_EXPRESSION
@ -990,7 +998,7 @@ then discard this space when relaxing the section.
@cindex md_convert_frag
GAS will call this for each rs_machine_dependent fragment.
The instruction is completed using the data from the relaxation pass.
It may also create an necessary relocations.
It may also create any necessary relocations.
@xref{Relaxation}.
@item md_apply_fix
@ -1047,7 +1055,7 @@ If you define this macro, GAS will call it each time a label is defined.
@item md_section_align
@cindex md_section_align
GAS will call this function for each section at the end of the assemebly, to
GAS will call this function for each section at the end of the assembly, to
permit the CPU backend to adjust the alignment of a section.
@item tc_frob_section
@ -1075,6 +1083,33 @@ completed, but before the relocations have been generated.
@item tc_frob_file_after_relocs
If you define this macro, GAS will call it after the relocs have been
generated.
@item LISTING_HEADER
A string to use on the header line of a listing. The default value is simply
@code{"GAS LISTING"}.
@item LISTING_WORD_SIZE
The number of bytes to put into a word in a listing. This affects the way the
bytes are clumped together in the listing. For example, a value of 2 might
print @samp{1234 5678} where a value of 1 would print @samp{12 34 56 78}. The
default value is 4.
@item LISTING_LHS_WIDTH
The number of words of data to print on the first line of a listing for a
particular source line, where each word is @code{LISTING_WORD_SIZE} bytes. The
default value is 1.
@item LISTING_LHS_WIDTH_SECOND
Like @code{LISTING_LHS_WIDTH}, but applying to the second and subsequent line
of the data printed for a particular source line. The default value is 1.
@item LISTING_LHS_CONT_LINES
The maximum number of continuation lines to print in a listing for a particular
source line. The default value is 4.
@item LISTING_RHS_WIDTH
The maximum number of characters to print from one line of the input file. The
default value is 100.
@end table
@node Object format backend
@ -1228,7 +1263,7 @@ the value to be stored is outside the range accessible by the current
addressing mode. The @code{fr_symbol} field of the frag indicates what symbol
is to be accessed; the @code{fr_offset} field is added in.
If the @code{fr_pcrel_adjust} field is set, which currently should only happen
If the @code{TC_PCREL_ADJUST} macro is defined, which currently should only happen
for the NS32k family, the @code{TC_PCREL_ADJUST} macro is called on the frag to
compute an adjustment to be made to the displacement.