X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fintro.texi;h=1c6584f4d9d0d4e8700f5a7651cf8b0ea56f1db8;hb=12b6c9617cf12b3634abc0fade3133bda91dcc6f;hp=94a1bd6e42c8e3f8155852fe7cde345b547ed41b;hpb=ba48df561d04272b8cd819bf24c9cbde0f4bb085;p=pintos-anon diff --git a/doc/intro.texi b/doc/intro.texi index 94a1bd6..1c6584f 100644 --- a/doc/intro.texi +++ b/doc/intro.texi @@ -1,4 +1,4 @@ -@node Introduction, Project 1--Threads, Top, Top +@node Introduction, Pintos Tour, Top, Top @chapter Introduction Welcome to Pintos. Pintos is a simple operating system framework for @@ -9,10 +9,10 @@ project team will strengthen its support in all three of these areas. You will also add a virtual memory implementation. Pintos could, theoretically, run on a regular IBM-compatible PC. As -fun as it might be, it is impractical to supply every student in CS -140 with his or her own PC. Therefore, we will run Pintos projects in -a PC simulator, that is, a program that simulates an 80@var{x}86 CPU -and its peripheral devices well enough that unmodified operating +much fun as it might be, it is impractical to supply every student in +CS 140 with his or her own PC. Therefore, we will run Pintos projects +in a PC simulator, that is, a program that simulates an 80@var{x}86 +CPU and its peripheral devices well enough that unmodified operating systems and software can run under it. In class we will use the @uref{http://bochs.sourceforge.net, , Bochs} simulator. Pintos has also been tested within @uref{http://fabrice.bellard.free.fr/qemu/, , @@ -36,6 +36,7 @@ projects. @menu * Getting Started:: +* Pintos License:: * Pintos Trivia:: @end menu @@ -79,7 +80,7 @@ Now you can extract the source for Pintos into a directory named @example tar xzf /usr/class/cs140/pintos/pintos.tar.gz @end example -Alternatively +Alternatively, retrieve @uref{http://www.stanford.edu/class/cs140/pintos/pintos.tar.gz} and extract it in a similar way. @@ -165,7 +166,7 @@ the kernel. @xref{Adding c or h Files}, for more information. Object file for the entire kernel. This is the result of linking object files compiled from each individual kernel source file into a single object file. It contains debug information, so you can run -@command{gdb} or +@command{gdb} or @command{backtrace} (@pxref{Backtraces}) on it. @item kernel.bin Memory image of the kernel. These are the exact bytes loaded into @@ -210,7 +211,7 @@ are not very useful for our purposes. (If no window appeared at all, and you just got a terminal full of corrupt-looking text, then you're probably logged in remotely and X forwarding is not set up correctly. In this case, you can fix your X -setup, or you can use the @option{nv} option.) +setup, or you can use the @option{-v} option.) The text printed by Pintos inside Bochs probably went by too quickly to read. However, you've probably noticed by now that the same text @@ -241,6 +242,23 @@ options. These options must be specified @emph{after} the but you can see a list of them using the @option{-u} option, e.g.@: @code{pintos run -u}. +@node Pintos License +@section Pintos License + +Pintos is distributed under a liberal license that allows it to be +freely used, modified, and distributed. Students and others own their +own code and may use it for any purpose. In the context of Stanford's +CS 140 course, please respect the spirit and the letter of the honor +code by refraining from reading any homework solutions available +online or elsewhere. (Source code for other operating system kernels, +such as Linux or FreeBSD, is of course fair game.) + +There is NO WARRANTY for Pintos, not even for MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. + +Please refer to the @file{LICENSE} file at the top level of the Pintos +source distribution for details of license and lack of warranty. + @node Pintos Trivia @section Pintos Trivia