*** HOWTO.orig	Thu May  8 10:21:24 2003
--- HOWTO	Thu Aug 19 08:15:48 2004
***************
*** 125,139 ****
  
      - ftp://alpha.gnu.org/gnu/grub/
  
! Download the lastest version (grub-0.93.tar.gz), change to a temporary
  directory (you won't need the grub files after this and can just go ahead and
  delete the whole directory structure that was generated) and unarchive
! 'grub-0.93.tar.gz' following the instructions given above in [2. Unarchiving].
  
        $ cd /tmp
        $ mkdir grub
        $ cd grub
!       $ cat grub-0.93.tar.gz | gzip -d | tar xf -
  
  after this is done create a build directory and decend into it:
  
--- 125,139 ----
  
      - ftp://alpha.gnu.org/gnu/grub/
  
! Download the lastest version (grub-0.95.tar.gz), change to a temporary
  directory (you won't need the grub files after this and can just go ahead and
  delete the whole directory structure that was generated) and unarchive
! 'grub-0.95.tar.gz' following the instructions given above in [2. Unarchiving].
  
        $ cd /tmp
        $ mkdir grub
        $ cd grub
!       $ cat grub-0.95.tar.gz | gzip -d | tar xf -
  
  after this is done create a build directory and decend into it:
  
***************
*** 142,148 ****
  
  then configure GRUB with the standard options:
  
!       $ ../grub-0.93/configure
  
  and if successful run make:
  
--- 142,148 ----
  
  then configure GRUB with the standard options:
  
!       $ ../grub-0.95/configure
  
  and if successful run make:
  
***************
*** 275,291 ****
  procedure in item 6.2 up to the configure point. At this point
  run the following configure command:
  
!     $ ../grub-0.93/configure --enable-diskless --enable-eepro100
  
  for an Etherexpress Pro 100 network card, then run make:
  
      $ make
  
!     Once complete you should have the 'stage2/pxegrub' file. Copy 
! this to your TFTP server's download directory. Configure your
! DHCP server to provide an IP address and download the image. For
! the ISC server found on operating systems such as Linux something
! like the following should do:
  
    #
    # PC loading RTEMS via PXE and GRUB
--- 275,303 ----
  procedure in item 6.2 up to the configure point. At this point
  run the following configure command:
  
!     $ ../grub-0.95/configure --enable-diskless --enable-eepro100
  
  for an Etherexpress Pro 100 network card, then run make:
  
      $ make
  
!     Once complete you should have the 'stage2/pxegrub' file. Copy
! this to your TFTP server's download directory (frequently "/tftpboot")
! as "pxegrub".  Configure your DHCP server to provide an IP address
! and download the image. For the ISC server found on operating systems
! such as Linux something like the following should do.
! 
!      ABSOLUTE PATHNAME NOTE: GRUB will only load absolute path names
! for configuration files.  On at least the 4.x releases, the FreeBSD
! inetd setup enforces relative pathnames.  You must change inetd.conf
! to allow absolute pathnames.  Change the tftp entry to run as
! "nobody" and not specify that it chroot to /tftpboot:
! 
!   #tftp   dgram   udp     wait    root    /usr/libexec/tftpd      tftpd -s /tftpboot
!   tftp    dgram   udp     wait    nobody  /usr/libexec/tftpd      tftpd
! 
! 
! Now here is the example configuration for the ISC server:
  
    #
    # PC loading RTEMS via PXE and GRUB
***************
*** 293,305 ****
  
    group
    {
!     filename "/tftpboot/pxeboot";
      host rtems-pc { hardware ethernet 00:08:c7:73:41:65; }
    }
  
  If all works your PC should boot and load GRUB over the network:
  
!     GRUB  version 0.93  (639K lower / 64512K upper memory)
  
    Address: 10.10.10.10
    NetMask: 255.255.255.0
--- 305,317 ----
  
    group
    {
!     filename "/tftpboot/pxegrub";
      host rtems-pc { hardware ethernet 00:08:c7:73:41:65; }
    }
  
  If all works your PC should boot and load GRUB over the network:
  
!     GRUB  version 0.95  (639K lower / 64512K upper memory)
  
    Address: 10.10.10.10
    NetMask: 255.255.255.0
***************
*** 323,334 ****
  
    grub> boot
  
! The GRUB documents how to get GRUB to load a configuration file.
  
  
  6.4 Using NetBoot to load RTEMS PC386 applications
  ---------------------------------------------------
  
      To load the '*.bt' files you can
  
      Alternatively, if you have a PC connected to a network with a
--- 335,370 ----
  
    grub> boot
  
! The GRUB documents how to get GRUB to load a GRUB configuration
! file.  Here's a small example.  At the top level of the ISC DHCP
! configuration file define the option that GRUB uses to get its
! configuration file, and then add it below where you specified the
! boot filename:
! 
!   # For GRUB net-booting:
!   option grub-config code 150 = text;
! 
!   group
!   {
!     filename "/tftpboot/pxegrub";
!     host rtems-pc { hardware ethernet 00:08:c7:73:41:65; }
!     option grub-config "(nd)/tftpboot/rtems-pc.cfg";
!   }
! 
  
+ Now when GRUB boots it will look for "rtems-pc.cfg".  Create
+ "rtems-pc.cfg" in /tftpboot.  Here is a simple example that will
+ boot "ticker.exe" after five seconds.  Note that "ticker.exe" must
+ also be in /tftpboot.
+ 
+   timeout 5
+   title RTEMS ticker.exe sample
+   kernel /tftpboot/ticker.exe
  
  6.4 Using NetBoot to load RTEMS PC386 applications
  ---------------------------------------------------
  
+ XXX - Someone fix this floating clause:
      To load the '*.bt' files you can
  
      Alternatively, if you have a PC connected to a network with a