Subversion Repositories HelenOS-historic

Rev

Rev 552 | Rev 615 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 552 Rev 557
1
/*
1
/*
2
 * Copyright (C) 2001-2004 Jakub Jermar
2
 * Copyright (C) 2001-2004 Jakub Jermar
3
 * All rights reserved.
3
 * All rights reserved.
4
 *
4
 *
5
 * Redistribution and use in source and binary forms, with or without
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
6
 * modification, are permitted provided that the following conditions
7
 * are met:
7
 * are met:
8
 *
8
 *
9
 * - Redistributions of source code must retain the above copyright
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
12
 *   notice, this list of conditions and the following disclaimer in the
13
 *   documentation and/or other materials provided with the distribution.
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
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.
15
 *   derived from this software without specific prior written permission.
16
 *
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
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
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
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
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
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
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.
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27
 */
27
 */
28
 
28
 
29
#include <synch/waitq.h>
29
#include <synch/waitq.h>
30
#include <synch/synch.h>
30
#include <synch/synch.h>
31
#include <synch/spinlock.h>
31
#include <synch/spinlock.h>
32
#include <proc/thread.h>
32
#include <proc/thread.h>
33
#include <proc/scheduler.h>
33
#include <proc/scheduler.h>
34
#include <arch/asm.h>
34
#include <arch/asm.h>
35
#include <arch/types.h>
35
#include <arch/types.h>
-
 
36
#include <typedefs.h>
36
#include <time/timeout.h>
37
#include <time/timeout.h>
37
#include <arch.h>
38
#include <arch.h>
38
#include <context.h>
39
#include <context.h>
39
#include <list.h>
40
#include <list.h>
40
 
41
 
41
/** Initialize wait queue
42
/** Initialize wait queue
42
 *
43
 *
43
 * Initialize wait queue.
44
 * Initialize wait queue.
44
 *
45
 *
45
 * @param wq Pointer to wait queue to be initialized.
46
 * @param wq Pointer to wait queue to be initialized.
46
 */
47
 */
47
void waitq_initialize(waitq_t *wq)
48
void waitq_initialize(waitq_t *wq)
48
{
49
{
49
    spinlock_initialize(&wq->lock, "waitq_lock");
50
    spinlock_initialize(&wq->lock, "waitq_lock");
50
    list_initialize(&wq->head);
51
    list_initialize(&wq->head);
51
    wq->missed_wakeups = 0;
52
    wq->missed_wakeups = 0;
52
}
53
}
53
 
54
 
54
/** Handle timeout during waitq_sleep_timeout() call
55
/** Handle timeout during waitq_sleep_timeout() call
55
 *
56
 *
56
 * This routine is called when waitq_sleep_timeout() timeouts.
57
 * This routine is called when waitq_sleep_timeout() timeouts.
57
 * Interrupts are disabled.
58
 * Interrupts are disabled.
58
 *
59
 *
59
 * It is supposed to try to remove 'its' thread from the wait queue;
60
 * It is supposed to try to remove 'its' thread from the wait queue;
60
 * it can eventually fail to achieve this goal when these two events
61
 * it can eventually fail to achieve this goal when these two events
61
 * overlap. In that case it behaves just as though there was no
62
 * overlap. In that case it behaves just as though there was no
62
 * timeout at all.
63
 * timeout at all.
63
 *
64
 *
64
 * @param data Pointer to the thread that called waitq_sleep_timeout().
65
 * @param data Pointer to the thread that called waitq_sleep_timeout().
65
 */
66
 */
66
void waitq_interrupted_sleep(void *data)
67
void waitq_interrupted_sleep(void *data)
67
{
68
{
68
    thread_t *t = (thread_t *) data;
69
    thread_t *t = (thread_t *) data;
69
    waitq_t *wq;
70
    waitq_t *wq;
70
    int do_wakeup = 0;
71
    bool do_wakeup = false;
71
 
72
 
72
    spinlock_lock(&threads_lock);
73
    spinlock_lock(&threads_lock);
73
    if (!list_member(&t->threads_link, &threads_head))
74
    if (!list_member(&t->threads_link, &threads_head))
74
        goto out;
75
        goto out;
75
 
76
 
76
grab_locks:
77
grab_locks:
77
    spinlock_lock(&t->lock);
78
    spinlock_lock(&t->lock);
78
    if (wq = t->sleep_queue) {
79
    if (wq = t->sleep_queue) {      /* assignment */
79
        if (!spinlock_trylock(&wq->lock)) {
80
        if (!spinlock_trylock(&wq->lock)) {
80
            spinlock_unlock(&t->lock);
81
            spinlock_unlock(&t->lock);
81
            goto grab_locks; /* avoid deadlock */
82
            goto grab_locks;    /* avoid deadlock */
82
        }
83
        }
83
 
84
 
84
        list_remove(&t->wq_link);
85
        list_remove(&t->wq_link);
85
        t->saved_context = t->sleep_timeout_context;
86
        t->saved_context = t->sleep_timeout_context;
86
        do_wakeup = 1;
87
        do_wakeup = true;
87
       
88
       
88
        spinlock_unlock(&wq->lock);
89
        spinlock_unlock(&wq->lock);
89
        t->sleep_queue = NULL;
90
        t->sleep_queue = NULL;
90
    }
91
    }
91
   
92
   
92
    t->timeout_pending = 0;
93
    t->timeout_pending = false;
93
    spinlock_unlock(&t->lock);
94
    spinlock_unlock(&t->lock);
94
   
95
   
-
 
96
    if (do_wakeup)
95
    if (do_wakeup) thread_ready(t);
97
        thread_ready(t);
96
 
98
 
97
out:
99
out:
98
    spinlock_unlock(&threads_lock);
100
    spinlock_unlock(&threads_lock);
99
}
101
}
100
 
