seL4/libsel4/arch_include/x86/sel4/arch/functions.h
Adrian Danis 8108c811ed libsel4: Remove bitfield type unifying Guard and Badge construction
Using the bitfield generator to treat guards and badges as a union type can be convenient,
but it requires reserving a bit in the data for the bitfield run time type information.
This type information is not needed by the kernel as it knows implicitly whether the passed
data is a badge or a guard based on the kind of cap being operated on. However, with the
type information present we cannot pass a word sized piece of data to the kernel.

The solution here is to go back to using a plain seL4_Word as the type for invocations
that want a capdata and let the user either construct a badge as a plain word, or use
the seL4_CNode_CapData bitfield for constructing a guard, although they have to manually extract
the word representation out of it.
2017-10-27 12:15:09 +11:00

105 lines
2.4 KiB
C

/*
* Copyright 2017, Data61
* Commonwealth Scientific and Industrial Research Organisation (CSIRO)
* ABN 41 687 119 230.
*
* This software may be distributed and modified according to the terms of
* the BSD 2-Clause license. Note that NO WARRANTY is provided.
* See "LICENSE_BSD2.txt" for details.
*
* @TAG(DATA61_BSD)
*/
#ifndef __LIBSEL4_ARCH_FUNCTIONS_H
#define __LIBSEL4_ARCH_FUNCTIONS_H
#include <sel4/types.h>
#include <sel4/sel4_arch/functions.h>
LIBSEL4_INLINE_FUNC seL4_Word
seL4_GetMR(int i)
{
seL4_Word mr;
SEL4_GET_IPCBUF_SCALE(msg, i, mr);
return mr;
}
LIBSEL4_INLINE_FUNC void
seL4_SetMR(int i, seL4_Word mr)
{
SEL4_SET_IPCBUF_SCALE(msg, i, mr);
}
LIBSEL4_INLINE_FUNC seL4_Word
seL4_GetUserData(void)
{
seL4_Word data;
SEL4_GET_IPCBUF(userData, data);
return data;
}
LIBSEL4_INLINE_FUNC void
seL4_SetUserData(seL4_Word data)
{
SEL4_SET_IPCBUF(userData, data);
}
LIBSEL4_INLINE_FUNC seL4_Word
seL4_GetBadge(int i)
{
seL4_Word badge;
SEL4_GET_IPCBUF_SCALE(caps_or_badges, i, badge);
return badge;
}
LIBSEL4_INLINE_FUNC seL4_CPtr
seL4_GetCap(int i)
{
seL4_CPtr cap;
SEL4_GET_IPCBUF_SCALE(caps_or_badges, i, cap);
return cap;
}
LIBSEL4_INLINE_FUNC void
seL4_SetCap(int i, seL4_CPtr cptr)
{
SEL4_SET_IPCBUF_SCALE(caps_or_badges, i, cptr);
}
LIBSEL4_INLINE_FUNC void
seL4_GetCapReceivePath(seL4_CPtr* receiveCNode, seL4_CPtr* receiveIndex, seL4_Word* receiveDepth)
{
if (receiveCNode != seL4_Null) {
SEL4_GET_IPCBUF(receiveCNode, *receiveCNode);
}
if (receiveIndex != seL4_Null) {
SEL4_GET_IPCBUF(receiveIndex, *receiveIndex);
}
if (receiveDepth != seL4_Null) {
SEL4_GET_IPCBUF(receiveDepth, *receiveDepth);
}
}
LIBSEL4_INLINE_FUNC void
seL4_SetCapReceivePath(seL4_CPtr receiveCNode, seL4_CPtr receiveIndex, seL4_Word receiveDepth)
{
SEL4_SET_IPCBUF(receiveCNode, receiveCNode);
SEL4_SET_IPCBUF(receiveIndex, receiveIndex);
SEL4_SET_IPCBUF(receiveDepth, receiveDepth);
}
LIBSEL4_INLINE_FUNC seL4_IPCBuffer*
seL4_GetIPCBuffer(void)
{
/* Assume that the address of our IPC buffer is in the user data word. Our
* parent (or seL4_InitBootInfo in the case of the root task) should have
* ensured this is true. The user is free to overwrite this data with
* something else, but should then be aware they lose the functionality of
* this function.
*/
return (seL4_IPCBuffer*)seL4_GetUserData();
}
#endif