← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to ivle/makeuser.py

  • Committer: Matt Giuca
  • Date: 2010-07-21 04:18:28 UTC
  • Revision ID: matt.giuca@gmail.com-20100721041828-q1c2c3h2kjj3hqcd
Updated Subversion help, now that we no longer include the username in the Subversion URL. Instructions now include how to use --username.

Show diffs side-by-side

added added

removed removed

Lines of Context:
ivle/makeuser.py
1
1
# IVLE - Informatics Virtual Learning Environment
2
 
# Copyright (C) 2007-2008 The University of Melbourne
 
2
# Copyright (C) 2007-2009 The University of Melbourne
3
3
#
4
4
# This program is free software; you can redistribute it and/or modify
5
5
# it under the terms of the GNU General Public License as published by
15
15
# along with this program; if not, write to the Free Software
16
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
17
17
 
18
 
# Module: MakeUser
19
 
# Author: Matt Giuca
20
 
# Date:   1/2/2008
21
 
 
22
 
# Allows creation of users. This sets up the following:
23
 
# * User's jail and home directory within the jail.
24
 
# * Subversion repository (TODO)
25
 
# * Check out Subversion workspace into jail (TODO)
26
 
# * Database details for user
27
 
# * Unix user account
28
 
 
29
 
# TODO: Sanitize login name and other fields.
30
 
# Users must not be called "temp" or "template".
31
 
 
32
 
# TODO: When creating a new home directory, chown it to its owner
33
 
 
34
 
# TODO: In chown_to_webserver:
35
 
# Do not call os.system("chown www-data") - use Python lib
36
 
# and use the web server uid given in conf. (Several places).
37
 
 
38
 
import md5
 
18
"""User and group filesystem management helpers."""
 
19
 
 
20
import hashlib
39
21
import os
40
22
import stat
41
23
import shutil
42
24
import time
43
25
import uuid
44
26
import warnings
45
 
import filecmp
46
27
import logging
47
 
import ivle.conf
48
 
import ivle.db
49
 
import ivle.pulldown_subj
50
 
 
51
 
from ivle.database import ProjectGroup
 
28
import subprocess
 
29
 
 
30
from storm.expr import Select, Max
 
31
 
 
32
import ivle.config
 
33
from ivle.database import (User, ProjectGroup, Assessed, ProjectSubmission,
 
34
        Project, ProjectSet, Offering, Enrolment, Subject, Semester)
52
35
 
53
36
def chown_to_webserver(filename):
54
 
    """
55
 
    Chowns a file so the web server user owns it.
56
 
    (This is useful in setting up Subversion conf files).
 
37
    """chown a directory and its contents to the web server.
 
38
 
 
39
    Recursively chowns a file or directory so the web server user owns it.
57
40
    Assumes root.
58
41
    """
59
 
    try:
60
 
        os.system("chown -R www-data:www-data %s" % filename)
61
 
    except:
62
 
        pass
 
42
    subprocess.call(['chown', '-R', 'www-data:www-data', filename])
63
43
 
64
44
def make_svn_repo(path, throw_on_error=True):
65
 
    """Create a Subversion repository at the given path.
66
 
    """
 
45
    """Create a Subversion repository at the given path."""
67
46
    try:
68
 
        res = os.system("svnadmin create '%s'" % path)
 
47
        res = subprocess.call(['svnadmin', 'create', path])
69
48
        if res != 0 and throw_on_error:
70
49
            raise Exception("Cannot create repository: %s" % path)
71
50
    except Exception, exc:
75
54
 
76
55
    chown_to_webserver(path)
77
56
 
78
 
def rebuild_svn_config(store):
 
57
def rebuild_svn_config(store, config):
79
58
    """Build the complete SVN configuration file.
 
59
 
 
60
    @param config: An ivle.config.Config object.
