mpatrol.1

debug source code under unix platform.

       ----ppaaggee--aalllloocc--lloowweerr [--bb]
              [PPAAGGEEAALLLLOOCC=_L_O_W_E_R]  Specifies that  each  individual
              memory  allocation  should occupy at least one page
              of virtual memory and should be placed at the  low-
              est point within these pages.

       ----ppaaggee--aalllloocc--uuppppeerr [--BB]
              [PPAAGGEEAALLLLOOCC=_U_P_P_E_R]   Specifies  that each individual
              memory allocation should occupy at least  one  page
              of virtual memory and should be placed at the high-
              est point within these pages.

       ----pprreesseerrvvee [--vv]
              [PPRREESSEERRVVEE]  Specifies that any reallocated or freed
              memory  allocations  should preserve their original
              contents.

       ----pprrooff [--pp]
              [PPRROOFF]  Specifies that all memory  allocations  are
              to  be  profiled  and  sent to the profiling output
              file.

       ----pprrooff--ffiillee <_s_t_r_i_n_g> [--PP]
              [PPRROOFFFFIILLEE]  Specifies an alternative file in  which
              to  place  all memory allocation profiling informa-
              tion from the mpatrol library.

       ----pprroogg--ffiillee <_s_t_r_i_n_g> [--rr]
              [PPRROOGGFFIILLEE]  Specifies an alternative filename  with
              which  to locate the executable file containing the
              program's symbols.

       ----rreeaadd--eennvv [--II]
              Reads and passes through the contents of  the  MMPPAA--
              TTRROOLL__OOPPTTIIOONNSS  environment  variable.  Such contents
              will be placed before any of the options  resulting
              from  mmppaattrrooll command line options so that they can
              be overridden and will only be parsed by  the  mpa-
              trol library, _n_o_t the mmppaattrrooll command.

       ----rreeaalllloocc--ssttoopp <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r> [--RR]
              [RREEAALLLLOOCCSSTTOOPP]   Specifies  an  allocation  index at
              which to stop the program when a memory  allocation
              is being reallocated.

       ----ssaaffee--ssiiggnnaallss [--GG]
              [SSAAFFEESSIIGGNNAALLSS]   Instructs  the  library to save and
              replace certain signal handlers during  the  execu-
              tion  of  library  code  and to restore them after-
              wards.

       ----sshhooww--aallll [--SS]
              [SSHHOOWWAALLLL]    Equivalent   to    the    ----sshhooww--ffrreeee,
              ----sshhooww--ffrreeeedd,    ----sshhooww--uunnffrreeeedd,   ----sshhooww--mmaapp   and
              ----sshhooww--ssyymmbboollss options specified together.

       ----sshhooww--eennvv [--EE]
              Displays the contents of the MMPPAATTRROOLL__OOPPTTIIOONNSS  envi-
              ronment  variable.  This will be shown after all of
              the other command line options have been  processed
              and  will  prevent the specified command from being
              run.

       ----sshhooww--ffrreeee
              [SSHHOOWWFFRREEEE]  Specifies that a summary of all of  the
              free  memory  blocks should be displayed at the end
              of program execution.

       ----sshhooww--ffrreeeedd
              [SSHHOOWWFFRREEEEDD]  Specifies that a summary of all of the
              freed memory allocations should be displayed at the
              end of program execution.

       ----sshhooww--mmaapp
              [SSHHOOWWMMAAPP]  Specifies  that  a  memory  map  of  the
              entire  heap should be displayed at the end of pro-
              gram execution.

       ----sshhooww--ssyymmbboollss
              [SSHHOOWWSSYYMMBBOOLLSS]  Specifies that a summary of  all  of
              the  function  symbols read from the program's exe-
              cutable file should be displayed at the end of pro-
              gram execution.

       ----sshhooww--uunnffrreeeedd
              [SSHHOOWWUUNNFFRREEEEDD]   Specifies  that a summary of all of
              the unfreed memory allocations should be  displayed
              at the end of program execution.

       ----ssmmaallll--bboouunndd <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r>
              [SSMMAALLLLBBOOUUNNDD]   Specifies  the  limit in bytes up to
              which memory allocations should  be  classified  as
              small allocations for profiling purposes.

       ----tthhrreeaaddss [--jj]
              Specifies  that  the  program  to  be run is multi-
              threaded if the ----ddyynnaammiicc  option  is  used.   This
              option  is required if the multithreaded version of
              the mpatrol library should be preloaded instead  of
              the normal version.

       ----ttrraaccee [--tt]
              Specifies  that  all  memory  allocations are to be
              traced and sent to the tracing output file.

       ----ttrraaccee--ffiillee <_s_t_r_i_n_g> [--TT]
              Specifies an alternative file in which to place all
              memory allocation tracing information from the mpa-
              trol library.

       ----uunnffrreeeedd--aabboorrtt <_u_n_s_i_g_n_e_d _i_n_t_e_g_e_r> [--UU]
              [UUNNFFRREEEEDDAABBOORRTT]  Specifies  the  minimum  number  of
              unfreed  allocations  at which to abort the program
              just before program termination.

       ----uussee--ddeebbuugg [--gg]
              [UUSSEEDDEEBBUUGG]  Specifies that any  debugging  informa-
              tion  in  the  executable  file  should  be used to
              obtain additional source-level information.

       ----uussee--mmmmaapp [--mm]
              [UUSSEEMMMMAAPP]  Specifies that the  library  should  use
              mmmmaapp(()) instead of ssbbrrkk(()) to allocate user memory.

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

SSEEEE AALLSSOO
       mmpprrooff(1), mmppttrraaccee(1), mmlleeaakk(1), mmppssyymm(1), mmppeeddiitt(1),  hheexx--
       wwoorrddss(1), lliibbmmppaattrrooll(3), lliibbmmppaalllloocc(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