MaxOS::system::SyscallManager Class Reference

Provides an API for userspace applications to interact with the kernel. More...

#include <syscalls.h>

Inheritance diagram for MaxOS::system::SyscallManager:

Public Member Functions
	SyscallManager ()
	Construct a new Syscall Manager object and register the syscall handlers. Registers to interrupt 0x80.
cpu_status_t *	handle_interrupt (cpu_status_t *esp) final
	Loads the args from the registers and delegates the syscall to the relevant handler if defined.
void	set_syscall_handler (::MaxOS::KPI::SyscallType syscall, syscall_func_t handler)
	Loads a syscall handler into the manager.
void	remove_syscall_handler (::MaxOS::KPI::SyscallType syscall)
	Removes a syscall handler from the manager.

Static Public Member Functions
static syscall_args_t *	syscall_klog (syscall_args_t *args)
	System call to log a message to the kernel log.
static syscall_args_t *	syscall_allocate_memory (syscall_args_t *args)
	System call to allocate a block of memory.
static syscall_args_t *	syscall_free_memory (syscall_args_t *args)
	System call to free a block of memory.
static syscall_args_t *	syscall_resource_create (syscall_args_t *args)
	System call to create a resource.
static syscall_args_t *	syscall_resource_open (syscall_args_t *args)
	System call to open a resource.
static syscall_args_t *	syscall_resource_close (syscall_args_t *args)
	System call to close a resource.
static syscall_args_t *	syscall_resource_write (syscall_args_t *args)
	System call to write to a resource.
static syscall_args_t *	syscall_resource_read (syscall_args_t *args)
	System call to read from a resource.
static syscall_args_t *	syscall_resource_registry_create (syscall_args_t *args)
	System call to create a new resource registry.

Detailed Description

Provides an API for userspace applications to interact with the kernel.

Todo:

Very c style, should be made class based that automatically registers

Definition at line 59 of file syscalls.h.

Constructor & Destructor Documentation

SyscallManager()

SyscallManager::SyscallManager

(

)

Construct a new Syscall Manager object and register the syscall handlers. Registers to interrupt 0x80.

Definition at line 24 of file syscalls.cpp.

: InterruptHandler(0x80)
{
 
    // Register the handlers
    Logger::INFO() << "Setting up Syscalls \n";
 
    set_syscall_handler(SyscallType::KLOG, syscall_klog);
 
    set_syscall_handler(SyscallType::ALLOCATE_MEMORY, syscall_allocate_memory);
    set_syscall_handler(SyscallType::FREE_MEMORY, syscall_free_memory);
 
    set_syscall_handler(SyscallType::RESOURCE_CREATE, syscall_resource_create);
    set_syscall_handler(SyscallType::RESOURCE_OPEN, syscall_resource_open);
    set_syscall_handler(SyscallType::RESOURCE_CLOSE, syscall_resource_close);
    set_syscall_handler(SyscallType::RESOURCE_WRITE, syscall_resource_write);
    set_syscall_handler(SyscallType::RESOURCE_READ, syscall_resource_read);
 
    set_syscall_handler(SyscallType::RESOURCE_REGISTRY_CREATE, syscall_resource_registry_create);
 
 
}

References MaxOS::Logger::INFO(), set_syscall_handler(), syscall_allocate_memory(), syscall_free_memory(), syscall_klog(), syscall_resource_close(), syscall_resource_create(), syscall_resource_open(), syscall_resource_read(), syscall_resource_registry_create(), and syscall_resource_write().

Member Function Documentation

handle_interrupt()

cpu_status_t * SyscallManager::handle_interrupt ( cpu_status_t *  status )

finalvirtual

Loads the args from the registers and delegates the syscall to the relevant handler if defined.

Parameters

status

The cpu state

Returns

The cpu state (may be modified with return value in RAX or a new state by the handler)

Reimplemented from MaxOS::hardwarecommunication::InterruptHandler.