102
 
101
/** Sleep until either wakeup or timeout occurs
103
/** Sleep until either wakeup or timeout occurs
102
 *
104
 *
103
 * This is a sleep implementation which allows itself to be
105
 * This is a sleep implementation which allows itself to be
104
 * interrupted from the sleep, restoring a failover context.
106
 * interrupted from the sleep, restoring a failover context.
105
 *
107
 *
106
 * Sleepers are organised in FIFO fashion in a structure called wait queue.
108
 * Sleepers are organised in FIFO fashion in a structure called wait queue.
107
 *
109
 *
108
 * This function is really basic in that other functions as waitq_sleep()
110
 * This function is really basic in that other functions as waitq_sleep()
109
 * and all the *_timeout() functions use it.
111
 * and all the *_timeout() functions use it.
110
 *
112
 *
111
 * @param wq Pointer to wait queue.
113
 * @param wq Pointer to wait queue.
112
 * @param usec Timeout in microseconds.
114
 * @param usec Timeout in microseconds.
113
 * @param nonblocking Blocking vs. non-blocking operation mode switch.
115
 * @param nonblocking Blocking vs. non-blocking operation mode switch.
114
 *
116
 *
115
 * If usec is greater than zero, regardless of the value of nonblocking,
117
 * If usec is greater than zero, regardless of the value of nonblocking,
116
 * the call will not return until either timeout or wakeup comes.
118
 * the call will not return until either timeout or wakeup comes.
117
 *
119
 *
118
 * If usec is zero and nonblocking is zero (false), the call
120
 * If usec is zero and nonblocking is zero (false), the call
119
 * will not return until wakeup comes.
121
 * will not return until wakeup comes.
120
 *
122
 *
121
 * If usec is zero and nonblocking is non-zero (true), the call will
123
 * If usec is zero and nonblocking is non-zero (true), the call will
122
 * immediately return, reporting either success or failure.
124
 * immediately return, reporting either success or failure.
123
 *
125
 *
124
 * @return Returns one of: ESYNCH_WOULD_BLOCK, ESYNCH_TIMEOUT,
126
 * @return Returns one of: ESYNCH_WOULD_BLOCK, ESYNCH_TIMEOUT,
125
 *         ESYNCH_OK_ATOMIC, ESYNCH_OK_BLOCKED.
127
 *         ESYNCH_OK_ATOMIC, ESYNCH_OK_BLOCKED.
126
 *
128
 *
127
 * ESYNCH_WOULD_BLOCK means that the sleep failed because at the time
129
 * ESYNCH_WOULD_BLOCK means that the sleep failed because at the time
128
 * of the call there was no pending wakeup.
130
 * of the call there was no pending wakeup.
129
 *
131
 *
130
 * ESYNCH_TIMEOUT means that the sleep timed out.
132
 * ESYNCH_TIMEOUT means that the sleep timed out.
131
 *
133
 *
132
 * ESYNCH_OK_ATOMIC means that the sleep succeeded and that there was
134
 * ESYNCH_OK_ATOMIC means that the sleep succeeded and that there was
133
 * a pending wakeup at the time of the call. The caller was not put
135
 * a pending wakeup at the time of the call. The caller was not put
134
 * asleep at all.
136
 * asleep at all.
135
 *
137
 *
136
 * ESYNCH_OK_BLOCKED means that the sleep succeeded; the full sleep was
138
 * ESYNCH_OK_BLOCKED means that the sleep succeeded; the full sleep was
137
 * attempted.
139
 * attempted.
138
 */
140
 */
