genode/repos/base/include/base/attached_io_mem_dataspace.h
Norman Feske 5ed5fddb7c base/os: remove deprecated APIs
This commit removes APIs that were previously marked as deprecated. This
change has the following implications:

- The use of the global 'env()' accessor is not possible anymore.
- Boolean accessor methods are no longer prefixed with 'is_'. E.g.,
  instead of 'is_valid()', use 'valid()'.
- The last traces of 'Ram_session' are gone now. The 'Env::ram()'
  accessor returns the 'Ram_allocator' interface, which is a subset of
  the 'Pd_session' interface.
- All connection constructors need the 'Env' as argument.
- The 'Reporter' constructor needs an 'Env' argument now because the
  reporter creates a report connection.
- The old overload 'Child_policy::resolve_session_request' that returned
  a 'Service' does not exist anymore.
- The base/printf.h header has been removed, use base/log.h instead.
- The old notion of 'Signal_dispatcher' is gone. Use 'Signal_handler'.
- Transitional headers like os/server.h, cap_session/,
  volatile_object.h, os/attached*_dataspace.h, signal_rpc_dispatcher.h
  have been removed.
- The distinction between 'Thread_state' and 'Thread_state_base' does
  not exist anymore.
- The header cpu_thread/capability.h along with the type definition of
  'Cpu_thread_capability' has been removed. Use the type
  'Thread_capability' define in cpu_session/cpu_session.h instead.
- Several XML utilities (i.e., at os/include/decorator) could be removed
  because their functionality is nowadays covered by util/xml_node.h.
- The 'os/ram_session_guard.h' has been removed.
  Use 'Constrained_ram_allocator' provided by base/ram_allocator.h instead.

Issue #1987
2019-02-26 14:44:15 +01:00

91 lines
2.4 KiB
C++

/*
* \brief I/O MEM dataspace utility
* \author Norman Feske
* \date 2011-05-19
*/
/*
* Copyright (C) 2011-2017 Genode Labs GmbH
*
* This file is part of the Genode OS framework, which is distributed
* under the terms of the GNU Affero General Public License version 3.
*/
#ifndef _INCLUDE__BASE__ATTACHED_IO_MEM_DATASPACE_H_
#define _INCLUDE__BASE__ATTACHED_IO_MEM_DATASPACE_H_
#include <io_mem_session/connection.h>
#include <base/env.h>
namespace Genode { class Attached_io_mem_dataspace; }
/**
* Request and locally attach a memory-mapped I/O resource
*
* This class is a wrapper for a typical sequence of operations performed
* by device drivers to access memory-mapped device resources. Its sole
* purpose is to avoid duplicated code.
*/
class Genode::Attached_io_mem_dataspace
{
private:
Region_map &_env_rm;
Io_mem_connection _mmio;
Io_mem_dataspace_capability _ds;
Region_map::Local_addr _local_addr;
static void *_with_sub_page_offset(void *local, addr_t io_base)
{
return (void *)((addr_t)local | (io_base & (addr_t)0xfff));
}
public:
/**
* Constructor
*
* \param base base address of memory-mapped I/O resource
* \param size size of resource
* \param write_combined enable write combining for the resource
*
* \throw Service_denied
* \throw Insufficient_ram_quota
* \throw Insufficient_cap_quota
* \throw Out_of_ram
* \throw Out_of_caps
* \throw Region_map::Region_conflict
* \throw Region_map::Invalid_dataspace
*/
Attached_io_mem_dataspace(Env &env, Genode::addr_t base, Genode::size_t size,
bool write_combined = false)
:
_env_rm(env.rm()),
_mmio(env, base, size, write_combined),
_ds(_mmio.dataspace()),
_local_addr(_with_sub_page_offset(env.rm().attach(_ds), base))
{ }
/**
* Destructor
*/
~Attached_io_mem_dataspace() { _env_rm.detach(_local_addr); }
/**
* Return capability of the used RAM dataspace
*/
Io_mem_dataspace_capability cap() { return _ds; }
/**
* Request local address
*
* This is a template to avoid inconvenient casts at the caller.
* A newly allocated I/O MEM dataspace is untyped memory anyway.
*/
template <typename T>
T *local_addr() { return static_cast<T *>(_local_addr); }
};
#endif /* _INCLUDE__BASE__ATTACHED_IO_MEM_DATASPACE_H_ */