projects
/
pintos-anon
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (parent:
3c732ba
)
Talk about write() to stdout more.
author
Ben Pfaff
<blp@cs.stanford.edu>
Sat, 1 Jan 2005 00:38:35 +0000
(
00:38
+0000)
committer
Ben Pfaff
<blp@cs.stanford.edu>
Sat, 1 Jan 2005 00:38:35 +0000
(
00:38
+0000)
doc/userprog.texi
patch
|
blob
|
history
diff --git
a/doc/userprog.texi
b/doc/userprog.texi
index 72e8d8177a07b4641b3762e275b6e71e740b0a40..e3771e4e1aaf0f79e089841fa9d6432903737973 100644
(file)
--- a/
doc/userprog.texi
+++ b/
doc/userprog.texi
@@
-456,7
+456,13
@@
than end of file). Fd 0 reads from the keyboard using
@itemx int write (int @var{fd}, const void *@var{buffer}, unsigned @var{size})
Write @var{size} bytes from @var{buffer} to the open file @var{fd}.
Returns the number of bytes actually written, or -1 if the file could
@itemx int write (int @var{fd}, const void *@var{buffer}, unsigned @var{size})
Write @var{size} bytes from @var{buffer} to the open file @var{fd}.
Returns the number of bytes actually written, or -1 if the file could
-not be written. Fd 1 writes to the console.
+not be written.
+
+Fd 1 writes to the console. Your code to write to the console should
+write all of @var{buffer} in one call to @func{putbuf}, at least as
+long as @var{size} is not bigger than a few hundred bytes. Otherwise,
+lines of text output by different processes may end up interleaved on
+the console, confusing both human readers and our grading scripts.
@item SYS_seek
@itemx void seek (int @var{fd}, unsigned @var{position})
@item SYS_seek
@itemx void seek (int @var{fd}, unsigned @var{position})