How to turn in your homework

Things to keep in mind:

All assignments are to be submitted electronically and are automatically time stamped, so we know when files were submitted. PLEASE SUBMIT ASSIGNMENTS ON TIME!

Logs are kept of everything, so if you try to submit files and it does not work correctly, we can look at the logs to help identify the problems.

It is your responsibility to ensure that you have submitted all the files that are required for each assignment. All files you submit should be named appropriately. If you fail to submit homework, we cannot grade it! And if we can’t grade it, you get a zero for the assignment, so please be sure to submit things properly.

You can run the checkin program on the same file as many times as you like. The checkin program will keep every copy, but only the most recent will be graded. If, for some reason, you want an older version to be graded, let us know.

The checkin program only runs on Linux machines. Almost all of the machines in the labs run Linux. But if for some reason you log in on a machine that runs another OS, you can log in to a linux machine and run the checkin program from there.

The checkin program will let you check in any file at all, whether it is a text file, or an executable, or a jpeg, or a video game, or a ... you get the idea ... so be careful what you submit!

The checkin program will NOT alter your copy of the file being submitted. It will just send a duplicate of it for grading. Don’t worry about it harming your files—it won’t.

You can turn in files any time you like as HW0. It is a dummy homework assignment, and is only there so you can test the submission programs out without actually turning something in.

Every assignment has three dates associated with it:

Assigned date: If you try to submit a file BEFORE it’s assigned, the checkin program won’t let you.
Due Date: The checkin program will remind you of the due date of an assignment when you submit it. If you are before the due date, it will let you know how much longer you have to re-sumbit a newer version before the due date. If you are after the due date, it will let you know that the assignment is late. Hopefully you will still get some partial credit.
Drop Dead Date: The date after which the homework will not be accepted. The checkin program will simply not let you submit after this date. After this date, there is no partial credit. Sorry!
However, if you would like feedback on your homework after the drop dead date, you can email the homework to the TA and the TA will give you feedback on how you did (but no grade!)

The Procedure:

Login to a Linux machine (if you aren’t on one already).
"cd" to the subdirectory containing the file(s) to check in.
Type ~cs155/bin/checkin HWx filenames

HWx should be whichever homework you are submitting (such as HW3 or HW1), and filenames should be replaced with whatever filenames you want so submit. You don’t need to submit all of the files at the same time if you don’t want to. One at a time is fine as well, they will only overwrite the older files if they have the SAME name.

The checkin program will tell you some messages. Hopefully, they will say encouraging things like "Checkin successful", and the current date/time, and other useful information. It will also tell you if it has made any backups of older files.

Verifying that things went smoothly (if you’re worried):

First, login to one of the CS Department Linux machines (if you aren’t on one already).

To get a list of all the files that you've ever submitted for this class:

    ~cs155/bin/peek

To get a list of the files for a particular homework assignment:

    ~cs155/bin/peek HWx

To look at a particular file that you checked in:

    ~cs155/bin/peek HWx filename

or:

    ~cs155/bin/peek HWx filename | more

Checking your grades (and comments):

To see all your grades for this class:

    ~cs155/bin/grade

To see just the grade for a particular assignment:

    ~cs155/bin/grade HWx

Making it easier:

You may not like typing in such long commands. In that case, you can add aliases to your .cshrc file:

    alias ci155 '~cs155/bin/checkin'
    alias pk155 '~cs155/bin/peek'

The effect would be that you would only need to type:

    ci155 HW2 myfile.txt

instead of

    ~cs155/bin/checkin HW2 myfile.txt

An example

Let’s say you wanted to turn in a file Results.txt for homework #2:

    > cd ~/Assignment2
    > ls
    Results.txt  SomeOtherFile.txt  SomeThingElse.txt
    > ~cs155/bin/checkin HW2 Results.txt
    Checking in files for assignment 'HW2'
    Current time is: Mon Aug  8 12:16:03 2008
    Assignment is ON TIME!
      If you wish, you may turn in another (presumably better)
      version up until Fri Dec  9 23:59:59 2008
      and it will replace this version.

    File Results.txt was checked in.

Now, suppose you made a mistake and wish to fix it and submit a new copy..

    > vi Results.txt
    > ~cs155/bin/checkin HW2 Results.txt
    Checking in files for assignment 'HW2'
    Current time is: Mon Aug  8 13:45:35 2008
    Assignment is ON TIME!
      If you wish, you may turn in another (presumably better)
      version up until Fri Dec  9 23:59:59 2008
      and it will replace this version.

    Renaming old Results.txt to Results.txt.old
    File Results.txt was checked in.
    > ~cs155/bin/peek
    Size        Date             Time      Assignment  File
    ----------  ---------------  --------  ----------  ----
         13703  Mon Aug  8 2008  13:45:35  HW2         Results.txt
         13814  Mon Aug  8 2008  12:16:03  HW2         Results.txt.old

      2 Files listed