← Back to branch summary

~martin-decky/helenos/rcu

« back to all changes in this revision

Viewing changes to kernel/generic/include/proc/task.h

  • Committer: Martin Decky
  • Date: 2009-08-04 11:19:19 UTC
  • Revision ID: martin@uranus.dsrg.hide.ms.mff.cuni.cz-20090804111919-evyclddlr3v5lhmp
Initial import

Show diffs side-by-side

added added

removed removed

Lines of Context:
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/avl.h>
 
45
#include <adt/btree.h>
 
46
#include <adt/list.h>
 
47
#include <security/cap.h>
 
48
#include <arch/proc/task.h>
 
49
#include <arch/proc/thread.h>
 
50
#include <arch/context.h>
 
51
#include <arch/fpu_context.h>
 
52
#include <arch/cpu.h>
 
53
#include <mm/tlb.h>
 
54
#include <proc/scheduler.h>
 
55
#include <udebug/udebug.h>
 
56
#include <ipc/kbox.h>
 
57
 
 
58
#define TASK_NAME_BUFLEN        20
 
59
 
 
60
struct thread;
 
61
 
 
62
/** Task structure. */
 
63
typedef struct task {
 
64
        /** Task's linkage for the tasks_tree AVL tree. */
 
65
        avltree_node_t tasks_tree_node;
 
66
        
 
67
        /** Task lock.
 
68
         *
 
69
         * Must be acquired before threads_lock and thread lock of any of its
 
70
         * threads.
 
71
         */
 
72
        SPINLOCK_DECLARE(lock);
 
73
 
 
74
        char name[TASK_NAME_BUFLEN];
 
75
        /** List of threads contained in this task. */
 
76
        link_t th_head;
 
77
        /** Address space. */
 
78
        as_t *as;
 
79
        /** Unique identity of task. */
 
80
        task_id_t taskid;
 
81
        /** Task security context. */
 
82
        context_id_t context;   
 
83
 
 
84
        /** Number of references (i.e. threads). */
 
85
        atomic_t refcount;
 
86
        /** Number of threads that haven't exited yet. */
 
87
        atomic_t lifecount;
 
88
 
 
89
        /** Task capabilities. */
 
90
        cap_t capabilities;     
 
91
 
 
92
        /* IPC stuff */
 
93
        answerbox_t answerbox;  /**< Communication endpoint */
 
94
        phone_t phones[IPC_MAX_PHONES];
 
95
        /**
 
96
         * Active asynchronous messages. It is used for limiting uspace to
 
97
         * certain extent.
 
98
         */
 
99
        atomic_t active_calls;
 
100
 
 
101
#ifdef CONFIG_UDEBUG
 
102
        /** Debugging stuff. */
 
103
        udebug_task_t udebug;
 
104
 
 
105
        /** Kernel answerbox. */
 
106
        kbox_t kb;
 
107
#endif
 
108
 
 
109
        /** Architecture specific task data. */
 
110
        task_arch_t arch;
 
111
        
 
112
        /**
 
113
         * Serializes access to the B+tree of task's futexes. This mutex is
 
114
         * independent on the task spinlock.
 
115
         */
 
116
        mutex_t futexes_lock;
 
117
        /** B+tree of futexes referenced by this task. */
 
118
        btree_t futexes;        
 
119
        
 
120
        /** Accumulated accounting. */
 
121
        uint64_t cycles;
 
122
} task_t;
 
123
 
 
124
SPINLOCK_EXTERN(tasks_lock);
 
125
extern avltree_t tasks_tree;
 
126
 
 
127
extern void task_init(void);
 
128
extern void task_done(void);
 
129
extern task_t *task_create(as_t *as, char *name);
 
130
extern void task_destroy(task_t *t);
 
131
extern task_t *task_find_by_id(task_id_t id);
 
132
extern int task_kill(task_id_t id);
 
133
extern uint64_t task_get_accounting(task_t *t);
 
134
 
 
135
extern void cap_set(task_t *t, cap_t caps);
 
136
extern cap_t cap_get(task_t *t);
 
137
 
 
138
#ifndef task_create_arch
 
139
extern void task_create_arch(task_t *t);
 
140
#endif
 
141
 
 
142
#ifndef task_destroy_arch
 
143
extern void task_destroy_arch(task_t *t);
 
144
#endif
 
145
 
 
146
extern unative_t sys_task_get_id(task_id_t *uspace_task_id);
 
147
extern unative_t sys_task_set_name(const char *uspace_name, size_t name_len);
 
148
 
 
149
#endif
 
150
 
 
151
/** @}
 
152
 */