80
61
    """
81
 
    users = store.find(ivle.database.User)
82
 
    groups = {}
83
 
    for u in users:
84
 
        role = str(u.role)
85
 
        if role not in groups:
86
 
            groups[role] = []
87
 
        groups[role].append(u.login)
88
 
    f = open(ivle.conf.svn_conf + ".new", "w")
89
 
    f.write("# IVLE SVN Repositories Configuration\n")
90
 
    f.write("# Auto-generated on %s\n" % time.asctime())
91
 
    f.write("\n")
92
 
    f.write("[groups]\n")
93
 
    for (g,ls) in groups.iteritems():
94
 
        f.write("%s = %s\n" % (g, ",".join(ls)))
95
 
    f.write("\n")
96
 
    for u in users:
97
 
        f.write("[%s:/]\n" % u.login)
98
 
        f.write("%s = rw\n" % u.login)
99
 
        #f.write("@tutor = r\n")
100
 
        #f.write("@lecturer = rw\n")
101
 
        #f.write("@admin = rw\n")
102
 
        f.write("\n")
 
62
    users = store.find(User)
 
63
    conf_name = config['paths']['svn']['conf']
 
64
    temp_name = conf_name + ".new"
 
65
    f = open(temp_name, "w")
 
66
    f.write("""\
 
67
# IVLE SVN repository authorisation configuration
 
68
# Generated: %(time)s
 
69
""" % {'time': time.asctime()})
 
70
 
 
71
    for u in users:
 
72
        f.write("""
 
73
[%(login)s:/]
 
74
%(login)s = rw
 
75
""" % {'login': u.login.encode('utf-8')})
 
76
 
 
77
    # Now we need to grant offering tutors and lecturers access to the latest
 
78
    # submissions in their offerings. There are much prettier ways to do this,
 
79
    # but a lot of browser requests call this function, so it needs to be
 
80
    # fast. We can grab all of the paths needing authorisation directives with
 
81
    # a single query, and we cache the list of viewers for each offering.
 
82
    offering_viewers_cache = {}
 
83
    for (login, psid, pspath, offeringid) in store.find(
 
84
        (User.login, ProjectSubmission.id, ProjectSubmission.path,
 
85
         Offering.id),
 
86
            Assessed.id == ProjectSubmission.assessed_id,
 
87
            User.id == Assessed.user_id,
 
88
            Project.id == Assessed.project_id,
 
89
            ProjectSet.id == Project.project_set_id,
 
90
            Offering.id == ProjectSet.offering_id,
 
91
            ProjectSubmission.date_submitted == Select(
 
92
                    Max(ProjectSubmission.date_submitted),
 
93
                    ProjectSubmission.assessed_id == Assessed.id,
 
94
                    tables=ProjectSubmission
 
95
            )
 
96
        ):
 
97
 
 
98
        # Do we already have the list of logins authorised for this offering
 
99
        # cached? If not, get it.
 
100
        if offeringid not in offering_viewers_cache:
 
101
            offering_viewers_cache[offeringid] = list(store.find(
 
102
                    User.login,
 
103
                    User.id == Enrolment.user_id,
 
104
                    Enrolment.offering_id == offeringid,
 
105
                    Enrolment.role.is_in((u'tutor', u'lecturer')),
 
106
                    Enrolment.active == True,
 
107
                )
 
108
            )
 
109
 
 
110
        f.write("""
 
111
# Submission %(id)d
 
112
[%(login)s:%(path)s]
 
113
""" % {'login': login.encode('utf-8'), 'id': psid,
 
114
       'path': pspath.encode('utf-8')})
 
115
 
 
116
        for viewer_login in offering_viewers_cache[offeringid]:
 
117
            # We don't want to override the owner's write privilege,
 
118
            # so we don't add them to the read-only ACL.
 
119
            if login != viewer_login:
 
120
                f.write("%s = r\n" % viewer_login.encode('utf-8'))
 
121
 
103
122
    f.close()
104
 
    os.rename(ivle.conf.svn_conf + ".new", ivle.conf.svn_conf)
105
 
    chown_to_webserver(ivle.conf.svn_conf)
 
123
    os.rename(temp_name, conf_name)
 
124
    chown_to_webserver(conf_name)
106
125
 
107
 
def rebuild_svn_group_config(store):
 
126
def rebuild_svn_group_config(store, config):
108
127
    """Build the complete SVN configuration file for groups
 
