X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fintro.texi;h=1c6584f4d9d0d4e8700f5a7651cf8b0ea56f1db8;hb=59385cfe7f0fc5a66dfc1da7c2e5b817edbcae65;hp=6ee7ef9f8f24d49238f854d5395b6aa2e50c41f8;hpb=c20a1ee4a5118c4861b33d39d5d0481eeff59283;p=pintos-anon diff --git a/doc/intro.texi b/doc/intro.texi index 6ee7ef9..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 @@ -227,9 +228,9 @@ options. You can select a simulator other than Bochs, although the Leland systems only have Bochs installed. You can start the simulator running a debugger (@pxref{i386-elf-gdb}). You can set the amount of memory to give the VM. Finally, you can set up how you want VM output -to be displayed: use @option{-nv} to turn off the VGA display, +to be displayed: use @option{-v} to turn off the VGA display, @option{-t} to use your terminal window as the VGA display instead of -opening a new window, or @option{-ns} to suppress the serial output to +opening a new window, or @option{-s} to suppress the serial output to @code{stdout}. The @command{pintos} program offers commands other than @samp{run} and @@ -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