X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Finstallation.texi;h=0fc7b0673c7ab81ba06ce0ad823ff7b4585daecd;hb=3edcfedb8e62970f3293fa676b6691f8658c3c11;hp=3bab217515767b57ef4547c4593f0aba17dca8b5;hpb=2a7028b32e0b34edc8d3d570af1d0d810bea36b4;p=pintos-anon diff --git a/doc/installation.texi b/doc/installation.texi index 3bab217..0fc7b06 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,12 @@ 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 +@file{pintos}, @file{pintos-gdb}, @file{pintos-mkdisk} 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 +112,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 +172,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 +195,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