summaryrefslogtreecommitdiffstats
path: root/doc/README.sched
blob: 3aa89e6d3920761235c41889c8ca1b7b679087d3 (plain)
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
Notes on the scheduler in sched.c:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  'sched.c' provides an very simplistic multi-threading scheduler.
   See the example, function 'sched(...)', in the same file for its
   API usage.

   Until an exhaustive testing can be done, the implementation cannot
   qualify as that of production quality. It works with the example
   in 'sched.c', it may or may not work in other cases.


Limitations:
~~~~~~~~~~~~

  - There are NO primitives for thread synchronization (locking,
    notify etc).

  - Only the GPRs and FPRs context is saved during a thread context
    switch. Other registers on the PowerPC processor (60x, 7xx, 7xxx
    etc) are NOT saved.

  - The scheduler is NOT transparent to the user. The user
    applications must invoke thread_yield() to allow other threads to
    scheduler.

  - There are NO priorities, and the scheduling policy is round-robin
    based.

  - There are NO capabilities to collect thread CPU usage, scheduler
    stats, thread status etc.

  - The semantics are somewhat based on those of pthreads, but NOT
    the same.

  - Only seven threads are allowed. These can be easily increased by
    changing "#define MAX_THREADS" depending on the available memory.

  - The stack size of each thread is 8KBytes. This can be easily
    increased depending on the requirement and the available memory,
    by increasing "#define STK_SIZE".

  - Only one master/parent thread is allowed, and it cannot be
    stopped or deleted. Any given thread is NOT allowed to stop or
    delete itself.

  - There NOT enough safety checks as are probably in the other
    threads implementations.

  - There is no parent-child relationship between threads. Only one
    thread may thread_join, preferably the master/parent thread.

(C) 2003 Arun Dharankar <ADharankar@ATTBI.Com>