128
 
 
129
    @param config: An ivle.config.Config object.
109
130
    """
110
 
    f = open(ivle.conf.svn_group_conf + ".new", "w")
111
 
    f.write("# IVLE SVN Group Repositories Configuration\n")
112
 
    f.write("# Auto-generated on %s\n" % time.asctime())
113
 
    f.write("\n")
 
131
    conf_name = config['paths']['svn']['group_conf']
 
132
    temp_name = conf_name + ".new"
 
133
    f = open(temp_name, "w")
 
134
 
 
135
    f.write("""\
 
136
# IVLE SVN group repository authorisation configuration
 
137
# Generated: %(time)s
 
138
 
 
139
""" % {'time': time.asctime()})
 
140
 
 
141
    group_members_cache = {}
114
142
    for group in store.find(ProjectGroup):
115
143
        offering = group.project_set.offering
116
144
        reponame = "_".join([offering.subject.short_name,
117
145
                             offering.semester.year,
118
146
                             offering.semester.semester,
119
147
                             group.name])
120
 
        f.write("[%s:/]\n"%reponame)
 
148
 
 
149
        f.write("[%s:/]\n" % reponame.encode('utf-8'))
 
150
        if group.id not in group_members_cache:
 
151
            group_members_cache[group.id] = set()
121
152
        for user in group.members:
122
 
            f.write("%s = rw\n" % user.login)
 
153
            group_members_cache[group.id].add(user.login)
 
154
            f.write("%s = rw\n" % user.login.encode('utf-8'))
123
155
        f.write("\n")
 
156
 
 
157
    # Now we need to grant offering tutors and lecturers access to the latest
 
158
    # submissions in their offerings. There are much prettier ways to do this,
 
159
    # but a lot of browser requests call this function, so it needs to be
 
160
    # fast. We can grab all of the paths needing authorisation directives with
 
161
    # a single query, and we cache the list of viewers for each offering.
 
162
    offering_viewers_cache = {}
 
163
    for (ssn, year, sem, name, psid, pspath, gid, offeringid) in store.find(
 
164
        (Subject.short_name, Semester.year, Semester.semester,
 
165
         ProjectGroup.name, ProjectSubmission.id, ProjectSubmission.path,
 
166
         ProjectGroup.id, Offering.id),
 
167
            Assessed.id == ProjectSubmission.assessed_id,
 
168
            ProjectGroup.id == Assessed.project_group_id,
 
169
            Project.id == Assessed.project_id,
 
170
            ProjectSet.id == Project.project_set_id,
 
171
            Offering.id == ProjectSet.offering_id,
 
172
            Subject.id == Offering.subject_id,
 
173
            Semester.id == Offering.semester_id,
 
174
            ProjectSubmission.date_submitted == Select(
 
175
                    Max(ProjectSubmission.date_submitted),
 
176
                    ProjectSubmission.assessed_id == Assessed.id,
 
177
                    tables=ProjectSubmission
 
178
            )
 
179
        ):
 
180
 
 
181
        reponame = "_".join([ssn, year, sem, name])
 
182
 
 
183
        # Do we already have the list of logins authorised for this offering
 
184
        # cached? If not, get it.
 
185
        if offeringid not in offering_viewers_cache:
 
186
            offering_viewers_cache[offeringid] = list(store.find(
 
187
                    User.login,
 
188
                    User.id == Enrolment.user_id,
 
189
                    Enrolment.offering_id == offeringid,
 
190
                    Enrolment.role.is_in((u'tutor', u'lecturer')),
 
191
                    Enrolment.active == True,
 
192
                )
 
193
            )
 
194
 
 
195
        f.write("""
 
