X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?p=pintos-anon;a=blobdiff_plain;f=doc%2Finstallation.texi;h=f6dfe44f428bd51e59bf6528e935191ca82c87b9;hp=3bab217515767b57ef4547c4593f0aba17dca8b5;hb=a03618133f7df0954802a470a4bee7674f7aed45;hpb=2a7028b32e0b34edc8d3d570af1d0d810bea36b4 diff --git a/doc/installation.texi b/doc/installation.texi index 3bab217..f6dfe44 100644 --- a/doc/installation.texi +++ b/doc/installation.texi @@ -40,8 +40,8 @@ Required: @uref{http://www.gnu.org/software/make/, GNU make}, version 3.80 or later. @item -Recommended: @uref{http://fabrice.bellard.free.fr/qemu/, qemu}, version -0.8.0 or later. If qemu is not available, Bochs can be used, but its +Recommended: @uref{http://fabrice.bellard.free.fr/qemu/, QEMU}, version +0.8.0 or later. If QEMU is not available, Bochs can be used, but its slowness is frustrating. @item @@ -79,12 +79,13 @@ described below (@pxref{Building Bochs for Pintos}). @item Install scripts from @file{src/utils}. Copy @file{backtrace}, -@command{pintos}, @command{pintos-gdb}, @command{pintos-mkdisk} into the -default @env{PATH}. +@file{pintos}, @file{pintos-gdb}, @file{pintos-mkdisk}, +@file{pintos-set-cmdline}, and @file{Pintos.pm} into the default +@env{PATH}. @item Install @file{src/misc/gdb-macros} in a public location. Then use a -text editor to edit the installed copy of @command{pintos-gdb}, changing +text editor to edit the installed copy of @file{pintos-gdb}, changing the definition of @env{GDBMACROS} to point to where you installed @file{gdb-macros}. Test the installation by running @command{pintos-gdb} without any arguments. If it does not complain @@ -112,6 +113,13 @@ documentation, plus the design document templates and various hardware specifications referenced by the documentation. Building the PDF version of the manual requires Texinfo and @TeX{} (see above). You may install @file{WWW} wherever you find most useful. + +The @file{doc} directory is not included in the @file{.tar.gz} +distributed for Pintos. It is in the Pintos CVS tree available via +@code{:pserver:anonymous@@footstool.stanford.edu:/var/lib/cvs}, in the +@code{pintos} module. The CVS tree is @emph{not} the authoritative +source for Stanford course materials, which should be obtained from the +course website. @end enumerate @menu @@ -165,6 +173,16 @@ harmless elsewhere. Needed for Bochs to compile in terminal support on Solaris hosts. Probably harmless elsewhere. +@item bochs-2.2.6-page-fault-segv.patch + +Makes the GDB stub report a SIGSEGV to the debugger when a page-fault +exception occurs, instead of ``signal 0.'' The former can be ignored +with @code{handle SIGSEGV nostop} but the latter cannot. + +@item bochs-2.2.6-paranoia.patch + +Fixes compile error with modern versions of GCC. + @item bochs-2.2.6-solaris-link.patch Needed on Solaris hosts. Do not apply it elsewhere. @@ -178,6 +196,8 @@ patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-jitter.patch patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-triple-fault.patch patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-ms-extensions.patch patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-solaris-tty.patch +patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-page-fault-segv.patch +patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-paranoia.patch patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-solaris-link.patch @end example @noindent