genode/base-nova/include/base/cap_sel_alloc.h

73 lines
1.9 KiB
C
Raw Normal View History

2011-12-22 15:19:25 +00:00
/*
* \brief Interface for process-local capability-selector allocation
* \author Norman Feske
* \date 2010-01-19
*
* This interface is NOVA-specific and not part of the Genode API. It should
* only be used internally by the framework or by NOVA-specific code. The
* implementation of the interface is part of the environment library.
*/
/*
* Copyright (C) 2010-2011 Genode Labs GmbH
*
* This file is part of the Genode OS framework, which is distributed
* under the terms of the GNU General Public License version 2.
*/
#ifndef _INCLUDE__BASE__CAP_SEL_ALLOC_H_
#define _INCLUDE__BASE__CAP_SEL_ALLOC_H_
#include <base/stdint.h>
namespace Genode {
class Cap_selector_allocator
{
public:
/**
* Constructor
*/
Cap_selector_allocator();
/**
* Allocate range of capability selectors
*
* \param num_caps_log2 number of capability selectors specified as
* as the power of two. By default, the function
* returns a single capability selector.
* \return first capability selector of allocated range,
* or 0 if allocation failed
*
* The allocated range will be naturally aligned according to the
* specified 'num_cap_log2' value.
*/
addr_t alloc(size_t num_caps_log2 = 0);
/**
* Release range of capability selectors
*
* \param cap first capability selector of range
* \param num_caps_log2 number of capability selectors specified
* as the power of two
*/
void free(addr_t cap, size_t num_caps_log2);
/**
* Capability selector of local protection domain
*
* \return PD selector
*/
static unsigned pd_sel();
};
/**
* Return singleton instance of 'Cap_selector_allocator'
*/
Cap_selector_allocator *cap_selector_allocator();
}
#endif /* _INCLUDE__BASE__CAP_SEL_ALLOC_H_ */