gcc/m2/gm2-libs/gdbif.def

   1 (* gdbif.def enable interactive connectivity with gdb.
   2
   3 Copyright (C) 2011-2024 Free Software Foundation, Inc.
   4 Contributed by Gaius Mulley <gaius.mulley@southwales.ac.uk>.
   5
   6 This file is part of GNU Modula-2.
   7
   8 GNU Modula-2 is free software; you can redistribute it and/or modify
   9 it under the terms of the GNU General Public License as published by
  10 the Free Software Foundation; either version 3, or (at your option)
  11 any later version.
  12
  13 GNU Modula-2 is distributed in the hope that it will be useful, but
  14 WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 General Public License for more details.
  17
  18 Under Section 7 of GPL version 3, you are granted additional
  19 permissions described in the GCC Runtime Library Exception, version
  20 3.1, as published by the Free Software Foundation.
  21
  22 You should have received a copy of the GNU General Public License and
  23 a copy of the GCC Runtime Library Exception along with this program;
  24 see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
  25 <http://www.gnu.org/licenses/>.  *)
  26
  27 DEFINITION MODULE gdbif ;
  28
  29 (*  Provides interactive connectivity with gdb useful for debugging
  30     Modula-2 shared libraries.  *)
  31
  32 EXPORT UNQUALIFIED sleepSpin, finishSpin, connectSpin ;
  33
  34
  35 (*
  36    finishSpin - sets boolean mustWait to FALSE.
  37 *)
  38
  39 PROCEDURE finishSpin ;
  40
  41
  42 (*
  43    sleepSpin - waits for the boolean variable mustWait to become FALSE.
  44                It sleeps for a second between each test of the variable.
  45 *)
  46
  47 PROCEDURE sleepSpin ;
  48
  49
  50 (*
  51    connectSpin - breakpoint placeholder.  Its only purpose is to allow users
  52                  to set a breakpoint.  This procedure is called once
  53                  sleepSpin is released from its spin (via a call from
  54                  finishSpin).
  55 *)
  56
  57 PROCEDURE connectSpin ;
  58
  59
  60 END gdbif.