Chapter 3. Command Line Options

21

 listing lhs width2=number

Sets the maximum width, in words, of any further lines of the hex byte dump for a given input

source line. If this value is not specified, it defaults to being the same as the value specified for

 listing lhs width

. If neither switch is used the default is to one.

 listing rhs width=number

Sets the maximum width, in characters, of the source line that is displayed alongside the hex

dump. The default value for this parameter is 100. The source line is displayed on the right hand

side of the listing output.

 listing cont lines=number

Sets the maximum number of continuation lines of hex dump that will be displayed for a given

single line of source input. The default value is 4.

3.9. Assemble in MRI Compatibility Mode:

 M

The

 M

or

 mri

option selects MRI compatibility mode. This changes the syntax and pseudo op

handling of

as

to make it compatible with the

ASM68K

or the

ASM960

(depending upon the configured

target) assembler from Microtec Research. The exact nature of the MRI syntax will not be documented

here; see the MRI manuals for more information. Note in particular that the handling of macros and

macro arguments is somewhat different. The purpose of this option is to permit assembling existing

MRI assembler code using

as

.

The MRI compatibility is not complete. Certain operations of the MRI assembler depend upon its

object file format, and can not be supported using other object file formats. Supporting these would

require enhancing each object file format individually. These are:

global symbols in common section

The m68k MRI assembler supports common sections which are merged by the linker. Other object

file formats do not support this.

as

handles common sections by treating them as a single common

symbol. It permits local symbols to be defined within a common section, but it can not support

global symbols, since it has no way to describe them.

complex relocations

The MRI assemblers support relocations against a negated section address, and relocations which

combine the start addresses of two or more sections. These are not support by other object file

formats.

  END

pseudo op specifying start address

The MRI

END

pseudo op permits the specification of a start address. This is not supported by other

object file formats. The start address may instead be specified using the

 e

option to the linker, or

in a linker script.

  IDNT

,

.ident

and

NAME

pseudo ops

The MRI

IDNT

,

.ident

and

NAME

pseudo ops assign a module name to the output file. This is not

supported by other object file formats.

  ORG

pseudo op

The m68k MRI

ORG

pseudo op begins an absolute section at a given address. This differs from the

usual

as .org

pseudo op, which changes the location within the current section. Absolute sections

are not supported by other object file formats. The address of a section may be assigned within a

linker script.