196
# Submission %(id)d
 
197
[%(repo)s:%(path)s]
 
198
""" % {'repo': reponame.encode('utf-8'), 'id': psid,
 
199
       'path': pspath.encode('utf-8')})
 
200
 
 
201
        for viewer_login in offering_viewers_cache[offeringid]:
 
202
            # Skip existing group members, or they can't write to it any more.
 
203
            if viewer_login not in group_members_cache[gid]:
 
204
                f.write("%s = r\n" % viewer_login)
 
205
 
124
206
    f.close()
125
 
    os.rename(ivle.conf.svn_group_conf + ".new", ivle.conf.svn_group_conf)
126
 
    chown_to_webserver(ivle.conf.svn_group_conf)
127
 
 
128
 
def make_svn_auth(store, login, throw_on_error=True):
129
 
    """Setup svn authentication for the given user.
130
 
       Uses the given DB store object. Does not commit to the db.
 
207
    os.rename(temp_name, conf_name)
 
208
    chown_to_webserver(conf_name)
 
209
 
 
210
def make_svn_auth(store, login, config, throw_on_error=True):
 
211
    """Create a Subversion password for a user.
 
212
 
 
213
    Generates a new random Subversion password, and assigns it to the user.
 
214
    The password is added to Apache's Subversion authentication file.
131
215
    """
132
 
    passwd = md5.new(uuid.uuid4().bytes).digest().encode('hex')
133
 
    if os.path.exists(ivle.conf.svn_auth_ivle):
 
216
    # filename is, eg, /var/lib/ivle/svn/ivle.auth
 
217
    filename = config['paths']['svn']['auth_ivle']
 
218
    if os.path.exists(filename):
134
219
        create = ""
135
220
    else:
136
221
        create = "c"
137
222
 
138
 
    user = ivle.database.User.get_by_login(store, login)
139
 
    user.svn_pass = unicode(passwd)
140
 
 
141
 
    res = os.system("htpasswd -%smb %s %s %s" % (create,
142
 
                                              ivle.conf.svn_auth_ivle,
143
 
                                              login, passwd))
 
223
    user = User.get_by_login(store, login)
 
224
 
 
225
    if user.svn_pass is None:
 
226
        passwd = hashlib.md5(uuid.uuid4().bytes).hexdigest()
 
227
        user.svn_pass = unicode(passwd)
 
228
 
 
229
    res = subprocess.call(['htpasswd', '-%smb' % create,
 
230
                           filename, login, user.svn_pass])
144
231
    if res != 0 and throw_on_error:
145
232
        raise Exception("Unable to create ivle-auth for %s" % login)
146
233
 
147
234
    # Make sure the file is owned by the web server
148
235
    if create == "c":
149
 
        chown_to_webserver(ivle.conf.svn_auth_ivle)
150
 
 
151
 
    return passwd
152
 
 
153
 
def generate_manifest(basedir, targetdir, parent=''):
154
 
    """ From a basedir and a targetdir work out which files are missing or out 
155
 
    of date and need to be added/updated and which files are redundant and need 
156
 
    to be removed.
157
 
    
158
 
    parent: This is used for the recursive call to track the relative paths 
159
 
    that we have decended.
160
 
    """
161
 
    
162
 
    cmp = filecmp.dircmp(basedir, targetdir)
163
 
 
164
 
    # Add all new files and files that have changed
165
 
    to_add = [os.path.join(parent,x) for x in (cmp.left_only + cmp.diff_files)]
166
 
 
167
 
    # Remove files that are redundant
168
 
    to_remove = [os.path.join(parent,x) for x in cmp.right_only]
169
 
    
170
 
    # Recurse
171
 
    for d in cmp.common_dirs:
