1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/* task.h - Generic definitions.
Copyright (C) 2004 Free Software Foundation, Inc.
Written by Marcus Brinkmann.
This file is part of the GNU Hurd.
The GNU Hurd is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2, or (at
your option) any later version.
The GNU Hurd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. */
#ifndef TASK_H
#define TASK_H 1
#include <errno.h>
#include <l4.h>
#include <hurd/cap-server.h>
#include <hurd/ihash.h>
#include "output.h"
/* The program name. */
extern char program_name[];
#define BUG_ADDRESS "<bug-hurd@gnu.org>"
int main (int argc, char *argv[]);
/* The following function must be defined by the architecture
dependent code. */
/* Switch execution transparently to thread TO. The thread FROM,
which must be the current thread, will be halted. */
void switch_thread (l4_thread_id_t from, l4_thread_id_t to);
/* Thread objects. These are not capabilities, but components of task
objects. */
struct thread
{
/* The next pointer in a linked list of threads. */
struct thread *next;
/* The thread ID of the thread. The version part is the task_id the
thread is assigned to, or undefined if the thread is unassigned.
The thread number is determined at construction and fixed. */
l4_thread_id_t thread_id;
/* FIXME: More members like priority, CPU usage etc. */
};
typedef struct thread *thread_t;
/* Set the range of thread IDs that we are allowed to allocate. */
void thread_set_range (l4_thread_id_t first, l4_thread_id_t last);
/* Allocate a new thread object with the thread ID THREAD_ID and
return it in THREAD. Only used at bootstrap. */
error_t thread_alloc_with_id (l4_thread_id_t thread_id, thread_t *thread);
/* Allocate a new thread object and return it in THREAD. */
error_t thread_alloc (thread_t *thread);
/* Deallocate the thread THREAD. */
void thread_dealloc (thread_t thread);
/* Task objects. */
struct task
{
/* This is for fast removal from the task_id_to_task hash table. */
hurd_ihash_locp_t locp;
/* The task ID is used in the version field of the global thread ID,
so it is limited to L4_THREAD_VERSION_BITS (14/32) bits and must
not have its lower 6 bits set to all zero (because that indicates
a local thread ID). */
hurd_task_id_t task_id;
/* The threads in this task. */
unsigned int nr_threads;
thread_t threads;
};
typedef struct task *task_t;
/* Initialize the task class subsystem. */
error_t task_class_init ();
/* Allocate a new task object with the task ID TASK_ID and the
NR_THREADS threads listed in THREADS (which are already allocated
for that task. The object returned is locked and has one
reference. */
error_t task_alloc (l4_word_t task_id, unsigned int nr_threads,
l4_thread_id_t *threads, task_t *r_task);
extern pthread_mutex_t task_id_to_task_lock;
/* The hash table mapping task IDs to tasks. */
extern struct hurd_ihash task_id_to_task;
/* Acquire a reference for the task with the task ID TASK_ID and
return the task object. If the task ID is not valid, return
NULL. */
static inline task_t
task_id_get_task (hurd_task_id_t task_id)
{
task_t task;
pthread_mutex_lock (&task_id_to_task_lock);
task = hurd_ihash_find (&task_id_to_task, task_id);
if (task)
{
hurd_cap_obj_t obj = hurd_cap_obj_from_user (task_t, task);
hurd_cap_obj_ref (obj);
}
pthread_mutex_unlock (&task_id_to_task_lock);
return task;
}
/* Enter the task TASK under its ID into the hash table, consuming one
reference. Mainly used by the bootstrap functions. */
error_t task_id_enter (task_t task);
/* Find a free task ID, enter the task TASK (which must not be locked)
into the hash table under this ID, acquiring reference. The new
task ID is returned in TASK_ID. If no free task ID is available,
EAGAIN is returned. */
error_t task_id_add (task_t task, hurd_task_id_t *task_id_p);
#endif /* TASK_H */
|
