The ARM Symbolic Debugger

armsd

SYNOPSIS

       armsd [options] [imagename [arguments]]

DESCRIPTION

       armsd  can be used to debug programs assembled or compiled
       using armasm (the ARM Assembler), and  armcc  (the  ARM  C
       compiler),  if  those  programs  have  been  produced with
       debugging enabled. A limited amount of debugging  informa-
       tion can be produced at link time, even if the object code
       being linked was  not  compiled  with  debugging  enabled.
       armsd is normally used to run ARM Image Format images.

       See  "The  ARM  C  Compiler  (armcc)",  "The ARM Assembler
       (armasm)" and "The ARM Linker (armlink)" starting on  page
       19  for  more  information  on the generation of debugging
       data.  Note that from release 1.5 of the  software  tools,
       pisd has been combined with armsd in a single tool, armsd.

OPTIONS

       The options are listed below. Upper-case is used  to  show
       the allowable abbreviations.

       -Help  Give a summary of the armsd command line options;

       -Size n
              Specify  the  minimum  memory size required for the
              image being debugged.  n may be prefixed by 0x  for
              hex  values,  and  suffixed  with  either K or M to
              specify KB or MB respectively.

              It should be noted that whether this  option  actu-
              ally  does anything or not is dependent on the user
              supplied memory model linked in  with  armsd.   For
              more information about these see "Memory Models" of
              the Reference Manual.

       -Little
              Specify that memory should be little endian;

       -Big   Specify that memory should be big endian;

       -SErial
              Specify that armsd should act as a front end to the
              Platform  Independent  Evaluation Card (-SErial and
              -Armul are mutually exclusive);

       -Armul Specify that armsd should act as a front end to the
              software   ARM  emulator,  ARMulator  (-SErial  and
              -Armul are mutually exclusive);

              This option is only significant if -SErial is being
              used.   n  specifies  whether  the  first or second
              serial port should be used.

       -LINEspeed n
              This option is only significant if -SErial is being
              used.   n specifies the linespeed for communication
              through the serial  port:  only  the  values  9600,
              19200 and 38400 are permitted.

              Note  that  many of these options can be configured
              as the default, so that they can  be  omitted  from
              the  armsd  command  for  convenience.  See section
              "The ARM Tool Reconfiguration  Utility  (reconfig)"
              for details.

   Armsd Line-Speed Negotiation
       armsd will attempt to operate at the configured line speed
       (9600, 19200 or 38400 baud).

       When first invoked,  and  whenever  it  detects  that  the
       debugee has been reset, armsd operates at 9600 baud. Simi-
       larly, when the debug monitor (demon) is reset,  it  oper-
       ates  at  9600 baud. One of armsd's first acts after reset
       is to send a request to the debug monitor (at  9600  baud)
       to  start  operating at the configured (higher) line rate.
       The default configured line speed for armsd is:

       o   under SunOS: 38400 baud;

       o   under PC/DOS: 19200 baud.

       o   under Macintosh: 19200 baud.

       This can be re-configured  after  installation  using  the
       reconfig  Utility (see "The ARM Tool Reconfiguration Util-
       ity (reconfig)").

SEE ALSO

       reconfig(1)
       Reference Manual, User Manual.