172
 
        newbasedir = os.path.join(basedir, d)
173
 
        newtargetdir = os.path.join(targetdir, d)
174
 
        newparent = os.path.join(parent, d)
175
 
        (sadd,sremove) = generate_manifest(newbasedir, newtargetdir, newparent)
176
 
        to_add += sadd
177
 
        to_remove += sremove
178
 
 
179
 
    return (to_add, to_remove)
180
 
 
181
 
 
182
 
def make_jail(user, force=True):
183
 
    """Creates a new user's jail space, in the jail directory as configured in
184
 
    conf.py.
185
 
 
186
 
    This only creates things within /home - everything else is expected to be
187
 
    part of another UnionFS branch.
 
236
        chown_to_webserver(filename)
 
237
 
 
238
    return user.svn_pass
 
239
 
 
240
def make_jail(user, config, force=True):
 
241
    """Create or update a user's jail.
 
242
 
 
243
    Only the user-specific parts of the jail are created here - everything
 
244
    else is expected to be part of another aufs branch.
188
245
 
189
246
    Returns the path to the user's home directory.
190
247
 
191
248
    Chowns the user's directory within the jail to the given UID.
192
249
 
193
 
    force: If false, exception if jail already exists for this user.
194
 
    If true (default), overwrites it, but preserves home directory.
 
250
    @param force: If False, raise an exception if the user already has a jail.
 
251
                  If True (default), rebuild the jail preserving /home.
195
252
    """
196
253
    # MUST run as root or some of this may fail
197
254
    if os.getuid() != 0:
198
255
        raise Exception("Must run make_jail as root")
199
256
    
200
257
    # tempdir is for putting backup homes in
201
 
    tempdir = os.path.join(ivle.conf.jail_base, '__temp__')
 
258
    jail_src_base = config['paths']['jails']['src']
 
259
    tempdir = os.path.join(jail_src_base, '__temp__')
202
260
    if not os.path.exists(tempdir):
203
261
        os.makedirs(tempdir)
204
262
    elif not os.path.isdir(tempdir):
205
263
        os.unlink(tempdir)
206
264
        os.mkdir(tempdir)
207
 
    userdir = os.path.join(ivle.conf.jail_src_base, user.login)
 
265
    userdir = os.path.join(jail_src_base, user.login)
208
266
    homedir = os.path.join(userdir, 'home')
 
267
    tmpdir = os.path.join(userdir, 'tmp')
209
268
    userhomedir = os.path.join(homedir, user.login)   # Return value
210
269
 
211
270
    if os.path.exists(userdir):
214
273
        # User jail already exists. Blow it away but preserve their home
215
274
        # directory. It should be all that is there anyway, but you never
216
275
        # know!
217
 
        # Ignore warnings about the use of tmpnam
 
276
        # Ignore warnings about the use of tempnam
218
277
        warnings.simplefilter('ignore')
219
278
        homebackup = os.tempnam(tempdir)
220
279
        warnings.resetwarnings()
221
 
        # Note: shutil.move does not behave like "mv" - it does not put a file
222
 
        # into a directory if it already exists, just fails. Therefore it is
223
 
        # not susceptible to tmpnam symlink attack.
224
 
        shutil.move(homedir, homebackup)
 
280
        # Back up the /home directory, delete the entire jail, recreate the
 
281
        # jail directory tree, then copy the /home back
 
282
        # NOTE that shutil.move changed in Python 2.6, it now moves a
 
283
        # directory INTO the target (like `mv`), which it didn't use to do.
 
284
        # This code works regardless.
 
285
        shutil.move(userhomedir, homebackup)
225
286
        shutil.rmtree(userdir)
226
287
        os.makedirs(homedir)
227
 
        shutil.move(homebackup, homedir)
 
288
        shutil.move(homebackup, userhomedir)
228
289
        # Change the ownership of all the files to the right unixid
229
290
        logging.debug("chown %s's home directory files to uid %d"
230
291
            %(user.login, user.unixid))
231
 
        os.chown(userhomedir, user.unixid, user.unixid)
232
 
        for root, dirs, files in os.walk(userhomedir):
233
 
            for fsobj in dirs + files:
234
 
                os.chown(os.path.join(root, fsobj), user.unixid, user.unixid)
 
292
        os.spawnvp(os.P_WAIT, 'chown', ['chown', '-R', '%d:%d' % (user.unixid,
 
293
                                        user.unixid), userhomedir])
235
294
    else:
236
295
        # No user jail exists
237
296
        # Set up the user's home directory
241
300
        # Chmod to rwxr-xr-x (755)
242
301
        os.chmod(userhomedir, 0755)
243
302
 
244
 
    make_conf_py(user.login, userdir, ivle.conf.jail_system, user.svn_pass)
245
 
    make_etc_passwd(user.login, userdir, ivle.conf.jail_system, user.unixid)
 
303
    make_ivle_conf(user.login, userdir, user.svn_pass, config)
 
304
    make_etc_passwd(user.login, userdir, config['paths']['jails']['template'],
 
305
                    user.unixid)
 
306
    os.makedirs(tmpdir)
 
307
    os.chmod(tmpdir, 01777)
246
308
 
247
309
    return userhomedir
248
310
 
249
 
def make_conf_py(username, user_jail_dir, staging_dir, svn_pass):
250
 
    """
 