139
int waitq_sleep_timeout(waitq_t *wq, __u32 usec, int nonblocking)
141
int waitq_sleep_timeout(waitq_t *wq, __u32 usec, int nonblocking)
140
{
142
{
141
    volatile ipl_t ipl; /* must be live after context_restore() */
143
    volatile ipl_t ipl; /* must be live after context_restore() */
142
   
144
   
143
   
145
   
144
restart:
146
restart:
145
    ipl = interrupts_disable();
147
    ipl = interrupts_disable();
146
   
148
   
147
    /*
149
    /*
148
     * Busy waiting for a delayed timeout.
150
     * Busy waiting for a delayed timeout.
149
     * This is an important fix for the race condition between
151
     * This is an important fix for the race condition between
150
     * a delayed timeout and a next call to waitq_sleep_timeout().
152
     * a delayed timeout and a next call to waitq_sleep_timeout().
151
     * Simply, the thread is not allowed to go to sleep if
153
     * Simply, the thread is not allowed to go to sleep if
152
     * there are timeouts in progress.
154
     * there are timeouts in progress.
153
     */
155
     */
154
    spinlock_lock(&THREAD->lock);
156
    spinlock_lock(&THREAD->lock);
155
    if (THREAD->timeout_pending) {
157
    if (THREAD->timeout_pending) {
156
        spinlock_unlock(&THREAD->lock);
158
        spinlock_unlock(&THREAD->lock);
157
        interrupts_restore(ipl);       
159
        interrupts_restore(ipl);       
158
        goto restart;
160
        goto restart;
159
    }
161
    }
160
    spinlock_unlock(&THREAD->lock);
162
    spinlock_unlock(&THREAD->lock);
161
   
163
   
162
    spinlock_lock(&wq->lock);
164
    spinlock_lock(&wq->lock);
163
   
165
   
164
    /* checks whether to go to sleep at all */
166
    /* checks whether to go to sleep at all */
165
    if (wq->missed_wakeups) {
167
    if (wq->missed_wakeups) {
166
        wq->missed_wakeups--;
168
        wq->missed_wakeups--;
167
        spinlock_unlock(&wq->lock);
169
        spinlock_unlock(&wq->lock);
168
        interrupts_restore(ipl);
170
        interrupts_restore(ipl);
169
        return ESYNCH_OK_ATOMIC;
171
        return ESYNCH_OK_ATOMIC;
170
    }
172
    }
171
    else {
173
    else {
172
        if (nonblocking && (usec == 0)) {
174
        if (nonblocking && (usec == 0)) {
173
            /* return immediatelly instead of going to sleep */
175
            /* return immediatelly instead of going to sleep */
174
            spinlock_unlock(&wq->lock);
176
            spinlock_unlock(&wq->lock);
175
            interrupts_restore(ipl);
177
            interrupts_restore(ipl);
176
            return ESYNCH_WOULD_BLOCK;
178
            return ESYNCH_WOULD_BLOCK;
177
        }
179
        }
178
    }
180
    }
179
 
181
 
180
   
182
   
181
    /*
183
    /*
182
     * Now we are firmly decided to go to sleep.
184
     * Now we are firmly decided to go to sleep.
183
     */
185
     */
184
    spinlock_lock(&THREAD->lock);
186
    spinlock_lock(&THREAD->lock);
185
    if (usec) {
187
    if (usec) {
186
        /* We use the timeout variant. */
188
        /* We use the timeout variant. */
187
        if (!context_save(&THREAD->sleep_timeout_context)) {
189
        if (!context_save(&THREAD->sleep_timeout_context)) {
188
            /*
190
            /*
189
             * Short emulation of scheduler() return code.
191
             * Short emulation of scheduler() return code.
190
             */
192
             */
191
            before_thread_runs();
193
            before_thread_runs();
192
            spinlock_unlock(&THREAD->lock);
194
            spinlock_unlock(&THREAD->lock);
193
            interrupts_restore(ipl);
195
            interrupts_restore(ipl);
194
            return ESYNCH_TIMEOUT;
196
            return ESYNCH_TIMEOUT;
195
        }
197
        }
196
        THREAD->timeout_pending = 1;
198
        THREAD->timeout_pending = true;
197
        timeout_register(&THREAD->sleep_timeout, (__u64) usec, waitq_interrupted_sleep, THREAD);
199
        timeout_register(&THREAD->sleep_timeout, (__u64) usec, waitq_interrupted_sleep, THREAD);
198
    }
200
    }
199
 
201
 
200
    list_append(&THREAD->wq_link, &wq->head);
202
    list_append(&THREAD->wq_link, &wq->head);
201
 
203
 
202
    /*
204
    /*
203
     * Suspend execution.
205
     * Suspend execution.
204
     */
206
     */
205
    THREAD->state = Sleeping;
207
    THREAD->state = Sleeping;
206
    THREAD->sleep_queue = wq;
208
    THREAD->sleep_queue = wq;
207
 
209
 
208
    spinlock_unlock(&THREAD->lock);
210
    spinlock_unlock(&THREAD->lock);
209
 
211
 
210
    scheduler();    /* wq->lock is released in scheduler_separated_stack() */
212
    scheduler();    /* wq->lock is released in scheduler_separated_stack() */
211
    interrupts_restore(ipl);
213
    interrupts_restore(ipl);
212
   
214
   
213
    return ESYNCH_OK_BLOCKED;
215
    return ESYNCH_OK_BLOCKED;
214
}
216
}
215
 
217
 
216
 
218
 
217
/** Wake up first thread sleeping in a wait queue
219
/** Wake up first thread sleeping in a wait queue
218
 *
220
 *
219
 * Wake up first thread sleeping in a wait queue.
221
 * Wake up first thread sleeping in a wait queue.
220
 * This is the SMP- and IRQ-safe wrapper meant for
222
 * This is the SMP- and IRQ-safe wrapper meant for
221
 * general use.
223
 * general use.
222
 *
224
 *
223
 * Besides its 'normal' wakeup operation, it attempts
225
 * Besides its 'normal' wakeup operation, it attempts
224
 * to unregister possible timeout.
226
 * to unregister possible timeout.
225
 *
227
 *
226
 * @param wq Pointer to wait queue.
228
 * @param wq Pointer to wait queue.
227
 * @param all If this is non-zero, all sleeping threads
229
 * @param all If this is non-zero, all sleeping threads
228
 *        will be woken up and missed count will be zeroed.
230
 *        will be woken up and missed count will be zeroed.
229
 */
231
 */
230
void waitq_wakeup(waitq_t *wq, int all)
232
void waitq_wakeup(waitq_t *wq, bool all)
231
{
233
{
232
    ipl_t ipl;
234
    ipl_t ipl;
233
 
235
 
234
    ipl = interrupts_disable();
236
    ipl = interrupts_disable();
235
    spinlock_lock(&wq->lock);
237
    spinlock_lock(&wq->lock);
236
 
238
 
237
    _waitq_wakeup_unsafe(wq, all);
239
    _waitq_wakeup_unsafe(wq, all);
238
 
240
 
239
    spinlock_unlock(&wq->lock);
241
    spinlock_unlock(&wq->lock);
240
    interrupts_restore(ipl);   
242
    interrupts_restore(ipl);   
241
}
243
}
242
 
244
 
243
/** Internal SMP- and IRQ-unsafe version of waitq_wakeup()
245
/** Internal SMP- and IRQ-unsafe version of waitq_wakeup()
244
 *
246
 *
245
 * This is the internal SMP- and IRQ-unsafe version
247
 * This is the internal SMP- and IRQ-unsafe version
246
 * of waitq_wakeup(). It assumes wq->lock is already
248
 * of waitq_wakeup(). It assumes wq->lock is already
247
 * locked and interrupts are already disabled.
249
 * locked and interrupts are already disabled.
248
 *
250
 *
249
 * @param wq Pointer to wait queue.
251
 * @param wq Pointer to wait queue.
250
 * @param all If this is non-zero, all sleeping threads
252
 * @param all If this is non-zero, all sleeping threads
251
 *        will be woken up and missed count will be zeroed.
253
 *        will be woken up and missed count will be zeroed.
252
 */
254
 */
253
void _waitq_wakeup_unsafe(waitq_t *wq, int all)
255
void _waitq_wakeup_unsafe(waitq_t *wq, bool all)
254
{
256
{
255
    thread_t *t;
257
    thread_t *t;
256
 
258
 
257
loop:  
259
loop:  
258
    if (list_empty(&wq->head)) {
260
    if (list_empty(&wq->head)) {
259
        wq->missed_wakeups++;
261
        wq->missed_wakeups++;
-
 
262
        if (all)
260
        if (all) wq->missed_wakeups = 0;
263
            wq->missed_wakeups = 0;
261
        return;
264
        return;
262
    }
265
    }
263
 
266
 
264
    t = list_get_instance(wq->head.next, thread_t, wq_link);
267
    t = list_get_instance(wq->head.next, thread_t, wq_link);
265
   
268
   
266
    list_remove(&t->wq_link);
269
    list_remove(&t->wq_link);
267
    spinlock_lock(&t->lock);
270
    spinlock_lock(&t->lock);
268
    if (t->timeout_pending && timeout_unregister(&t->sleep_timeout))
271
    if (t->timeout_pending && timeout_unregister(&t->sleep_timeout))
269
        t->timeout_pending = 0;
272
        t->timeout_pending = false;
270
    t->sleep_queue = NULL;
273
    t->sleep_queue = NULL;
271
    spinlock_unlock(&t->lock);
274
    spinlock_unlock(&t->lock);
272
 
275
 
273
    thread_ready(t);
276
    thread_ready(t);
274
 
277
 
-
 
278
    if (all)
275
    if (all) goto loop;
279
        goto loop;
276
}
280
}
277
 
281