Enum GilSite 

pub enum GilSite {
    EndpointDispatch,
    QueueDispatch,
    DispatchInit,
    EndpointCleanup,
    Supervise,
    DisplayName,
    ActorConstruct,
    Bootstrap,
    TaskLocals,
    ReplyConvert,
    Reducer,
    Accumulate,
    Convert,
    Traceback,
    AwaitDrive,
    Stop,
    Debugger,
    Logging,
    CodeSync,
    Rdma,
    WorkerInit,
    StreamCompute,
    Test,
}

A sanctioned GIL acquisition operation, identifying why a monarch_with_gil/monarch_with_gil_blocking site takes the GIL. Each variant names one distinct operation so is_control_plane_allowed can classify it. There is deliberately no catch-all: a new GIL site must add a variant and classify it, or the code will not compile.

This sanctioned set is transitional and meant to shrink: the goal is to move Python off the control-plane runtime entirely, retiring these operations over time, so the allow-list (and this enum) trends toward empty. New variants should be rare and short-lived.

Variants

EndpointDispatch

Dispatch a message to a Python endpoint (direct dispatch).

QueueDispatch

Build a queued message for queue-dispatch mode.

DispatchInit

Start the Python dispatch loop during actor init.

EndpointCleanup

Run an actor’s __cleanup__.

Supervise

Run __supervise__, or inspect a supervision result.

DisplayName

Render an actor’s display name.

ActorConstruct

Construct a PythonActor (unpickle the actor type).

Bootstrap

Bootstrap a client actor, or convert bootstrap addresses.

TaskLocals

Create or clone a TaskLocals (asyncio event loop).

ReplyConvert

Convert a port reply into a Python value.

Reducer

Run a comm reducer.

Accumulate

Run an accumulator.

Convert

Convert a Rust value into a Python value (or clone a Python value).

Traceback

Capture, format, or clone a Python traceback or exception.

AwaitDrive

Drive a Python coroutine or blocking task on the bridge.

Stop

Cancel pending tasks, stop an event loop, or interrupt the client.

Debugger

Interactive debugger read/write.

Logging

Get or set a Python logger.

CodeSync

Run the code-sync auto-reloader.

Rdma

Register or operate RDMA buffers (runs on the data plane).

WorkerInit

Worker-process startup: torch import, env init. Runs on the control-plane runtime (the WorkerActor has no data-plane override).

StreamCompute

Tensor/Python work on the StreamActor data-plane runtime.

Test

Test-only GIL use.

Trait Implementations

impl Clone for GilSite

fn clone(&self) -> GilSite

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GilSite

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for GilSite

fn eq(&self, other: &GilSite) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for GilSite

impl Eq for GilSite

impl StructuralPartialEq for GilSite