311
def make_ivle_conf(username, user_jail_dir, svn_pass, sys_config):
 
312
    """Generate an ivle.conf for a user's jail.
 
313
 
251
314
    Creates (overwriting any existing file, and creating directories) a
252
 
    file ${python_site_packages}/ivle/conf/conf.py in a given user's jail.
253
 
    username: Username.
254
 
    user_jail_dir: User's jail dir, ie. ivle.conf.jail_base + username
255
 
    staging_dir: The dir with the staging copy of the jail. (With the
256
 
        template conf.py file).
257
 
    svn_pass: As with make_jail. User's SVN password, but if not supplied,
258
 
        will look up in the DB.
 
315
    file /etc/ivle/ivle.conf in a given user's jail.
 
316
 
 
317
    @param username: Username.
 
318
    @param user_jail_dir: User's jail dir, ie. ['jails']['src'] + username
 
319
    @param svn_pass: User's SVN password.
 
320
    @param sys_config: An ivle.config.Config object (the system-wide config).
259
321
    """
260
 
    template_conf_path = os.path.join(staging_dir,
261
 
            ivle.conf.python_site_packages[1:], "ivle/conf/conf.py")
262
 
    conf_path = os.path.join(user_jail_dir,
263
 
            ivle.conf.python_site_packages[1:], "ivle/conf/conf.py")
264
 
    os.makedirs(os.path.dirname(conf_path))
265
 
 
266
 
    # Read the contents of the template conf file
267
 
    try:
268
 
        template_conf_file = open(template_conf_path, "r")
269
 
        template_conf_data = template_conf_file.read()
270
 
        template_conf_file.close()
271
 
    except:
272
 
        # Couldn't open template conf.py for some reason
273
 
        # Just treat it as empty file
274
 
        template_conf_data = ("# Warning: Problem building config script.\n"
275
 
                              "# Could not find template conf.py file.\n")
276
 
 
277
 
    conf_file = open(conf_path, "w")
278
 
    conf_file.write(template_conf_data)
279
 
    conf_file.write("\n# The login name for the owner of the jail\n")
280
 
    conf_file.write("login = %s\n" % repr(username))
281
 
    conf_file.write("\n")
282
 
    conf_file.write("# The subversion-only password for the owner of "
283
 
        "the jail\n")
284
 
    conf_file.write("svn_pass = %s\n" % repr(svn_pass))
285
 
    conf_file.close()
 
322
    conf_path = os.path.join(user_jail_dir, "home/.ivle.conf")
 
