projects
/
pintos-anon
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Mention style for references.
[pintos-anon]
/
doc
/
threads.texi
diff --git
a/doc/threads.texi
b/doc/threads.texi
index 6a36e0829861adc06ce37b16f149ce682204eb9e..62e8a3e3b5d755a8b9f192c2bd9da782e1cd2e70 100644
(file)
--- a/
doc/threads.texi
+++ b/
doc/threads.texi
@@
-79,7
+79,7
@@
why the @code{switch_threads()} that gets called is different from the
@strong{Warning}: In Pintos, each thread is assigned a small,
fixed-size execution stack just under @w{4 kB} in size. The kernel
does try to detect stack overflow, but it cannot always succeed. You
@strong{Warning}: In Pintos, each thread is assigned a small,
fixed-size execution stack just under @w{4 kB} in size. The kernel
does try to detect stack overflow, but it cannot always succeed. You
-ma cause bizarre problems, such as mysterious kernel panics, if you
+ma
y
cause bizarre problems, such as mysterious kernel panics, if you
declare large data structures as non-static local variables,
e.g. @samp{int buf[1000];}. Alternatives to stack allocation include
the page allocator in @file{threads/palloc.c} and the block allocator
declare large data structures as non-static local variables,
e.g. @samp{int buf[1000];}. Alternatives to stack allocation include
the page allocator in @file{threads/palloc.c} and the block allocator
@@
-282,10
+282,7
@@
program twice and have it do exactly the same thing. On second and
later runs, you can make new observations without having to discard or
verify your old observations. This property is called
``reproducibility.'' The simulator we use, Bochs, can be set up for
later runs, you can make new observations without having to discard or
verify your old observations. This property is called
``reproducibility.'' The simulator we use, Bochs, can be set up for
-reproducibility. If you use the Bochs configuration files we provide,
-which specify @samp{ips: @var{n}} where @var{n} is a number of
-simulated instructions per second, your simulations can be
-reproducible.
+reproducibility, and that's the way that @command{pintos} invokes it.
Of course, a simulation can only be reproducible from one run to the
next if its input is the same each time. For simulating an entire
Of course, a simulation can only be reproducible from one run to the
next if its input is the same each time. For simulating an entire
@@
-502,9
+499,6
@@
it on by inserting the line @code{#define MLFQS 1} in
@node Threads FAQ
@section FAQ
@node Threads FAQ
@section FAQ
-@enumerate 1
-@item General FAQs
-
@enumerate 1
@item
@b{I am adding a new @file{.h} or @file{.c} file. How do I fix the
@enumerate 1
@item
@b{I am adding a new @file{.h} or @file{.c} file. How do I fix the
@@
-587,7
+581,15
@@
the function isn't actually used by other @file{.c} files, make it
@code{static}.
@end enumerate
@code{static}.
@end enumerate
-@item Alarm Clock FAQs
+@menu
+* Problem 1-1 Alarm Clock FAQ::
+* Problem 1-2 Join FAQ::
+* Problem 1-3 Priority Scheduling FAQ::
+* Problem 1-4 Advanced Scheduler FAQ::
+@end menu
+
+@node Problem 1-1 Alarm Clock FAQ
+@subsection Problem 1-1: Alarm Clock FAQ
@enumerate 1
@item
@enumerate 1
@item
@@
-630,7
+632,8
@@
values are expressed as signed 63-bit numbers, which at 100 ticks per
second should be good for almost 2,924,712,087 years.
@end enumerate
second should be good for almost 2,924,712,087 years.
@end enumerate
-@item Join FAQs
+@node Problem 1-2 Join FAQ
+@subsection Problem 1-2: Join FAQ
@enumerate 1
@item
@enumerate 1
@item
@@
-642,7
+645,8
@@
A parent joining a child that has completed should be handled
gracefully and should act as a no-op.
@end enumerate
gracefully and should act as a no-op.
@end enumerate
-@item Priority Scheduling FAQs
+@node Problem 1-3 Priority Scheduling FAQ
+@subsection Problem 1-3: Priority Scheduling FAQ
@enumerate 1
@item
@enumerate 1
@item
@@
-768,7
+772,8
@@
its priority has been increased by a donation?}
The higher (donated) priority.
@end enumerate
The higher (donated) priority.
@end enumerate
-@item Advanced Scheduler FAQs
+@node Problem 1-4 Advanced Scheduler FAQ
+@subsection Problem 1-4: Advanced Scheduler FAQ
@enumerate 1
@item
@enumerate 1
@item
@@
-816,4
+821,3
@@
However, you are free to do so.
No. Hard-coding the dispatch table values is fine.
@end enumerate
No. Hard-coding the dispatch table values is fine.
@end enumerate
-@end enumerate