"{ Encoding: utf8 }"

"

jv:libgdbs - GNU Debugger Interface Library

Copyright (C) 2015-now Jan Vrany

This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License. 

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

Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public

License along with this library; if not, write to the Free Software

Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA

"

"{ Package: 'jv:libgdbs' }"

"{ NameSpace: Smalltalk }"

GDBDebuggerObject subclass:#GDBThreadGroup

	instanceVariableNames:'id type executable running pid exit_code threads registersMap'

	classVariableNames:'ExecutableSentinel'

	poolDictionaries:'GDBCommandStatus'

	category:'GDB-Core'

!

!GDBThreadGroup class methodsFor:'documentation'!

copyright

"

jv:libgdbs - GNU Debugger Interface Library

Copyright (C) 2015-now Jan Vrany

This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License. 

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

Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public

License along with this library; if not, write to the Free Software

Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA

"

! !

!GDBThreadGroup class methodsFor:'initialization'!

initialize

    "Invoked at system start or when the class is dynamically loaded."

    ExecutableSentinel := Object new.

    "Modified: / 07-06-2018 / 10:05:35 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup class methodsFor:'instance creation'!

new

    "return an initialized instance"

    ^ self basicNew initialize.

!

newWithDebugger: debugger id: aString

    ^ self new setDebugger: debugger; setId: aString; yourself

    "Created: / 07-09-2014 / 21:18:36 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup class methodsFor:'accessing - GDB value descriptors'!

description

    ^ (super description)

        define:#id as:String;

        define:#pid as:Integer;

        yourself.

    "

    self description

    "

    "Created: / 06-09-2014 / 02:21:51 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified (comment): / 01-10-2014 / 01:29:30 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

descriptionType

    ^ Magritte::MASingleOptionDescription new

        optionsAndLabels: (Array with: 

            GDBThreadGroupTypeProcess -> 'process'  

        );

        accessor: (GDBMAPropertyAccessor forPropertyNamed: 'type');

        label: 'type';

        comment: 'The type of the thread group. At present, only ‘process’ is a valid type.';

        yourself.

    "Created: / 01-10-2014 / 01:29:13 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 17-11-2017 / 20:08:31 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup methodsFor:'accessing'!

executable

    "Return name path of the executable (if known) or nil (if unknown)"

    (executable isNil and:[ pid notNil and:[self isStopped or:[debugger hasFeature:'async']]]) ifTrue:[

        debugger send: GDBMI_list_thread_groups new andWithResultDo:[:result|

            | tg |

            result status ~~ CommandStatusDone ifTrue:[ 

                self error: 'Failed to send command.'

            ].

            tg := (result propertyAt: 'groups') detect: [: each | each id = id ].

            "/ In some cases the executable is not known - it may not exist (such as

            "/ when debugging bare-metal code) or the target does not report it

            "/ (may happen, for example wine's winedbg GDB proxy does not report

            "/ executable names).

            "/ 

            "/ In this case, we store a sentinel object in `executable` instvar

            "/ to prevent repeated queries which are bound to fail (see the nil-check

            "/ above.

            executable := tg executableOrNil ? ExecutableSentinel.

        ].

    ].

    ^ executable == ExecutableSentinel ifTrue:[ nil ] ifFalse:[ executable ]

    "Created: / 06-06-2017 / 00:04:43 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 26-03-2018 / 21:44:53 / jv"

    "Modified: / 28-01-2019 / 14:57:33 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

executableOrNil

    ^ executable

    "Created: / 06-06-2018 / 15:43:12 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

exitCode

    ^ exit_code

    "Created: / 07-09-2014 / 12:34:44 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

id

    ^ id

!

pid

    ^ pid

!

threadWithId: tid

    ^ threads ? #() detect:[:e | e isDead not and:[ e id = tid ] ] ifNone:[

        self error: ('No thread with id ''%1'' found!!' bindWith: tid)        

    ].

    "Created: / 07-09-2014 / 21:37:01 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 22-09-2014 / 01:23:40 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

threads

    threads isNil ifTrue:[ 

        threads := List new.

    ]. 

    ^ threads

    "Modified: / 06-09-2014 / 02:23:22 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified (format): / 07-09-2014 / 21:42:28 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

type

    ^ type

! !

!GDBThreadGroup methodsFor:'event handling'!

onThreadCreatedEvent:aGDBThreadCreatedEvent 

    | thread |

    threads isNil ifTrue:[

        threads := List new.

    ].

    thread := GDBThread 

            newWithDebugger:debugger

            id:aGDBThreadCreatedEvent threadId

            group:self.

    threads add:thread.

    aGDBThreadCreatedEvent setThread:thread.

    "Created: / 07-09-2014 / 21:25:08 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

