X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=README;h=d0eb50922990e7e4dc452820655cde92d2373187;hb=2004088404325c5b238860c67c7ee4e1babed7e3;hp=f614d2958eeebb854647fac1a7b46c66fd0843c3;hpb=0f5aaa6fd6a30a58f7aa8cd83507fd803d59128a;p=moe.git diff --git a/README b/README index f614d29..d0eb509 100644 --- a/README +++ b/README @@ -1,53 +1,30 @@ -How to set up the evaluator: ----------------------------- +================================================================================ -Edit `config', especially MO_ROOT, EVAL_USER, EVAL_GROUP, TEST_USERS, CT_UID_MIN and CT_UID_MAX. + Moe Contest Environment @VERSION@ -Create $MO_ROOT (here we assume it's /aux/mo) + (c) 2001--2012 Martin Mares + and other contributors -Create the evaluation users (outside $CT_UID_MIN .. $CT_UID_MAX): +================================================================================ - mo-eval:x:65000:65000:MO Evaluator:/aux/mo/eval/mo-eval:/bin/bash - mo-test1:x:65001:65000:MO Tester 1:/aux/mo/eval/mo-test1:/bin/bash - mo-test2:x:65002:65000:MO Tester 2:/aux/mo/eval/mo-test2:/bin/bash -Create the evaluation group: +This is the programming contest environment used by the Czech Programming Olympiad +and some other competitions. - mo-eval:x:65000: +You will find a brief documentation in the doc/ directory inside the package (start +with doc/index.html) or on-line at http://www.ucw.cz/moe/. -Create the contestant users (inside $CT_UID_MIN .. $CT_UID_MAX; as many as you wish; -the names don't matter): +The whole package can be distributed and used under the terms of the GNU General +Public License version 2. - mo00:x:65100:65100:MO Contestant 00:/aux/mo/users/mo00/mo00:/bin/bash - ... - mo99:x:65199:65199:MO Contestant 99:/aux/mo/users/mo99/mo99:/bin/bash +If you have any suggestions, bug reports or improvements you would like to share +with others, please send them to mj@ucw.cz. -... and their groups (preferably with the same ID's): +** How to build Moe ** - mo00:x:65100: - ... - mo99:x:65199: +First of all, edit default.cfg to choose which components should be built. -... and their passwords ... +Then run "./configure" and "make". This will place all compiled binaries in "run/". -Run bin/mo-install to create the infrastructure. - -Run bin/mo-create-contestants to create contestants' home directories, -files from template/* will be copied there automatically. - -If users are logging in remotely, set quotas and other limits for them. -Don't use limits.conf for that since with sshd the limits would affect _root_ -(probably bug in interface between sshd and PAM). Just add to /etc/profile: - - if [ $UID -ge 65100 -a $UID -le 65199 ] ; then - ulimit -Sc 8192 # core file size - ulimit -SHu 32 # processes - ulimit -SHn 256 # max open files - ulimit -SHv 262144 # max virtual memory - fi - - -Various notes: -~~~~~~~~~~~~~~ -- if you want to assign partial score to testcases, just make the OUTPUT_CHECK - program generate a file $TDIR/$TEST.pts containing the score. +By default, documentation is built, which requires AsciiDoc to be present. +You can skip documentation by "./configure -CONFIG_DOC".