From 86cb8d868dc566fb7813a7478b32c1e77f632836 Mon Sep 17 00:00:00 2001 From: Doug Evans Date: Wed, 5 Nov 1997 00:15:22 +0000 Subject: [PATCH] Update ns32k docs. --- gas/doc/internals.texi | 57 ++++++++++++++++++++++++++++++++++-------- 1 file changed, 46 insertions(+), 11 deletions(-) diff --git a/gas/doc/internals.texi b/gas/doc/internals.texi index a2d2a756c4..40fcfe5434 100644 --- a/gas/doc/internals.texi +++ b/gas/doc/internals.texi @@ -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. -- 2.34.1