The following suite of utilities are designed to assist you with verifying your CVS submission builds and runs. Note that these commands are not part of CVS and are only available on the UMBC Linux servers (e.g. linux1.gl.edu).

Students are strongly encouraged to verify the accuracy of each project submission using these utilities.

Setup

The CVS utilites are located in the directory

/afs/umbc.edu/users/f/r/frey/pub/341/bin/

To use the commands you may specifiy the complete pathname.

linux1[4]% /afs/umbc.edu/users/f/r/frey/pub/341/bin/the-command

Or, you may change your Unix PATH to incude that directory by editting your .cshrc file found in your home directory (notice the leading "dot".) In your favorite editor, add the following line somewhere near the bottom of your file.

set path = ( $path /afs/umbc.edu/users/f/r/frey/pub/341/bin )

The next time you login, the directory which contain the utilities will be searched when these commands are executed. You can verify the change to your PATH using the following command. You should see the directory at the end of the your path.

linux1[5]% echo $PATH

If you choose to edit your .cshrc file, do so with extreme care. The smallest mistake can have dire consequences.

cvsbuild

The cvsbuild utility allows you to checkout and build what you have submitted in a single command making it easy to verify your submission.

It is highly recommended that you run this command from the same directory that you originally ran cvs checkout so that the temporary project directory that this command builds and your original project directory are under the same parent directory.

The cvsbuild command should be invoked with the path to the CVS repository for the given assignment. For example (if you have not set your PATH)…

linux2[2]% /afs/umbc.edu/users/f/r/frey/pub/341/bin/cvsbuild /afs/umbc.edu/users/f/r/frey/pub/cs341s12/Proj0/

Attempting CVS Checkout
-----------------------
cvs checkout: Updating dhood2-cvs-checkout
U dhood2-cvs-checkout/.classpath
U dhood2-cvs-checkout/.project
U dhood2-cvs-checkout/build.xml
U dhood2-cvs-checkout/hello.txt
cvs checkout: Updating dhood2-cvs-checkout/.settings
U dhood2-cvs-checkout/.settings/org.eclipse.jdt.core.prefs
cvs checkout: Updating dhood2-cvs-checkout/src
cvs checkout: Updating dhood2-cvs-checkout/src/proj0
U dhood2-cvs-checkout/src/proj0/HelloWorld.java

Attempting Build
----------------
Buildfile: build.xml

init:
    [mkdir] Created dir: /afs/umbc.edu/users/d/h/dhood2/home/dhood2-cvs-checkout/bin
    [mkdir] Created dir: /afs/umbc.edu/users/d/h/dhood2/home/dhood2-cvs-checkout/doc

compile:
    [javac] Compiling 1 source file to /afs/umbc.edu/users/d/h/dhood2/home/dhood2-cvs-checkout/bin

BUILD SUCCESSFUL
Total time: 1 second
linux2[3]%

Running this script will attempt to checkout your code into a directory called <username>-cvs-checkout. If everything is submitted correctly, you should see the BUILD SUCCESSFUL message as shown above. If not, something is either missing from your submission or files are not submitted correctly.

Notes:

Every time you change something in the repository you are encouraged to re-run this command.
Upon re-running the script, if you already have a <username>-cvs-checkout directory the script will notify you that it needs to remove the contents to perform the checkout/build.
If you wish to avoid the prompt on subsequent runs of the cvsbuild command, simply add a -y flag on the command line (e.g. cvsbuild -y /path/to/repository).

cvsrun

The cvsrun utility allows you to test your program like the graders do. In order to use the cvsrun command you will first need to check-out and build your code using cvsbuild.

The cvsrun command should be invoked with any necessary command line arguments for your main. For example (assuming you have set your PATH)…

linux2[3]% cvsrun arg1 arg2 arg3
Buildfile: build.xml

run:
     [java] Hello World!
     [java] args:
     [java] arg1
     [java] arg2
     [java] arg3

BUILD SUCCESSFUL
Total time: 0 seconds
linux2[4]%

If all goes well, you should see your project run with the arguments you've provided.

Notes:

If you get an “Exception in thread "main" java.lang.NoClassDefFoundError” error the likely cause is that your main.class property value doesn't point to a valid class (either the name is wrong, or its location doesn't match its package hierarchy).
Once you're satisfied you can safely remove the <username>-cvs-checkout directory created by cvsbuild and used by cvsrun.

cvsreset

Sometimes students experience issues with their CVS repository. If you're running into problems that you believe to be an issue with your repository (e.g. your files are "locked") you may reset it to the initial state for a given project.

The effects of the cvsreset are irreversible! Running this command will delete everything you've submitted via CVS for a given project. Ensure that you have a local copy of your source code before running this command.

Once you've ensured you have a local copy of your code, you can reset the repository like so (again, assuming you have set your PATH)…

linux2[4]% cvsreset /afs/umbc.edu/users/f/r/frey/pub/cs341s12/Proj0
This script will reset your CVS repository to its original condition.
This operation is irreversible - anything submitted will be removed.
Ensure that you have a local copy of your code before continuing.

Enter "y" to continue or "n" to exit: y

Resetting CVS repository
------------------------
Done
linux2[5]%

Now complete the process with the following steps

From the parent directory of your project directory, check out your project into a new project directory.
Recreate your directory structure and copy your saved files to the new project directory.
Rerun the cvs add and cvs commit commands for your directories and files in your new project.