Information on Bochs/TOS setups in Sci 254 Lab:

1. Log on to Lab PC 1, 2 or 3, using your SFSU login and password.
2. Click on the Cygwin icon on the Desktop.
3. You are now in a Linux-like environment. You see files that are in your home directory on thecity.sfsu.edu.
4. If you type the Unix command "pwd", you'll see you're in the directory /cygdrive/z .
5. The z drive is mapped to your home directory on thecity.sfsu.edu. You should move all files that you're working with into your home directory on thecity, or they may disappear after you log out!
6. Your Desktop is at /cygdrive/c/Documents and Settings/[USERNAME]/Desktop (where [USERNAME] is your login). Downloads go onto your Desktop folder. Again, files on your Desktop folder may disappear after you log out, so make sure you save them in your home directory.
7. The bochs executable is already installed at /cygdrive/c/Cygwin/Bochs-2.3.7/bochs.exe.
8. Now you're ready to test your Bochs installation. We'll do this using Freedos, as described in class. First download the Freedos image
9. In the directory where you plan to run Bochs from, download a bochsrc configuration file: bochsrc
10. Open the bochsrc file using your favorite editor (emacs, vi, pico etc). Look for the line:
    
    floppya: 1_44=/cygwin/home/arno/src/tos-svn/code/tos/image/disk_image, status=inserted
    
    
11. Edit this line so that the path /cygwin/home/arno/src/tos-svn/code/tos/image/disk_image
    is replaced by the path to the Freedos image that you just downloaded.
12. Now start Bochs. There are several ways to do this; there should be a Bochs icon on your Desktop that you can click on, or you can start it from the command line by typing:
    
    /cygdrive/c/Cygwin/Bochs-2.3.7/bochs.exe
    
    
13. Bochs should now boot Freedos, and you will shortly be placed in a text window that looks like DOS, as described in class!
14. Now we're ready to install TOS. (You will need your own copy of TOS to edit for 415.) Download TOS from
    
    http://plum.sfsu.edu/csc415/tos/dist/tos.tar.gz
    
    
15. Move this file into your home directory on thecity.sfsu.edu.
16. Uncompress and untar tos:
    
    gunzip tos.tar.gz tar xvf tos.tar
    
    
17. This expands into a directory called "tos".
18. cd to the tos directory.
19. Type:
    
    sh ./configure
    
    
20. To test your configuration, make sure you're in the tos directory. Type:
    
    cd tos [if necessary...]
    make clean
    make tests
    
    
21. Go to the directory where you plan to run Bochs from. The bochsrc file should be in this directory. Again open it in your favorite editor, and look for the line:
    
    floppya: 1_44=/cygwin/home/arno/src/tos-svn/code/tos/image/disk_image, status=inserted
    
    You may have changed this line earlier, to point to the Freedos installation. Now edit this line so that it's the path to tos/image/disk_image, in your TOS installation.
22. Start Bochs; if you're working with the initial TOS installation, you'll see TOS booting up, and eventually a message like:
    
    test_mem_1 failed
    
    This is fine! You are now ready to work on TOS.
23. Note: Always do a
    
    make clean
    
    before a regular make or make tests!
24. Another note: if you'd like to make changes to the software packages installed earlier, use the Synaptic package manager instead of just deleting files: Synaptic