starry-kernel 0.10.0

A Linux-compatible OS kernel built on ArceOS unikernel
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

use alloc::sync::{Arc, Weak};

use axpoll::{IoEvents, Pollable};
use axpoll_set::PollSet;

use super::TerminalStateLock;
use crate::{
    StarryError, StarryResult,
    task::{ProcessGroup, Session, current_user_task},
};

pub struct JobControl {
    state: TerminalStateLock<JobControlState>,
    poll_fg: PollSet,
}

struct JobControlState {
    foreground: Weak<ProcessGroup>,
    session: Weak<Session>,
}

impl Default for JobControl {
    fn default() -> Self {
        Self::new()
    }
}

impl JobControl {
    pub fn new() -> Self {
        Self {
            state: TerminalStateLock::new(JobControlState {
                foreground: Weak::new(),
                session: Weak::new(),
            }),
            poll_fg: PollSet::new(),
        }
    }

    pub fn current_in_foreground(&self) -> bool {
        self.state.lock().foreground.upgrade().is_none_or(|pg| {
            Arc::ptr_eq(&current_user_task().as_thread().proc_data.proc.group(), &pg)
        })
    }

    pub fn foreground(&self) -> Option<Arc<ProcessGroup>> {
        self.state.lock().foreground.upgrade()
    }

    pub fn set_foreground(&self, pg: &Arc<ProcessGroup>) -> StarryResult<()> {
        let mut state = self.state.lock();
        let weak = Arc::downgrade(pg);
        if Weak::ptr_eq(&weak, &state.foreground) {
            return Ok(());
        }

        let Some(session) = state.session.upgrade() else {
            return Err(StarryError::OperationNotPermitted);
        };
        if !Arc::ptr_eq(&pg.session(), &session) {
            return Err(StarryError::OperationNotPermitted);
        }

        state.foreground = weak;
        drop(state);
        // Foreground process-group state is published before waking waiters.
        unsafe { self.poll_fg.wake(IoEvents::IN) };
        Ok(())
    }

    pub fn set_session(&self, session: &Arc<Session>) -> StarryResult<()> {
        let mut state = self.state.lock();
        if let Some(existing) = state.session.upgrade() {
            if Arc::ptr_eq(&existing, session) {
                return Ok(());
            }
            return Err(StarryError::ResourceBusy);
        }
        state.session = Arc::downgrade(session);
        Ok(())
    }

    pub fn clear_session(&self, session: &Arc<Session>) {
        let mut state = self.state.lock();
        if state
            .session
            .upgrade()
            .is_some_and(|existing| Arc::ptr_eq(&existing, session))
        {
            state.session = Weak::new();
        }

        let foreground_cleared = state
            .foreground
            .upgrade()
            .is_some_and(|pg| Arc::ptr_eq(&pg.session(), session));
        if foreground_cleared {
            state.foreground = Weak::new();
        }
        drop(state);

        if foreground_cleared {
            // Foreground process-group state is published before waking waiters.
            unsafe { self.poll_fg.wake(IoEvents::IN) };
        }
    }
}

impl Pollable for JobControl {
    fn poll(&self) -> IoEvents {
        let mut events = IoEvents::empty();
        events.set(IoEvents::IN, self.current_in_foreground());
        events
    }

    unsafe fn register_shared(
        &self,
        sink: &mut dyn axpoll::SharedRegistrationSink,
        events: IoEvents,
    ) {
        if events.contains(IoEvents::IN) {
            unsafe { sink.register_shared(&self.poll_fg, IoEvents::IN) };
        }
    }
}