Introduction |
Table of contents |
Linux Installation |
This software has only been tested under Windows 2000. The software is
unlikely to function properly under previous versions of Windows. Running it
under newer versions might also prove problematic, especially if they are not
based on the NT line of kernels.
You probably need to run this software from an administrator account.
You probably need to install the C and Pascal compilers. The software assumes the needed directories are in your PATH variable, so that the compilers can be called by simply typing "bcc" and "tpc" from the command prompt. See item 1. under "Setting up the machine" if this doesn't work.
You need to install Cygwin (a POSIX emulation for Windows), before using this software. The official Web page of the Cygwin project is www.cygwin.com.
The default installation might prove too restrictive. Click here to see a list of recommended packages.
Hint: the Cygwin installation software has an option for downloading packages to a local directory. This might come in handy when setting up a machine without Internet access.
In any case, it is very important that you choose DOS as the "Default File
Type" when prompted during the installation process.
Reminder: by downloading this file, you agree to the terms and conditions set forth by the copyright holder. Click here to review these conditions before you proceed.
After you install the Cygwin packages, you need to create an environment variable with the Cygwin installation directory. The way to do this is to go to Control Panel > System, choose the last tab ("Advanced"), and then click "Environment Variables...". You then want to add a system variable -- not a user variable (click the "New..." button from the lower half of the dialog). When prompted, enter CYGROOT as the variable name and the installation directory as the variable value (e.g. c:\cygwin).
You might also want to edit the PATH variable under "User Variables" and add the Borland C and Borland Pascal binary directories if they are not already in the path (see item 2. above).
It is time to start the Cygwin environment (you will need to
restart any instances of the shell you had running before changing the
environment variables). Issue the following commands:
~$ cd / /$ tar vxzf /cygdrive/c/download/win-eval.tgz ^-- this means c:\download\win-eval.tgz /$ eval/inst/install.sh /$ eval/inst/beautify.sh /$ exit |
Warning: the beautify script will make some changes to your environment (e.g. add /etc/profile.d/beauty.sh), in an attempt to make it more user friendly (e.g. typing d will give you a nice colored directory listing). As these changes are not essential to the operation of the program, you may choose not to run beautify.sh and preserve your own settings. In any case, you must still run install.sh.
The Cygwin installation process creates some links to cygwin.bat, that are used to start the shell (you probably used the "Cygwin" link on the one the desktop to start Cygwin the first time). These links will not work any more, because install.sh removed cygwin.bat. Hopefully, a new link called "Start cygwin" has been copied to your desktop (if not, you can copy it manually from cygwin\eval\inst\). You must use this link to start Cygwin; you should remove the old "Cygwin" link to avoid confusion.
The default installation includes a sample problem called sum, and source files for two contestants: judge-1 and judge-2. It is recommended that you run eval.sh using these sample entries to make sure everything is functioning properly. Remember you must restart the Cygwin environment after running install.sh using the new link.
This section only describes Windows specifics. For general operating instructions, see the Table of Contents.
You cannot grade programs while another DOS Virtual Machine is running in the background. You must close all DOS programs (like the Borland IDEs) before you issue the eval command. Furthermore, you may not start a DOS program while eval is running.
Sometimes, the DOS Virtual Machine seems to remain in the background even if no DOS program is running. This happens when you issue DOS commands in the Cygwin shell. To avoid problems, don't call DOS programs from the Cygwin prompt. You can kill such a DOS Virtual Machines gone astray using the Task Manager (right click on the task bar to open it, and look for processes called ntvdm).
It is recommended that you disable the screen saver on the grading machine, to improve the accuracy of the timing.
In theory, the advanced security measures make it impossible for DOS programs to crash the grading system. The software is, however, designed to handle the case of the grader failing to kill a misbehaving DOS program, or an operating system crash. When you run eval again (maybe after resetting the machine), it will pick up from where it was interrupted, awarding zero points for the test that caused the program to crash.