Many students who run Windows on their home computers would like the ability to do 61c assignments from home without going to or connecting to the labs. As a result, the following are instructions to install Cygwin, a UNIX-like environment for Windows. NOTE: Before you continue, remember that all assignments are tested and graded by running them on the instructional machines (a.k.a nova, star, solar, etc). You must verify your project works on one of these platforms. It is not good enough to say that your assignment worked under Linux or Cygwin/Windows. The staff will not grant assignment extensions (or grace periods) because of porting issues between your home computer and the instructional machines (i.e. nova, star, solar, cory, etc.) WARNING: These instructions are provided as is and the staff will not be held responsible any unexpected behavior of your computer due to the following the directions below. 1. Go to http://www.cygwin.com 2. Click on the link that says "Install Cygwin now." Save setup.exe somewhere on your computer (preferably not on a floppy) 3. Run setup.exe. A window should appear that says "Cygwin Net Release Setup Program" 4. Click on 'Next' 5. Select 'Install from Internet' 6. Click on 'Next' 7. Make sure 'Root Directory' is 'C:\Cygwin' and 'Default Text File Type' is 'UNIX/binary' 8. Click on 'Next' 9. Do not modify 'Local Package Directory' field and click on 'Next' 10. Click on 'Direct Connection' on the 'Select Your Internet Connection' 11. Click on 'Next' 12. The setup will now download a list of mirrors. You can select any of them. My preference is 'ftp://gnu.kookel.org' 13. After you select a mirror, click on 'Next' 14. Wait for the setup program to download 'setup.bz2.' When it finishes downloading you should see a screen titled 'Select Packages' 15. Click the '+' next to 'Devel'. 16. Make sure the following packages do not have 'Skip' on their lines. If they have 'Skip', just click on it to change it to something that isn't 'Skip': + ddd + gcc-core + gdb + make 17. Click on the '+' next to 'Editors'. 18. Make sure the following packages do not have 'Skip' on their lines. If they have 'Skip', just click on it to change it to something that isn't 'Skip': + emacs + emacs-X11 19. Click on the '+' next to 'X11' 20. Make sure the following packages do not have 'Skip' on their lines. If they have 'Skip', just click on it to change it to something that isn't 'Skip': + X-start-menu-icons + X-startup-scripts + xorg-x11-base + xorg-x11-bin + xorg-x11-bin-dlls + xorg-x11-devel + xorg-x11-xwin + xterm 21. Click on 'Next' 22. Wait for everything to download. 23. Under 'Create Icons', leave the checks as is. 24. Click on 'Finish' You are now 95% through the installation process, the remaining 5% is to see if everything installed correctly. 25. Restart your computer. (YOU MUST DO THIS OTHERWISE THE FOLLOWING STEPS WILL NOT DO WHAT THEY ARE EXPECTED TO DO) 26. Double-click the Cygwin icon on your desktop. A 'bash' window should appear. If you see a ~ in the console prompt, everything is good. If you don't, then consult a TA who knows Cygwin. 27. Close the 'bash' window 28. Open the following folder: C:\Cygwin\usr\X11R6\bin 29. Find 'startxwin.bat', right-click and select 'Create Shortcut' 30. Move the created shortcut to the desktop, and double click on it. An 'X' should appear next to your clock and an 'xterm' window should pop open. If it does, you are just about done. If not, then consult a TA who knows Cygwin. 31. Verify you can find gcc, gdb, and emacs by typing the following in the 'xterm' console. You should get the following output: % which gcc /usr/bin/gcc % which gdb /usr/bin/gdb % which emacs /usr/bin/emacs If anything deviates from that, then you probably have not installed them. Try running setup again, and make sure steps 16-20 were done correctly. 32. You are done :D Some Cygwin basics ================== -- When running in xterm, you are in a UNIX environment, so ~ means your home folder. If you want to find this folder via Windows, you can find it at C:\Cygwin\home\Programs->Cygwin-X->xterm or you can just type 'xterm&' in an opened 'xterm' window -- If you get 'command not found' and it is a command of UNIX, then you probably have not installed it yet. Just simply run the Setup program again, on 'Select Package', change the view to 'Full' and scroll through the packages to find your UNIX command. Just as a reminder, remember that all assignments are tested and graded by running them on the instructional machines (a.k.a nova, star, solar, etc). You must verify your project works on one of these platforms. It is not good enough to say that your assingment worked under Linux or Cygwin/Windows. One last piece of advice, if you have spent all day getting this to work and it still doesn't work--STOP! Just use SSH or go to lab. It is not worth your time to spend several days trying to get this to work when you could have spent this time doing your assignment in the labs. ~Michael