turnin(1)                 User Commands                 turnin(1)



     turnin - CS turnin program

SYNOPSIS
     turnin assignment@class file-and-directory-list


DESCRIPTION
     turnin is the standard command available for turning in Com-
     puter Science assignments.

STUDENT USAGE
     Simply type

             turnin assignmnt@class files-and-directories

     If   you   see   a   message   _Command_not_found_,   type
     /usr/local/bin/turnin instead of turnin.

     assignment  and class are the assignment name (e.g. askhsh1,
     pgm1, lab3, hw2, etc) and turnin account name  (e.g.  cs413,
     instruct).  file-and-directory-list is the list of files and
     directories that you wish to turnin.

     The turnin program refuses to turn in binary files, and  has
     other   miscellaneous  constraints  which  it  announces  as
     needed.

     You can make multiple turnins of each assignment  (up  to  a
     limit),  but  you  should follow the specific rules given by
     your instructor.


     To have your students use this version of turnin,  you  must
     create  a  subdirectory TURNIN in the home directory of your
     class account.  For each assignment  create  a  subdirectory
     TURNIN/assignment for each assignment name you give out.
     Assignment names are arbitrary, but your  students  need  to
     know the names you give to each assignment.

     There  are  several  files  that  you  can create within the
     assignment directory to control aspects of  turnin's  opera-
     tion:

     README  is  printed out for the user at the beginning of the
     turnin.  It can be used to provide special  instructions  or
     reminders to the user.

     LOCK will disable turnins of the particular assignment.

     LOGFILE keeps tracks of each turnin.

     LIMITS contains lines which specify keywords and values:

          maxfiles 100

          maxkbytes 1000

          maxturnins 10

          binary 0

     that will set limits on how many files, how large the turnin
     can be, how many turnins can be made of each assignment  and
     a  boolean  value to denote whether binary files are allowed
     to be turned in.  (The  default  values  are  shown  above).
     Note  that  if  you  allow binary files, you should only run
     them when you are logged in as the class account,  and  even
     then  only  if  there  is no confidential information in the
     account.

     Occasionally you may find files beginning with  '#'.   These
     represent failed turnins.

     Turned-in assignments are named _user.tar.Z_ where user is the
     name of the user executing  turnin.   Previous  versions  of
     each turnin are named _user-N.tar.Z_ where increasing N repre-
     sents more recent versions.

     To access a turnin of _pgm1_ by _user_,

          cd TURNIN/pgm1

          mkdir tmp

          cd tmp

          zcat ../user.tar.Z | tar xvBf -

     which will unpack the students turned-in assignment.


RETURN VALUES
     turnin generates lots of error messages.

FILES
     ~class/TURNIN/assignment/