l4/pkg/l4re-core/l4re/util/include/cap

   1 // -*- Mode: C++ -*-
   2 // vim:ft=cpp
   3 /**
   4  * \file   cap
   5  * \brief  Capability utility functions
   6  */
   7 /*
   8  * (c) 2009 Adam Lackorzynski <adam@os.inf.tu-dresden.de>
   9  *     economic rights: Technische Universität Dresden (Germany)
  10  *
  11  * This file is part of TUD:OS and distributed under the terms of the
  12  * GNU General Public License 2.
  13  * Please see the COPYING-GPL-2 file for details.
  14  *
  15  * As a special exception, you may use this file as part of a free software
  16  * library without restriction.  Specifically, if other files instantiate
  17  * templates or use macros or inline functions from this file, or you compile
  18  * this file and link it with other files to produce an executable, this
  19  * file does not by itself cause the resulting executable to be covered by
  20  * the GNU General Public License.  This exception does not however
  21  * invalidate any other reasons why the executable file might be covered by
  22  * the GNU General Public License.
  23  */
  24
  25 #pragma once
  26
  27 #include <l4/sys/task>
  28
  29 namespace L4Re { namespace Util {
  30
  31 /**
  32  * \brief Release a capability from a task (unmap).
  33  * \ingroup api_l4re_util
  34  *
  35  * Note that the given capability does not need to be handled by the
  36  * capability allocator in any way.
  37  */
  38 L4_CV static inline l4_msgtag_t cap_release(L4::Cap<void> cap)
  39 {
  40   return l4_task_unmap(L4_BASE_TASK_CAP,
  41                        l4_obj_fpage(cap.cap(), 0, L4_FPAGE_RWX),
  42                        L4_FP_ALL_SPACES);
  43 }
  44
  45 }}