go-lib 0.3.1

rust native goroutines
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

// SPDX-License-Identifier: Apache-2.0
//! Goroutine scheduler internals.
//!
//! Ported from `src/runtime/` in <https://github.com/golang/go>.  Each submodule
//! maps to the Go source file(s) shown below.
//!
//! ## v0.2.0 additions
//!
//! | New module / symbol | Purpose |
//! |----|-----|
//! | `stack` — `newstack`, `copystack`, `sigsegv_handler` | Dynamic goroutine stack growth (Step 3) |
//! | `m` — `pthread_id`, `setup_sigaltstack` | Per-M thread ID + 64 KiB alternate signal stack (Step 4) |
//! | `sched` — `async_preempt2`, `sigurg_handler` | Non-cooperative goroutine preemption via SIGURG (Step 4) |
//! | `asm_amd64`/`asm_arm64` — `async_preempt_trampoline` | Save/restore all registers around the preemption yield (Step 4) |
//! | `sysmon` — `pthread_kill(SIGURG)` in `preemptone` | Signal delivery for async preemption (Step 4) |
//! | `netpoll` | epoll (Linux) / kqueue (macOS) / IOCP (Windows) I/O backend (Step 5) |
//!
//! ## v0.3.0 additions
//!
//! | New module / symbol | Purpose |
//! |----|-----|
//! | `g` — `casgstatus`, `castogscanstatus`, `casfrom_gscanstatus`, `readgstatus` | Centralised atomic G state-transition helpers (mirrors Go's `casgstatus`) |
//! | `g` — `scan_stack` | GSCAN freeze/unfreeze scaffolding for a future GC stack scanner |
//! | `syscall` — `entersyscall`/`exitsyscall` | G transitions to/from `GSYSCALL` state |
//! | `stack` — `copystack` | G transitions through `GCOPYSTACK` during stack-copy |
//! | `sched` — `preemptm` | G transitions through `GPREEMPTED` (Go 1.14+ async-preempt protocol) |
//! | `park` — `goready` | Accepts `GPREEMPTED` as well as `GWAITING` when readying a G |
//! | `asm_amd64`/`asm_arm64` — `systemstack`, `systemstack_call` | Runs a closure on the M's g0 stack via a naked RSP/SP switch |
//!
//! | This module   | Go source                                                   |
//! |---------------|-------------------------------------------------------------|
//! | `g`           | `runtime/runtime2.go`                                       |
//! | `m`           | `runtime/runtime2.go`, `runtime/proc.go`                    |
//! | `p`           | `runtime/runtime2.go`, `runtime/proc.go`                    |
//! | `sched`       | `runtime/proc.go`, `runtime/preempt.go`                     |
//! | `stack`       | `runtime/stack.go`, `runtime/signal_unix.go`                |
//! | `netpoll`     | `runtime/netpoll_epoll.go`, `runtime/netpoll_kqueue.go`, `runtime/netpoll_windows.go` |
//! | `park`        | `runtime/proc.go` (gopark / goready)                        |
//! | `sudog`       | `runtime/runtime2.go`, `runtime/proc.go`                    |
//! | `syscall`     | `runtime/proc.go` (entersyscall / exitsyscall)              |
//! | `sysmon`      | `runtime/proc.go` (sysmon / retake)                         |
//! | `time`        | `runtime/time.go`                                           |
//! | `asm_amd64`   | `runtime/asm_amd64.s`, `runtime/preempt_amd64.s`           |
//! | `asm_arm64`   | `runtime/asm_arm64.s`, `runtime/preempt_arm64.s`           |


pub(crate) mod g;
pub(crate) mod m;
pub(crate) mod rawmutex;
pub(crate) mod netpoll;
pub(crate) mod p;
pub(crate) mod park;
pub(crate) mod sched;
pub(crate) mod stack;
pub(crate) mod sudog;
pub(crate) mod syscall;
pub(crate) mod sysmon;
pub(crate) mod time;

#[cfg(target_arch = "x86_64")]
pub(crate) mod asm_amd64;
#[cfg(target_arch = "aarch64")]
pub(crate) mod asm_arm64;

// Re-export the three context-switch primitives from the correct asm module
// so the rest of the runtime uses `crate::runtime::{gogo, mcall, systemstack}`
// without caring about the target architecture.
#[cfg(target_arch = "aarch64")]
pub(crate) use asm_arm64::{gogo, mcall, systemstack};