323
    if not os.path.exists(os.path.dirname(conf_path)):
 
324
        os.makedirs(os.path.dirname(conf_path))
 
325
 
 
326
    # In the "in-jail" version of conf, we don't need MOST of the details
 
327
    # (it would be a security risk to have them here).
 
328
    # So we just write root_dir.
 
329
    conf_obj = ivle.config.Config(blank=True)
 
330
    conf_obj.filename = conf_path
 
331
    conf_obj['urls'] = {}
 
332
    conf_obj['urls']['root'] = sys_config['urls']['root']
 
333
    conf_obj['urls']['public_host'] = sys_config['urls']['public_host']
 
334
    conf_obj['urls']['svn_addr'] = sys_config['urls']['svn_addr']
 
335
    conf_obj['user_info'] = {}
 
336
    conf_obj['user_info']['login'] = username
 
337
    conf_obj['user_info']['svn_pass'] = svn_pass
 
338
    conf_obj.write()
286
339
 
287
340
    # Make this file world-readable
288
341
    # (chmod 644 conf_path)
290
343
                        | stat.S_IROTH)
291
344
 
292
345
def make_etc_passwd(username, user_jail_dir, template_dir, unixid):
293
 
    """
 
346
    """Create a passwd file for a user's jail.
 
347
 
294
348
    Creates /etc/passwd in the given user's jail. This will be identical to
295
349
    that in the template jail, except for the added entry for this user.
296
350
    """
297
 
    template_passwd_path = os.path.join(template_dir, "etc/passwd")
298
 
    passwd_path = os.path.join(user_jail_dir, "etc/passwd")
 
351
    template_passwd_path = os.path.join(template_dir, "home/.passwd")
 
352
    passwd_path = os.path.join(user_jail_dir, "home/.passwd")
299
353
    passwd_dir = os.path.dirname(passwd_path)
300
354
    if not os.path.exists(passwd_dir):
301
355
        os.makedirs(passwd_dir)
304
358
    passwd_file.write('%s:x:%d:%d::/home/%s:/bin/bash'
305
359
                      % (username, unixid, unixid, username))
306
360
    passwd_file.close()
307
 
 
308
 
def make_user_db(throw_on_error = True, **kwargs):
309
 
    """Creates a user's entry in the database, filling in all the fields.
310
 
    All arguments must be keyword args. They are the fields in the table.
311
 
    However, instead of supplying a "passhash", you must supply a
312
 
    "password" argument, which will be hashed internally.
313
 
    Also do not supply a state. All users are created in the "no_agreement"
314
 
    state.
315
 
    Also pulls the user's subjects using the configured subject pulldown
316
 
    module, and adds enrolments to the DB.
317
 
    Throws an exception if the user already exists.
318
 
    """
319
 
    dbconn = ivle.db.DB()
320
 
    dbconn.create_user(**kwargs)
321
 
    dbconn.close()
322
 
 
323
 
    # Pulldown subjects and add enrolments
324
 
    ivle.pulldown_subj.enrol_user(kwargs['login'])
325
 
 
326
 
def mount_jail(login):
327
 
    # This is where we'll mount to...
328
 
    destdir = os.path.join(ivle.conf.jail_base, login)
329
 
    # ... and this is where we'll get the user bits.
330
 
    srcdir = os.path.join(ivle.conf.jail_src_base, login)
331
 
    try:
332
 
        if not os.path.exists(destdir):
333
 
            os.mkdir(destdir)
334
 
        if os.system('/bin/mount -t aufs -o dirs=%s:%s=ro none %s'
335
 
                     % (srcdir, ivle.conf.jail_system, destdir)) == 0:
336
 
            logging.info("mounted user %s's jail." % login)
337
 
        else:
338
 
            logging.error("failed to mount user %s's jail!" % login)
339
 
    except Exception, message:
340
 
        logging.warning(str(message))