mpsym.1

debug source code under unix platform.

MPSYM(1)                 mpatrol library                 MPSYM(1)


NNAAMMEE
       mpsym - locates missing symbolic information in an mpatrol
       log file

SSYYNNOOPPSSIISS
       mmppssyymm [_o_p_t_i_o_n_s] [_p_r_o_g_f_i_l_e [_l_o_g_f_i_l_e]]

DDEESSCCRRIIPPTTIIOONN
       The mmppssyymm command is used to parse a log file produced  by
       the  mpatrol  library and uses a debugger to append symbol
       names and source level information to  code  addresses  in
       stack  tracebacks.   This  should  be used if the UUSSEEDDEEBBUUGG
       option is not supported on a particular platform  or  does
       not  work  properly  with  a  specific  program.   It will
       replace all existing symbols and source level  information
       associated  with  the  stack tracebacks in the mpatrol log
       file and will display the resulting log file on the  stan-
       dard output file stream.

       The  _p_r_o_g_f_i_l_e  argument  must  be the filename of the exe-
       cutable file that produced the mpatrol  log  file  but  if
       _p_r_o_g_f_i_l_e  is omitted then mmppssyymm will use _a_._o_u_t as the name
       of the executable file to use.   The  mmppssyymm  command  will
       read  the  symbol  table  and debugging sections from this
       file in order to map the code addresses that appear in the
       mpatrol log file into symbol names and source level infor-
       mation.  If the executable file does not contain a  symbol
       table  then  no  symbol  names will be available and if it
       does not contain the appropriate debugging  sections  then
       no  source  level  information  will  be available either.
       Obviously, if the executable file is not the same  as  the
       one  that created the mpatrol log file then the final out-
       put will be wrong.

       The _l_o_g_f_i_l_e argument must be a valid mpatrol log  filename
       but  if _l_o_g_f_i_l_e is omitted then mmppssyymm will use _m_p_a_t_r_o_l_._l_o_g
       as the name of the log file to use, or _p_r_o_g_f_i_l_e_._l_o_g if  it
       can't  find that.  The mmppssyymm command makes two passes over
       the log file so the file must be randomly-accessable.

       The mmppssyymm command currently uses ggddbb as the debugger  with
       which  to obtain the additional information about the code
       addresses in the mpatrol log file.  It also makes  use  of
       several  UNIX  text processing commands, including ppeerrll if
       it is installed, in order to extract information from  the
       debugger's output and from the log file.  As a result, the
       mmppssyymm command is only likely to work on UNIX platforms  or
       on systems which have the necessary commands installed.

OOPPTTIIOONNSS
       ----hheellpp [--hh]
              Displays a quick-reference option summary.

       ----sskkiipp [--ss]
              Skip symbols marked as _?_?_? in the log file.

       ----vveerrssiioonn [--VV]
              Displays the version number of the mmppssyymm command.


SSEEEE AALLSSOO
       mmppaattrrooll(1),  mmpprrooff(1),  mmppttrraaccee(1),  mmlleeaakk(1),  mmppeeddiitt(1),
       hheexxwwoorrddss(1),  ggddbb(1),  ppeerrll(1),  lliibbmmppaattrrooll(3),   lliibbmmppaall--
       lloocc(3).

       The mpatrol manual and reference card.

       http://www.cbmamiga.demon.co.uk/mpatrol/

AAUUTTHHOORR
       Graeme S. Roy <[e-mail]>

CCOOPPYYRRIIGGHHTT
       Copyright  (C)  1997-2002  Graeme  S. Roy <graeme.roy@ana-
       log.com>

       This library is free software;  you  can  redistribute  it
       and/or  modify  it under the terms of the GNU Library Gen-
       eral Public License as  published  by  the  Free  Software
       Foundation;  either  version 2 of the License, or (at your
       option) any later version.

       This library is distributed in the hope that  it  will  be
       useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
       PURPOSE.   See  the GNU Library General Public License for
       more details.

       You should have received a copy of the GNU Library General
       Public  License  along with this library; if not, write to
       the Free Software Foundation, Inc., 59 Temple Place, Suite
       330, Boston, MA 02111-1307, USA.



Release 1.4               8 January 2002                        1