xous-core/xous-rs/src/arch/native.rs
Sean Cross 977a175bb5 xous: mark MemoryRange::new() as unsafe
This function allows for creating arbitrary memory ranges. Mark this
function as `unsafe` in order to warn users that this can be used to
create invalid memory regions.

Signed-off-by: Sean Cross <sean@xobs.io>
2021-06-24 17:02:02 +08:00

381 lines
8.7 KiB
Rust

use crate::{MemoryRange, PID, TID};
use core::convert::TryInto;
mod mem;
pub use mem::*;
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct ProcessArgs {
name: [u8; 16],
}
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct ThreadInit {
/// Function pointer that accepts 0-4 arguments
pub call: usize,
pub stack: MemoryRange,
pub arg1: usize,
pub arg2: usize,
pub arg3: usize,
pub arg4: usize,
// pub name: [u8; 12],
}
impl ThreadInit {
pub fn new(
call: usize,
stack: MemoryRange,
arg1: usize,
arg2: usize,
arg3: usize,
arg4: usize,
// name: [u8; 12],
) -> Self {
ThreadInit {
call,
stack,
arg1,
arg2,
arg3,
arg4,
// name,
}
}
}
impl Default for ThreadInit {
fn default() -> Self {
ThreadInit {
call: 1,
stack: unsafe { MemoryRange::new(4, 4).unwrap() },
arg1: 0,
arg2: 0,
arg3: 0,
arg4: 0,
// name: [0; 12],
}
}
}
#[derive(Copy, Clone, Debug, PartialEq)]
pub struct ProcessKey([u8; 8]);
impl ProcessKey {
pub fn new(key: [u8; 8]) -> ProcessKey {
ProcessKey(key)
}
}
#[derive(Copy, Clone, Debug, PartialEq)]
pub struct ProcessInit {
pub key: ProcessKey,
}
pub struct WaitHandle<T> {
tid: TID,
data: core::marker::PhantomData<T>,
}
pub struct ProcessHandle(());
pub fn thread_to_args(syscall: usize, init: &ThreadInit) -> [usize; 8] {
[
syscall,
init.call,
init.stack.as_ptr() as _,
init.stack.len(),
init.arg1,
init.arg2,
init.arg3,
init.arg4,
]
}
/// This code is executed inside the kernel. It takes the list of args
/// that were passed via registers and converts them into a `ThreadInit`
/// struct with enough information to start the new thread.
pub fn args_to_thread(
a1: usize,
a2: usize,
a3: usize,
a4: usize,
a5: usize,
a6: usize,
a7: usize,
) -> core::result::Result<ThreadInit, crate::Error> {
Ok(ThreadInit {
call: a1,
stack: unsafe { MemoryRange::new(a2, a3).map_err(|_| crate::Error::InvalidSyscall) }?,
arg1: a4,
arg2: a5,
arg3: a6,
arg4: a7,
// name: [0; 12],
})
}
pub fn create_thread_pre<F, T>(_f: &F) -> core::result::Result<ThreadInit, crate::Error>
where
F: FnOnce() -> T,
F: Send + 'static,
T: Send + 'static,
{
todo!()
}
pub fn create_thread_post<F, T>(
_f: F,
_thread_id: TID,
) -> core::result::Result<WaitHandle<T>, crate::Error>
where
F: FnOnce() -> T,
F: Send + 'static,
T: Send + 'static,
{
todo!()
}
pub fn wait_thread<T>(joiner: WaitHandle<T>) -> crate::SysCallResult {
let call = crate::SysCall::JoinThread(joiner.tid);
crate::syscall::rsyscall(call)
}
pub fn process_to_args(call: usize, init: &ProcessInit) -> [usize; 8] {
[
call,
u32::from_le_bytes(init.key.0[0..4].try_into().unwrap()) as _,
u32::from_le_bytes(init.key.0[4..8].try_into().unwrap()) as _,
u32::from_le_bytes(init.key.0[8..12].try_into().unwrap()) as _,
u32::from_le_bytes(init.key.0[12..16].try_into().unwrap()) as _,
0,
0,
0,
]
}
pub fn args_to_process(
_a1: usize,
_a2: usize,
_a3: usize,
_a4: usize,
_a5: usize,
_a6: usize,
_a7: usize,
) -> core::result::Result<ProcessInit, crate::Error> {
todo!()
}
pub fn create_thread_0_pre<U>(f: &fn() -> U) -> core::result::Result<ThreadInit, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(*f) };
create_thread_n_pre(start, &0, &0, &0, &0)
}
pub fn create_thread_0_post<U>(
f: fn() -> U,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(f) };
create_thread_n_post(start, 0, 0, 0, 0, thread_id)
}
pub fn create_thread_1_pre<U>(
f: &fn(usize) -> U,
arg1: &usize,
) -> core::result::Result<ThreadInit, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(*f) };
create_thread_n_pre(start, arg1, &0, &0, &0)
}
pub fn create_thread_1_post<U>(
f: fn(usize) -> U,
arg1: usize,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(f) };
create_thread_n_post(start, arg1, 0, 0, 0, thread_id)
}
pub fn create_thread_2_pre<U>(
f: &fn(usize, usize) -> U,
arg1: &usize,
arg2: &usize,
) -> core::result::Result<ThreadInit, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(*f) };
create_thread_n_pre(start, arg1, arg2, &0, &0)
}
pub fn create_thread_2_post<U>(
f: fn(usize, usize) -> U,
arg1: usize,
arg2: usize,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(f) };
create_thread_n_post(start, arg1, arg2, 0, 0, thread_id)
}
pub fn create_thread_3_pre<U>(
f: &fn(usize, usize, usize) -> U,
arg1: &usize,
arg2: &usize,
arg3: &usize,
) -> core::result::Result<ThreadInit, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(*f) };
create_thread_n_pre(start, arg1, arg2, arg3, &0)
}
pub fn create_thread_3_post<U>(
f: fn(usize, usize, usize) -> U,
arg1: usize,
arg2: usize,
arg3: usize,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(f) };
create_thread_n_post(start, arg1, arg2, arg3, 0, thread_id)
}
pub fn create_thread_4_pre<U>(
f: &fn(usize, usize, usize, usize) -> U,
arg1: &usize,
arg2: &usize,
arg3: &usize,
arg4: &usize,
) -> core::result::Result<ThreadInit, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(*f) };
create_thread_n_pre(start, arg1, arg2, arg3, arg4)
}
pub fn create_thread_4_post<U>(
f: fn(usize, usize, usize, usize) -> U,
arg1: usize,
arg2: usize,
arg3: usize,
arg4: usize,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
U: Send + 'static,
{
let start = unsafe { core::mem::transmute(f) };
create_thread_n_post(start, arg1, arg2, arg3, arg4, thread_id)
}
pub fn create_thread_simple_pre<T, U>(
f: &fn(T) -> U,
arg: &T,
) -> core::result::Result<ThreadInit, crate::Error>
where
T: Send + 'static,
U: Send + 'static,
{
create_thread_n_pre(
unsafe { core::mem::transmute(*f) },
unsafe { core::mem::transmute(arg) },
&0,
&0,
&0,
)
}
pub fn create_thread_simple_post<T, U>(
f: fn(T) -> U,
arg: T,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
T: Send + 'static,
U: Send + 'static,
{
create_thread_n_post(
unsafe { core::mem::transmute(f) },
unsafe { core::mem::transmute(&arg) },
0,
0,
0,
thread_id,
)
// If we succeeded, the variable will be moved into the caller. Drop it from here.
.and_then(|f| {
core::mem::forget(arg);
Ok(f)
})
}
/// If no connection exists, create a new connection to the server. This means
/// our parent PID will be PID1. Otherwise, reuse the same connection.
pub fn create_process_pre(_args: &ProcessArgs) -> core::result::Result<ProcessInit, crate::Error> {
todo!()
}
pub fn create_process_post(
_args: ProcessArgs,
_init: ProcessInit,
_pid: PID,
) -> core::result::Result<ProcessHandle, crate::Error> {
todo!()
}
pub fn create_thread_n_pre(
start: usize,
arg1: &usize,
arg2: &usize,
arg3: &usize,
arg4: &usize,
) -> core::result::Result<ThreadInit, crate::Error> {
#[cfg(feature = "bit-flags")]
let flags = crate::MemoryFlags::R | crate::MemoryFlags::W | crate::MemoryFlags::RESERVE;
#[cfg(not(feature = "bit-flags"))]
let flags = 0b0000_0010 | 0b0000_0100 | 0b0000_0001;
let stack = crate::map_memory(None, None, 131_072, flags)?;
Ok(ThreadInit::new(start, stack, *arg1, *arg2, *arg3, *arg4))
}
pub fn create_thread_n_post<U>(
_f: usize,
_arg1: usize,
_arg2: usize,
_arg3: usize,
_arg4: usize,
thread_id: TID,
) -> core::result::Result<WaitHandle<U>, crate::Error>
where
U: Send + 'static,
{
Ok(WaitHandle {
tid: thread_id,
data: core::marker::PhantomData,
})
}
pub fn wait_process(_joiner: ProcessHandle) -> crate::SysCallResult {
loop {
crate::wait_event();
}
}