Definition at line 55 of file syscalls.cpp.

                                                                   {
 
    // Get the args from the cpu state
    syscall_args_t args;
    args.arg0 = status->rdi;
    args.arg1 = status->rsi;
    args.arg2 = status->rdx;
    args.arg3 = status->r10;
    args.arg4 = status->r8;
    args.arg5 = status->r9;
    args.return_value = 0;
    args.return_state = status;
 
    // Call the handler
    uint64_t syscall = status->rax;
    if (m_syscall_handlers[syscall] != nullptr)
        args = *(m_syscall_handlers[syscall](&args));
    else
        Logger::ERROR() << "Syscall " << syscall << " not found\n";
 
    // If there is a specific return state, use that
    if (args.return_state != status)
        return args.return_state;
 
    // Update the cpu state
    status->rdi = args.arg0;
    status->rsi = args.arg1;
    status->rdx = args.arg2;
    status->r10 = args.arg3;
    status->r8 = args.arg4;
    status->r9 = args.arg5;
    status->rax = args.return_value;
 
    // Return the status
    return status;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, MaxOS::system::SyscallArguments::arg2, MaxOS::system::SyscallArguments::arg3, MaxOS::system::SyscallArguments::arg4, MaxOS::system::SyscallArguments::arg5, MaxOS::Logger::ERROR(), MaxOS::system::SyscallArguments::return_state, and MaxOS::system::SyscallArguments::return_value.

remove_syscall_handler()

void SyscallManager::remove_syscall_handler

(

::MaxOS::KPI::SyscallType

syscall

)

Removes a syscall handler from the manager.

Parameters

syscall

The syscall ID number

Definition at line 108 of file syscalls.cpp.

                                                               {
 
    m_syscall_handlers[(uint8_t) syscall] = nullptr;
}

set_syscall_handler()

void SyscallManager::set_syscall_handler	(	::MaxOS::KPI::SyscallType	syscall,
		syscall_func_t	handler
	)

Loads a syscall handler into the manager.

Parameters

syscall	The syscall ID number
handler	The handler to set

Definition at line 98 of file syscalls.cpp.

                                                                                    {
 
    m_syscall_handlers[(uint8_t) syscall] = handler;
}

Referenced by SyscallManager().

syscall_allocate_memory()

syscall_args_t * SyscallManager::syscall_allocate_memory ( syscall_args_t *  args )

static

System call to allocate a block of memory.

Parameters

args	Arg0 = size

Returns

The address of the memory block or null if failed

Definition at line 142 of file syscalls.cpp.

                                                                            {
 
 
    // Malloc the memory
    size_t size = args->arg0;
    void* address = MemoryManager::malloc(size);
 
    // Return the address
    args->return_value = (uint64_t)address;
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::memory::MemoryManager::malloc(), and MaxOS::system::SyscallArguments::return_value.

Referenced by SyscallManager().

syscall_free_memory()

syscall_args_t * SyscallManager::syscall_free_memory ( syscall_args_t *  args )

static

System call to free a block of memory.

Parameters

args	Arg0 = address

Returns

Nothing

Definition at line 160 of file syscalls.cpp.

                                                                        {
 
    // Free the memory
    void* address = (void*) args->arg0;
    MemoryManager::free(address);
 
    return args;
}

References MaxOS::system::SyscallArguments::arg0, and MaxOS::memory::MemoryManager::free().

Referenced by SyscallManager().

syscall_klog()

syscall_args_t * SyscallManager::syscall_klog ( syscall_args_t *  args )

static

System call to log a message to the kernel log.

Parameters

args	Arg0 = message

Returns

The same args structure

Definition at line 120 of file syscalls.cpp.

                                                                 {
 
    // Ensure a message was provided
    char* message = (char*) args->arg0;
    if(!message)
        return args;
 
    // If the first two characters are %h then no header
    if (message[0] == '%' && message[1] == 'h')
        Logger::Out() << message + 2;
    else
        Logger::INFO() << message;
 
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::Logger::INFO(), and MaxOS::Logger::Out().

Referenced by SyscallManager().

syscall_resource_close()

syscall_args_t * SyscallManager::syscall_resource_close ( syscall_args_t *  args )

static

System call to close a resource.

Parameters

args	Arg0 = Handle Arg1 = Flags

Returns

Nothing

Definition at line 216 of file syscalls.cpp.

                                                                           {
 
    // Parse params
    auto handle = (uint64_t )args->arg0;
    auto flags  = (size_t)args->arg1;
 
    // Close the resource
    GlobalScheduler::current_process()->resource_manager.close_resource(handle, flags);
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, MaxOS::processes::resources::ResourceManager::close_resource(), MaxOS::processes::GlobalScheduler::current_process(), and MaxOS::processes::Process::resource_manager.

Referenced by SyscallManager().

syscall_resource_create()

syscall_args_t * SyscallManager::syscall_resource_create ( syscall_args_t *  args )

static

System call to create a resource.

Parameters

args	Arg0 = ResourceType Arg1 = Name Arg2 = Flags

Returns

1 if resource was created sucessfully, 0 otherwise

Definition at line 175 of file syscalls.cpp.

                                                                            {
 
    // Parse params
    auto type   = (resource_type_t)args->arg0;
    auto name   = (char*)args->arg1;
    auto flags  = (size_t)args->arg2;
    auto data   = (uintptr_t)args->arg3;
 
    // Try to create the resource
    auto resource = GlobalResourceRegistry::get_registry(type)->create_resource(name, flags, data);
 
    // Handle response
    args->return_value = resource ? 1 : 0;
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, MaxOS::system::SyscallArguments::arg2, MaxOS::system::SyscallArguments::arg3, MaxOS::processes::resources::BaseResourceRegistry::create_resource(), MaxOS::processes::resources::GlobalResourceRegistry::get_registry(), and MaxOS::system::SyscallArguments::return_value.

Referenced by SyscallManager().

syscall_resource_open()

syscall_args_t * SyscallManager::syscall_resource_open ( syscall_args_t *  args )

static

System call to open a resource.

Parameters

args	Arg0 = ResourceType Arg1 = Name Arg2 = Flags

Returns

The handle of the resource or 0 if failed

Definition at line 197 of file syscalls.cpp.

                                                                          {
 
    // Parse params
    auto type   = (resource_type_t)args->arg0;
    auto name   = (char*)args->arg1;
    auto flags  = (size_t)args->arg2;
 
    // Open the resource
    args->return_value = GlobalScheduler::current_process()->resource_manager.open_resource(type, name, flags);
 
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, MaxOS::system::SyscallArguments::arg2, MaxOS::processes::GlobalScheduler::current_process(), MaxOS::processes::resources::ResourceManager::open_resource(), MaxOS::processes::Process::resource_manager, and MaxOS::system::SyscallArguments::return_value.

Referenced by SyscallManager().

syscall_resource_read()

syscall_args_t * SyscallManager::syscall_resource_read ( syscall_args_t *  args )

static

System call to read from a resource.

Parameters

args	Arg0 = Handle Arg1 = Buffer Arg2 = Size Arg3 = Flags

Returns

The number of bytes read or 0 if failed

Definition at line 259 of file syscalls.cpp.

                                                                          {
 
    // Parse params
    auto handle = (uint64_t)args->arg0;
    auto buffer = (void*)args->arg1;
    auto size   = (size_t)args->arg2;
    auto flags  = (size_t)args->arg3;
 
    // Open the resource
    auto resource = GlobalScheduler::current_process()->resource_manager.get_resource(handle);
    if(!resource){
        args->return_value = 0;
        return args;
    }
 
    // Write to the resource
    args->return_value = resource->read(buffer,size,flags);
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, MaxOS::system::SyscallArguments::arg2, MaxOS::system::SyscallArguments::arg3, MaxOS::processes::GlobalScheduler::current_process(), MaxOS::processes::resources::ResourceManager::get_resource(), MaxOS::processes::Process::resource_manager, and MaxOS::system::SyscallArguments::return_value.

Referenced by SyscallManager().

syscall_resource_registry_create()

syscall_args_t * SyscallManager::syscall_resource_registry_create ( syscall_args_t *  args )

static

System call to create a new resource registry.

Todo:

resource type system

Parameters

args	Arg0 = Name of the shared memory region Arg1 = Resource Type

Returns

1 for success 0 for failure

Definition at line 287 of file syscalls.cpp.

                                                                                     {
 
    // Parse params
    auto name   = (char*)args->arg0;
    auto type   = (size_t)args->arg1;
 
    // Create the registry
    auto registery = new BridgeResourceRegistry(name, type);
 
    args->return_value = registery ? 1 : 0;
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, and MaxOS::system::SyscallArguments::return_value.

Referenced by SyscallManager().

syscall_resource_write()

syscall_args_t * SyscallManager::syscall_resource_write ( syscall_args_t *  args )

static

System call to write to a resource.

Parameters

args	Arg0 = Handle Arg1 = Buffer Arg2 = Size Arg3 = Flags

Returns

The number of bytes written or 0 if failed

Definition at line 233 of file syscalls.cpp.

                                                                           {
 
    // Parse params
    auto handle = (uint64_t )args->arg0;
    auto buffer = (void*)args->arg1;
    auto size   = (size_t)args->arg2;
    auto flags  = (size_t)args->arg3;
 
    // Open the resource
    auto resource = GlobalScheduler::current_process()->resource_manager.get_resource(handle);
    if(!resource){
        args->return_value = 0;
        return args;
    }
 
    // Write to the resource
    args->return_value = resource->write(buffer,size,flags);
    return args;
}

References MaxOS::system::SyscallArguments::arg0, MaxOS::system::SyscallArguments::arg1, MaxOS::system::SyscallArguments::arg2, MaxOS::system::SyscallArguments::arg3, MaxOS::processes::GlobalScheduler::current_process(), MaxOS::processes::resources::ResourceManager::get_resource(), MaxOS::processes::Process::resource_manager, and MaxOS::system::SyscallArguments::return_value.

Referenced by SyscallManager().

---

The documentation for this class was generated from the following files:

• /home/runner/work/MaxOS/MaxOS/kernel/include/system/syscalls.h
• /home/runner/work/MaxOS/MaxOS/kernel/src/system/syscalls.cpp