onThreadExitedEvent:aGDBThreadExitedEvent 

    | thread |

    thread := self threadWithId:aGDBThreadExitedEvent threadId.

    threads remove: thread.

    thread setStatus: GDBThreadStateTerminated theOneAndOnlyInstance.

    aGDBThreadExitedEvent setThread:thread.

    "Created: / 07-09-2014 / 21:25:24 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 12-07-2017 / 13:42:31 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 15-01-2018 / 09:44:09 / jv"

!

onThreadSelectedEvent: aGDBThreadSelectedEvent

    | thread frame |

    thread := self threadWithId:aGDBThreadSelectedEvent threadId.

    frame := aGDBThreadSelectedEvent frame.

    aGDBThreadSelectedEvent setThread: thread.

    "/ Be carefull, thread may be running!!

    (thread isStopped and:[frame notNil]) ifTrue:[ 

        aGDBThreadSelectedEvent setFrame: (thread stack at: (frame level + 1))

    ] ifFalse:[ 

        "/ If it is running, at least fixup it's frame, if there's any (it may not

        "/ if the thread is running at the time of =thread-select event.

        "/ Uff, so many cases...

        frame notNil ifTrue:[

            frame 

                setDebugger: debugger;

                setThread: thread.

        ].

    ].

    "Created: / 29-07-2018 / 22:21:48 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 26-01-2019 / 23:35:58 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup methodsFor:'initialization'!

initialize

    "Invoked when a new instance is created."

    running := false.

    registersMap := Dictionary new.

    "Modified: / 26-09-2018 / 09:53:17 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

reset

    "Reset all internal caches. Invoked bu debugger when an inferior

     starts. This is necessary since GDB recycles inferors and so we

     do."

    registersMap := Dictionary new.

    "Created: / 26-09-2018 / 10:58:11 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

setExitCode: anInteger

    exit_code := anInteger.

    running := false.

    threads removeAll.

    "Created: / 06-09-2014 / 02:33:14 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 06-06-2017 / 00:24:31 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

setId: aString

    id := aString.

    "Created: / 06-09-2014 / 02:32:33 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

setPid: anInteger

    pid := anInteger.

    exit_code := nil.

    executable := nil.

    running := true.

    "Created: / 06-09-2014 / 02:32:38 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 06-06-2017 / 00:24:21 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup methodsFor:'printing & storing'!

printOn:aStream

    "append a printed representation if the receiver to the argument, aStream"

    super printOn: aStream.

    aStream nextPutAll:'(id '.

    id printOn:aStream.

    aStream nextPutAll:', pid '.

    pid printOn:aStream.

    aStream nextPutAll:')'.

    "Modified: / 02-03-2015 / 07:10:31 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup methodsFor:'private'!

registersMap

    ^ registersMap

    "Created: / 26-09-2018 / 10:01:03 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

threadAdd: aGDBThread

    self threads add: aGDBThread

    "Created: / 06-09-2014 / 02:23:47 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

threadRemove: aGDBThread

    self threads remove: aGDBThread

    "Created: / 06-09-2014 / 02:23:58 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup methodsFor:'testing'!

isDead

    "Return true if program finished, either normally or abruptly (usng `kill` command).

     To tell whether is has finished normally or it has been terminated see

     #isFinished and / or #isTerminated"

    ^ self isRunning not and:[ pid notNil ]

    "Created: / 06-09-2014 / 02:38:31 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 06-06-2017 / 09:22:58 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

isFinished

    "Return true if program finished its execution normally (as opposed to be

     terminated by the debugger), false otherwise. 

     @see also #isTerminated

     @see also #isDead

    "

    ^ self isDead  and:[ exit_code notNil ]

    "Created: / 06-06-2017 / 09:23:50 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

isRunning

    "Return true, if program is currently running, false otherwise.

     Note, that program is running even of it's stopped byt the debugger.

     See #isStopped"

    ^ running

    "Created: / 06-09-2014 / 02:38:18 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 06-06-2017 / 00:25:24 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

isStopped

    ^ threads notEmptyOrNil and:[ threads anySatisfy: [:t | t isStopped ] ].

    "Created: / 30-09-2014 / 00:49:58 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

isTerminated

    "Return true if program has been terminated (as opposed to finishing normally),

     false otherwise.

     @see also #isFinished

     @see also #isDead

    "

    ^ self isDead and:[ exit_code isNil ]

    "Created: / 06-06-2017 / 09:26:31 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

isValid

    ^ debugger isConnected and:[ self isDead not ]

    "Created: / 04-02-2018 / 21:31:49 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!GDBThreadGroup class methodsFor:'documentation'!

version_HG

    ^ '$Changeset: <not expanded> $'

! !

GDBThreadGroup initialize!