Skip to content

Document IsolateThread - Value 4 #55

@LSantha

Description

@LSantha

IsolateThread

Document the IsolateThread JNode concept in the wiki.

Value: 4

Concept Summary

Thread wrapper for isolated execution contexts with dual-statics architecture. IsolateThread provides the execution mechanism for isolated environments, managing separate static fields and execution contexts while sharing kernel resources.

Key Files

  • core/src/core/org/jnode/vm/isolate/IsolateThread.java
  • core/src/core/org/jnode/vm/isolate/Isolate.java

Occurrences

~80 references in isolate classes

Wiki Status

NOT documented

Bridges

Isolate, Thread scheduling, Memory management

Instructions

Skill to Use

Use the [[update-wiki|update-wiki skill]] (load with skill({ name: "update-wiki" })) for understanding JNode internals.

Context Research

Study IsolateThread.java to understand the thread wrapper implementation and how it integrates with isolates. Review Isolate.java to understand the isolate context. Research how dual-statics works and how isolation is maintained.

Update index.md

  • Pages table: Add entry for IsolateThread.md
  • Concepts → Pages table: Add "IsolateThread" mapping to [[IsolateThread]]
  • Source Path → Pages table: Add mappings for core/src/core/org/jnode/vm/isolate/
  • Task Routing table: Add relevant task route(s)

Wiki Page Structure

# IsolateThread

> Thread wrapper for isolated execution contexts with dual-statics architecture.

## Overview
2-3 paragraph explanation of IsolateThread, its role in process isolation, and how it enables separate execution contexts.

## Key Components
| Class / File | Role |
|---|---|
| `core/src/core/org/jnode/vm/isolate/IsolateThread.java` | Thread wrapper implementation |
| `core/src/core/org/jnode/vm/isolate/Isolate.java` | Isolate context management |

## How It Works
Explanation of how IsolateThread wraps regular threads, maintains separate static fields, and integrates with the scheduler.

## Gotchas & Non-Obvious Behavior
- Dual-statics architecture requires special handling of static fields
- Thread state must be managed carefully across isolation boundaries
- Resource sharing vs. isolation is a key design consideration

## Related Pages
- [[Isolate]]
- [[VMProcessClassLoader]]
- [[LoadStatics-Annotation]]

Related Concepts: Isolate, LoadStatics, Thread scheduling, Memory management, Process isolation

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions