lkml.org 
[lkml]   [2005]   [Jun]   [25]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
From
Subject[RFC] Driver writer's guide to sleeping
Date
Hi folks,

I'm working on a Linux wireless driver.

I compiled a little guide for myself about waiting primitives.
I would appreciate if you look thru it. Maybe I'm wrong somewhere.

udelay(us)
Busywaits for specified amount of usecs.
Ok to call in IRQ-disabled regions.
May be preempted (if not in atomic region).
Q: how precise is it? (can it sometimes wait much longer?
If yes, is that happens only if preempted?)

mdelay(ms)
Same as udelay but for msecs.

schedule()
switch to other runnable task, if any. CPU
will be returned to us as soon as no other runnable tasks
with higher dynamic prio are left. This means
that sometimes schedule() returns practically at once.

yield()
like schedule() but also drop our dynamic prio
to the minimum. result: all other runnable tasks will
run before CPU is returned to us. Yet, yield may return
at once if there is no runnable tasks.

schedule_timeout(timeout)
Whee, it has a comment! :)
* %TASK_UNINTERRUPTIBLE - at least @timeout jiffies are guaranteed to
* pass before the routine returns. The routine will return 0
*
* %TASK_INTERRUPTIBLE - the routine may return early if a signal is
* delivered to the current task. In this case the remaining time
* in jiffies will be returned, or 0 if the timer expired in time
*
* The current task state is guaranteed to be TASK_RUNNING when this
* routine returns.
Thus:
set_current_state(TASK_[UN]INTERRUPTIBLE);
schedule_timeout(timeout_in_jiffies)

msleep(ms)
Sleeps at least ms msecs.
Equivalent to:
set_current_state(TASK_UNINTERRUPTIBLE);
schedule_timeout(timeout)
Q: why implementation does while(timeout) timeout = schedule_timeout(timeout)?
Does that mean that schedule_timeout's comment (see above) is not true?!

msleep_interruptible(ms)
Sleeps ms msecs (or more) unless has been woken up (signal, waitqueue...).
Q: exact list of possible waking events? (I'm a bit overwhelmed by multitude
of slightly different waitqueues, tasklets, softirqs, bhs...)

ssleep(s)
Same as msleep but in seconds

need_resched()
returns true if for some reason kernel would like to schedule
another task. Useful to check under lock for lock breaking.

cond_resched()
basically: while(need_resched()) schedule();
returns 1 if scheduled at least once.
--
vda

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

\
 
 \ /
  Last update: 2005-06-25 11:55    [W:0.140 / U:0.320 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site