User Commands HANDIN(1) NAME handin - system for submitting assignments online SYNOPSIS handin [ switches ] course assignment handin -l course (query course assignments) Switches are: -c --check submissions -o --overwrite -p --turn off confirmation prompts -f file --user provided zipfile DESCRIPTION Handin was developed to allow students to hand in their assignments electronically, rather than on paper. It is a secure system that (essentially) has the student account actually hand the assignment to the course account. Note that handin makes a copy of the assignment. It does not link back to the student's files. The course field is the course account. Generally, the course account is in the form of csnnn where nnn is the course number. The assignment field is the name of the assignment. It is commonly something like assn1 but can be quite different. The TA/Instructor sets the assignment name in the course config file. If you are not using the -f switch, handin will expect to find your assignment in the ~/course/assignment directory. Handin will recurse any directories at this loca- tion. Note, if you do use the -f switch, the zipfile you provide must contain your entire assignment, and must not have been created using absolute pathnames. The zipfile functionality was not intended for the average student to use. It is intended to be used by other user interfaces to handin. Switches must be specified separately, and with whitespace. ie. -o -p not -op If the -c switch is set, all other (valid) switches are ignored. Suppose you want to hand in assignment 2 for CPSC 417. Your instructor informs you that the course account is cs417 and the assignment is assign2. In order for handin cs417 assign2 to work, you must make sure all the files you need to handin are under your home directory in ~/cs417/assign2. The latest version of handin will allow you to overwrite your old assignment as many times as you wish up until a specified due date. However, this relies on the TA/Instructor setting up a course .config file. If there is no config file, or there is a problem with it, you will only be allowed to handin your assignment once. SunOS 5.8 Last change: 27 January 2005 1 SunOS 5.8 Last change: 27 January 2005 2 User Commands HANDIN(1) TA / INSTRUCTOR INFORMATION .config file Course configuration is contained in the /cs/csbox/course/.config file. If .config exists and is readable, then students can only handin those assignments defined in .config. Lines staring with 'a' are assignment lines. Following the a, there should be the assignment name, then due date and time. If there is only an assignment name, or handin has a problem with the date/time, then the student will only be allowed to handin the assignment once. Also, if there is no .config, then handin reverts to what it used to be; namely, it will let a student handin an assign- ment of any name at most one time(s). You may NOT omit any of the numerical fields when defining the due date. Sample: # Test course config file # assn year.mn.dy hr:mi:sc a assn1 1998.05.29 16:50:30 a assn2 1998.01.28 13:45:33 a assn3 1998.06.30 00:00:00 # This is a comment line a assn4 1998.11.30 01:03:10 # Here is an assignment with no date/time. a assn5 Note: It is important to archive/move previous assignments before you rewrite the .config file for the next semester. Otherwise students from previous terms may be able to erase their assignments from csbox. Further Note: Be careful when changing a due date after the current due date is past. You must move assignments into/out of the LATE directory to correspond with the new date, or handin is likely to break. Course Script After handin has successfully copied a student's work, it runs a script which you are allowed to customize. This script is run from the // directory. ~/bin/handin //// Late Assignment Late assignments are collected under the directory ////LATE/ to avoid confusion. SunOS 5.8 Last change: 27 January 2005 3 User Commands HANDIN(1) AUTHORS Anthony Winstanley winstan@cs.ubc.ca Carlin Phillips chao@cs.ubc.ca Peter Phillips Dept. of Computer Science University of British Columbia SunOS 5.8 Last change: 27 January 2005 4