Skip to content

Commit cb217e7

Browse files
committed
Clarify task waiter relationships and fallback task list
1 parent 1c2fbff commit cb217e7

2 files changed

Lines changed: 20 additions & 10 deletions

File tree

‎Modules/_remote_debugging/clinic/module.c.h‎

Lines changed: 10 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎Modules/_remote_debugging/module.c‎

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -913,15 +913,20 @@ Get awaited_by relationships for tasks in the remote process.
913913
Returns:
914914
A list of AwaitedInfo objects, where each object contains:
915915
916-
- thread_id (int): Identifier of the thread.
917-
- awaited_by (list[TaskInfo]): List of TaskInfo objects representing tasks
918-
awaiting this thread.
916+
- thread_id (int): Identifier of the thread, or 0 for tasks in the
917+
interpreter's fallback task list.
918+
- awaited_by (list[TaskInfo]): Tasks registered with this thread.
919919
920920
Each TaskInfo contains:
921921
- task_id (int): Identifier of the task.
922922
- task_name (str): Name of the task.
923923
- coroutine_stack (list[CoroInfo]): Stack of coroutine frames.
924-
- awaited_by (list[TaskInfo]): Nested tasks awaited by this task.
924+
- awaited_by (list[CoroInfo]): Coroutine information for tasks or futures
925+
awaiting this task.
926+
927+
Each CoroInfo contains:
928+
- call_stack (list[FrameInfo]): Call stack frames for the coroutine.
929+
- task_name (int): Identifier of the task or future.
925930
926931
Raises:
927932
RuntimeError: If AsyncioDebug section is not available in the
@@ -948,7 +953,7 @@ Example output:
948953

949954
static PyObject *
950955
_remote_debugging_RemoteUnwinder_get_all_awaited_by_impl(RemoteUnwinderObject *self)
951-
/*[clinic end generated code: output=6a49cd345e8aec53 input=64456ccc05d9bfd2]*/
956+
/*[clinic end generated code: output=6a49cd345e8aec53 input=79e556b3973d21a8]*/
952957
{
953958
if (ensure_async_debug_offsets(self) < 0) {
954959
return NULL;

0 commit comments

Comments
 (0)