kernel/generic/include/proc/task.h

   1 /*
   2  * Copyright (c) 2001-2004 Jakub Jermar
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * - Redistributions of source code must retain the above copyright
  10  *   notice, this list of conditions and the following disclaimer.
  11  * - Redistributions in binary form must reproduce the above copyright
  12  *   notice, this list of conditions and the following disclaimer in the
  13  *   documentation and/or other materials provided with the distribution.
  14  * - The name of the author may not be used to endorse or promote products
  15  *   derived from this software without specific prior written permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  */
  28
  29 /** @addtogroup genericproc
  30  * @{
  31  */
  32 /** @file
  33  */
  34
  35 #ifndef KERN_TASK_H_
  36 #define KERN_TASK_H_
  37
  38 #include <cpu.h>
  39 #include <ipc/ipc.h>
  40 #include <synch/spinlock.h>
  41 #include <synch/mutex.h>
  42 #include <synch/rwlock.h>
  43 #include <synch/futex.h>
  44 #include <adt/btree.h>
  45 #include <adt/list.h>
  46 #include <security/cap.h>
  47 #include <arch/proc/task.h>
  48 #include <arch/proc/thread.h>
  49 #include <arch/context.h>
  50 #include <arch/fpu_context.h>
  51 #include <arch/cpu.h>
  52 #include <mm/tlb.h>
  53 #include <proc/scheduler.h>
  54
  55 struct thread;
  56
  57 /** Task structure. */
  58 typedef struct task {
  59         /** Task lock.
  60          *
  61          * Must be acquired before threads_lock and thread lock of any of its
  62          * threads.
  63          */
  64         SPINLOCK_DECLARE(lock);
  65
  66         char *name;
  67         /** Pointer to the main thread. */
  68         struct thread *main_thread;
  69         /** List of threads contained in this task. */
  70         link_t th_head;
  71         /** Address space. */
  72         as_t *as;
  73         /** Unique identity of task. */
  74         task_id_t taskid;
  75         /** Task security context. */
  76         context_id_t context;
  77
  78         /** If this is true, new threads can become part of the task. */
  79         bool accept_new_threads;
  80         /** Number of references (i.e. threads). */
  81         count_t refcount;
  82
  83         /** Task capabilities. */
  84         cap_t capabilities;
  85
  86         /* IPC stuff */
  87         answerbox_t answerbox;  /**< Communication endpoint */
  88         phone_t phones[IPC_MAX_PHONES];
  89         /**
  90          * Active asynchronous messages. It is used for limiting uspace to
  91          * certain extent.
  92          */
  93         atomic_t active_calls;
  94
  95         /** Architecture specific task data. */
  96         task_arch_t arch;
  97
  98         /**
  99          * Serializes access to the B+tree of task's futexes. This mutex is
 100          * independent on the task spinlock.
 101          */
 102         mutex_t futexes_lock;
 103         /** B+tree of futexes referenced by this task. */
 104         btree_t futexes;
 105
 106         /** Accumulated accounting. */
 107         uint64_t cycles;
 108 } task_t;
 109
 110 SPINLOCK_EXTERN(tasks_lock);
 111 extern btree_t tasks_btree;
 112
 113 extern void task_init(void);
 114 extern task_t *task_create(as_t *as, char *name);
 115 extern void task_destroy(task_t *t);
 116 extern task_t *task_run_program(void *program_addr, char *name);
 117 extern task_t *task_find_by_id(task_id_t id);
 118 extern int task_kill(task_id_t id);
 119 extern uint64_t task_get_accounting(task_t *t);
 120
 121 extern void cap_set(task_t *t, cap_t caps);
 122 extern cap_t cap_get(task_t *t);
 123
 124
 125 #ifndef task_create_arch
 126 extern void task_create_arch(task_t *t);
 127 #endif
 128
 129 #ifndef task_destroy_arch
 130 extern void task_destroy_arch(task_t *t);
 131 #endif
 132
 133 extern unative_t sys_task_get_id(task_id_t *uspace_task_id);
 134
 135 #endif
 136
 137 /** @}
 138  */