23
23
# This is a command-line application, for use by the administrator.
24
# This program is a frontend for the modules in the setup packages that
25
# configure, build and install IVLE in three separate steps.
24
# This program configures, builds and installs IVLE in three separate steps.
26
25
# It is called with at least one argument, which specifies which operation to
28
# setup.py listmake (for developer use only)
29
# Recurses through the source tree and builds a list of all files which should
30
# be copied upon installation. This should be run by the developer before
31
# cutting a distribution, and the listfile it generates should be included in
32
# the distribution, avoiding the administrator having to run it.
34
# setup.py config [args]
35
# Configures IVLE with machine-specific details, most notably, various paths.
36
# Either prompts the administrator for these details or accepts them as
38
# Creates www/conf/conf.py and trampoline/conf.h.
41
# Compiles all files and sets up a jail template in the source directory.
43
# Compiles (GCC) trampoline/trampoline.c to trampoline/trampoline.
45
# Creates standard subdirs inside the jail, eg bin, opt, home, tmp.
46
# Copies console/ to a location within the jail.
47
# Copies OS programs and files to corresponding locations within the jail
48
# (eg. python and Python libs, ld.so, etc).
49
# Generates .pyc files for all the IVLE .py files.
51
# setup.py install [--nojail] [--dry|n]
53
# Create target install directory ($target).
55
# Copy trampoline/trampoline to $target/bin.
56
# chown and chmod the installed trampoline.
57
# Copy www/ to $target.
58
# Copy jail/ to jails template directory (unless --nojail specified).
30
import setup.configure
71
# Import modules from the website is tricky since they're in the www
73
sys.path.append(os.path.join(os.getcwd(), 'www'))
75
import common.makeuser
77
# Determine which Python version (2.4 or 2.5, for example) we are running,
78
# and use that as the filename to the Python directory.
79
# Just get the first 3 characters of sys.version.
80
PYTHON_VERSION = sys.version[0:3]
82
# Operating system files to copy over into the jail.
83
# These will be copied from the given place on the OS file system into the
84
# same place within the jail.
87
'/lib/tls/i686/cmov/libc.so.6',
88
'/lib/tls/i686/cmov/libdl.so.2',
89
'/lib/tls/i686/cmov/libm.so.6',
90
'/lib/tls/i686/cmov/libpthread.so.0',
91
'/lib/tls/i686/cmov/libutil.so.1',
94
# These 2 files do not exist in Ubuntu
95
#'/etc/ld.so.preload',
96
#'/etc/ld.so.nohwcap',
102
'/usr/bin/python%s' % PYTHON_VERSION,
103
# Needed by matplotlib
104
'/usr/lib/i686/cmov/libssl.so.0.9.8',
105
'/usr/lib/i686/cmov/libcrypto.so.0.9.8',
106
'/lib/tls/i686/cmov/libnsl.so.1',
107
'/usr/lib/libz.so.1',
108
'/usr/lib/atlas/liblapack.so.3',
109
'/usr/lib/atlas/libblas.so.3',
110
'/usr/lib/libg2c.so.0',
111
'/usr/lib/libstdc++.so.6',
112
'/usr/lib/libfreetype.so.6',
113
'/usr/lib/libpng12.so.0',
114
'/usr/lib/libBLT.2.4.so.8.4',
115
'/usr/lib/libtk8.4.so.0',
116
'/usr/lib/libtcl8.4.so.0',
117
'/usr/lib/tcl8.4/init.tcl',
118
'/usr/lib/libX11.so.6',
119
'/usr/lib/libXau.so.6',
120
'/usr/lib/libXdmcp.so.6',
121
'/lib/libgcc_s.so.1',
124
# Symlinks to make within the jail. Src mapped to dst.
126
'python%s' % PYTHON_VERSION: 'jail/usr/bin/python',
128
# Trees to copy. Src mapped to dst (these will be passed to action_copytree).
130
'/usr/lib/python%s' % PYTHON_VERSION:
131
'jail/usr/lib/python%s' % PYTHON_VERSION,
132
'/usr/share/matplotlib': 'jail/usr/share/matplotlib',
133
'/etc/ld.so.conf.d': 'jail/etc/ld.so.conf.d',
136
# Try importing existing conf, but if we can't just set up defaults
137
# The reason for this is that these settings are used by other phases
138
# of setup besides conf, so we need to know them.
139
# Also this allows you to hit Return to accept the existing value.
141
confmodule = __import__("www/conf/conf")
143
root_dir = confmodule.root_dir
147
ivle_install_dir = confmodule.ivle_install_dir
149
ivle_install_dir = "/opt/ivle"
151
public_host = confmodule.public_host
153
public_host = "public.localhost"
155
jail_base = confmodule.jail_base
157
jail_base = "/home/informatics/jails"
159
subjects_base = confmodule.subjects_base
161
subjects_base = "/home/informatics/subjects"
163
# Just set reasonable defaults
165
ivle_install_dir = "/opt/ivle"
166
public_host = "public.localhost"
167
jail_base = "/home/informatics/jails"
168
subjects_base = "/home/informatics/subjects"
172
# Try importing install_list, but don't fail if we can't, because listmake can
173
# function without it.
179
# Mime types which will automatically be placed in the list by listmake.
180
# Note that listmake is not intended to be run by the final user (the system
181
# administrator who installs this), so the developers can customize the list
182
# as necessary, and include it in the distribution.
183
listmake_mimetypes = ['text/x-python', 'text/html',
184
'application/x-javascript', 'application/javascript',
185
'text/css', 'image/png', 'application/xml']
187
# Main function skeleton from Guido van Rossum
188
# http://www.artima.com/weblogs/viewpost.jsp?thread=4829
36
190
def main(argv=None):
59
oper_func = call_operator(operation)
213
# Disallow run as root unless installing
214
if (operation != 'install' and operation != 'updatejails'
215
and os.geteuid() == 0):
216
print >>sys.stderr, "I do not want to run this stage as root."
217
print >>sys.stderr, "Please run as a normal user."
219
# Call the requested operation's function
225
'listmake' : listmake,
227
'updatejails' : updatejails,
230
print >>sys.stderr, (
231
"""Invalid operation '%s'. Try python setup.py help."""
60
234
return oper_func(argv[2:])
236
# Operation functions
64
print """Usage: python setup.py operation [options]
65
Operation (and options) can be:
240
print """Usage: python setup.py operation [args]
241
Operation (and args) can be:
67
243
listmake (developer use only)
70
246
install [--nojail] [--nosubjects] [-n|--dry]
72
For help on a specific operation use 'help [operation]'."""
75
oper_func = call_operator(operator)
76
oper_func(['operator','--help'])
78
def call_operator(operation):
79
# Call the requested operation's function
83
'config' : setup.configure.configure,
84
'build' : setup.build.build,
85
'listmake' : setup.listmake.listmake,
86
'install' : setup.install.install,
87
#'updatejails' : None,
250
print """Usage: python setup.py help [operation]"""
255
if operation == 'help':
256
print """python setup.py help [operation]
257
Prints the usage message or detailed help on an operation, then exits."""
258
elif operation == 'listmake':
259
print """python setup.py listmake
260
(For developer use only)
261
Recurses through the source tree and builds a list of all files which should
262
be copied upon installation. This should be run by the developer before
263
cutting a distribution, and the listfile it generates should be included in
264
the distribution, avoiding the administrator having to run it."""
265
elif operation == 'config':
266
print """python setup.py config [args]
267
Configures IVLE with machine-specific details, most notably, various paths.
268
Either prompts the administrator for these details or accepts them as
269
command-line args. Will be interactive only if there are no arguments given.
270
Takes defaults from existing conf file if it exists.
272
To run IVLE out of the source directory (allowing development without having
273
to rebuild/install), just provide ivle_install_dir as the IVLE trunk
274
directory, and run build/install one time.
276
Creates www/conf/conf.py and trampoline/conf.h.
285
As explained in the interactive prompt or conf.py.
287
elif operation == 'build':
288
print """python -O setup.py build [--dry|-n]
289
Compiles all files and sets up a jail template in the source directory.
290
-O is recommended to cause compilation to be optimised.
292
Compiles (GCC) trampoline/trampoline.c to trampoline/trampoline.
294
Creates standard subdirs inside the jail, eg bin, opt, home, tmp.
295
Copies console/ to a location within the jail.
296
Copies OS programs and files to corresponding locations within the jail
297
(eg. python and Python libs, ld.so, etc).
298
Generates .pyc or .pyo files for all the IVLE .py files.
300
--dry | -n Print out the actions but don't do anything."""
301
elif operation == 'install':
302
print """sudo python setup.py install [--nojail] [--nosubjects][--dry|-n]
304
Create target install directory ($target).
306
Copy trampoline/trampoline to $target/bin.
307
chown and chmod the installed trampoline.
308
Copy www/ to $target.
309
Copy jail/ to jails template directory (unless --nojail specified).
310
Copy subjects/ to subjects directory (unless --nosubjects specified).
312
--nojail Do not copy the jail.
313
--nosubjects Do not copy the subjects.
314
--dry | -n Print out the actions but don't do anything."""
315
elif operation == 'updatejails':
316
print """sudo python setup.py updatejails [--dry|-n]
318
Copy jail/ to each subdirectory in jails directory.
320
--dry | -n Print out the actions but don't do anything."""
90
322
print >>sys.stderr, (
91
323
"""Invalid operation '%s'. Try python setup.py help."""
328
# We build two separate lists, by walking www and console
329
list_www = build_list_py_files('www')
330
list_console = build_list_py_files('console')
331
list_subjects = build_list_py_files('subjects', no_top_level=True)
332
# Make sure that the files generated by conf are in the list
333
# (since listmake is typically run before conf)
334
if "www/conf/conf.py" not in list_www:
335
list_www.append("www/conf/conf.py")
336
# Make sure that console/python-console is in the list
337
if "console/python-console" not in list_console:
338
list_console.append("console/python-console")
339
# Write these out to a file
341
# the files that will be created/overwritten
342
listfile = os.path.join(cwd, "install_list.py")
345
file = open(listfile, "w")
347
file.write("""# IVLE Configuration File
349
# Provides lists of all files to be installed by `setup.py install' from
350
# certain directories.
351
# Note that any files with the given filename plus 'c' or 'o' (that is,
352
# compiled .pyc or .pyo files) will be copied as well.
354
# List of all installable files in www directory.
356
writelist_pretty(file, list_www)
358
# List of all installable files in console directory.
360
writelist_pretty(file, list_console)
362
# List of all installable files in subjects directory.
363
# This is to install sample subjects and material.
365
writelist_pretty(file, list_subjects)
368
except IOError, (errno, strerror):
369
print "IO error(%s): %s" % (errno, strerror)
372
print "Successfully wrote install_list.py"
375
print ("You may modify the set of installable files before cutting the "
382
def build_list_py_files(dir, no_top_level=False):
383
"""Builds a list of all py files found in a directory and its
384
subdirectories. Returns this as a list of strings.
385
no_top_level=True means the file paths will not include the top-level
389
for (dirpath, dirnames, filenames) in os.walk(dir):
390
# Exclude directories beginning with a '.' (such as '.svn')
391
filter_mutate(lambda x: x[0] != '.', dirnames)
392
# All *.py files are added to the list
393
pylist += [os.path.join(dirpath, item) for item in filenames
394
if mimetypes.guess_type(item)[0] in listmake_mimetypes]
396
for i in range(0, len(pylist)):
397
_, pylist[i] = pylist[i].split(os.sep, 1)
400
def writelist_pretty(file, list):
401
"""Writes a list one element per line, to a file."""
407
file.write(' %s,\n' % repr(elem))
411
global root_dir, ivle_install_dir, jail_base, subjects_base
412
global public_host, allowed_uids
413
# Set up some variables
416
# the files that will be created/overwritten
417
conffile = os.path.join(cwd, "www/conf/conf.py")
418
conf_hfile = os.path.join(cwd, "trampoline/conf.h")
420
# Get command-line arguments to avoid asking questions.
422
(opts, args) = getopt.gnu_getopt(args, "", ['root_dir=',
423
'ivle_install_dir=', 'jail_base=', 'allowed_uids='])
426
print >>sys.stderr, "Invalid arguments:", string.join(args, ' ')
430
# Interactive mode. Prompt the user for all the values.
432
print """This tool will create the following files:
435
prompting you for details about your configuration. The file will be
436
overwritten if it already exists. It will *not* install or deploy IVLE.
438
Please hit Ctrl+C now if you do not wish to do this.
439
""" % (conffile, conf_hfile)
441
# Get information from the administrator
442
# If EOF is encountered at any time during the questioning, just exit
445
root_dir = query_user(root_dir,
446
"""Root directory where IVLE is located (in URL space):""")
447
ivle_install_dir = query_user(ivle_install_dir,
448
'Root directory where IVLE will be installed (on the local file '
450
jail_base = query_user(jail_base,
451
"""Root directory where the jails (containing user files) are stored
452
(on the local file system):""")
453
subjects_base = query_user(subjects_base,
454
"""Root directory where the subject directories (containing worksheets
455
and other per-subject files) are stored (on the local file system):""")
456
public_host = query_user(public_host,
457
"""Hostname which will cause the server to go into "public mode",
458
providing login-free access to student's published work:""")
459
allowed_uids = query_user(allowed_uids,
460
"""UID of the web server process which will run IVLE.
461
Only this user may execute the trampoline. May specify multiple users as
462
a comma-separated list.
467
# Non-interactive mode. Parse the options.
468
if '--root_dir' in opts:
469
root_dir = opts['--root_dir']
470
if '--ivle_install_dir' in opts:
471
ivle_install_dir = opts['--ivle_install_dir']
472
if '--jail_base' in opts:
473
jail_base = opts['--jail_base']
474
if '--subjects_base' in opts:
475
jail_base = opts['--subjects_base']
476
if '--public_host' in opts:
477
public_host = opts['--public_host']
478
if '--allowed_uids' in opts:
479
allowed_uids = opts['--allowed_uids']
481
# Error handling on input values
483
allowed_uids = map(int, allowed_uids.split(','))
485
print >>sys.stderr, (
486
"Invalid UID list (%s).\n"
487
"Must be a comma-separated list of integers." % allowed_uids)
490
# Write www/conf/conf.py
493
conf = open(conffile, "w")
495
conf.write("""# IVLE Configuration File
497
# Miscellaneous application settings
500
# In URL space, where in the site is IVLE located. (All URLs will be prefixed
502
# eg. "/" or "/ivle".
505
# In the local file system, where IVLE is actually installed.
506
# This directory should contain the "www" and "bin" directories.
507
ivle_install_dir = "%s"
509
# The server goes into "public mode" if the browser sends a request with this
510
# host. This is for security reasons - we only serve public student files on a
511
# separate domain to the main IVLE site.
512
# Public mode does not use cookies, and serves only public content.
513
# Private mode (normal mode) requires login, and only serves files relevant to
514
# the logged-in user.
517
# In the local file system, where are the student/user file spaces located.
518
# The user jails are expected to be located immediately in subdirectories of
522
# In the local file system, where are the per-subject file spaces located.
523
# The individual subject directories are expected to be located immediately
524
# in subdirectories of this location.
526
""" % (root_dir, ivle_install_dir, public_host, jail_base, subjects_base))
529
except IOError, (errno, strerror):
530
print "IO error(%s): %s" % (errno, strerror)
533
print "Successfully wrote www/conf/conf.py"
535
# Write trampoline/conf.h
538
conf = open(conf_hfile, "w")
540
conf.write("""/* IVLE Configuration File
542
* Administrator settings required by trampoline.
543
* Note: trampoline will have to be rebuilt in order for changes to this file
547
/* In the local file system, where are the jails located.
548
* The trampoline does not allow the creation of a jail anywhere besides
549
* jail_base or a subdirectory of jail_base.
551
static const char* jail_base = "%s";
553
/* Which user IDs are allowed to run the trampoline.
554
* This list should be limited to the web server user.
555
* (Note that root is an implicit member of this list).
557
static const int allowed_uids[] = { %s };
558
""" % (jail_base, repr(allowed_uids)[1:-1]))
561
except IOError, (errno, strerror):
562
print "IO error(%s): %s" % (errno, strerror)
565
print "Successfully wrote trampoline/conf.h"
568
print "You may modify the configuration at any time by editing"
575
# Get "dry" variable from command line
576
(opts, args) = getopt.gnu_getopt(args, "n", ['dry'])
578
dry = '-n' in opts or '--dry' in opts
581
print "Dry run (no actions will be executed\n"
583
# Compile the trampoline
585
os.chdir('trampoline')
586
action_runprog('make', [], dry)
589
# Create the jail and its subdirectories
590
# Note: Other subdirs will be made by copying files
591
action_mkdir('jail', dry)
592
action_mkdir('jail/home', dry)
593
action_mkdir('jail/tmp', dry)
595
# Copy all console and operating system files into the jail
596
action_copylist(install_list.list_console, 'jail/opt/ivle', dry)
597
copy_os_files_jail(dry)
598
# Chmod the python console
599
action_chmod_x('jail/opt/ivle/console/python-console', dry)
602
# Compile .py files into .pyc or .pyo files
603
compileall.compile_dir('www', quiet=True)
604
compileall.compile_dir('console', quiet=True)
608
def copy_os_files_jail(dry):
609
"""Copies necessary Operating System files from their usual locations
610
into the jail/ directory of the cwd."""
611
# Currently source paths are configured for Ubuntu.
612
for filename in JAIL_FILES:
613
copy_file_to_jail(filename, dry)
614
for src, dst in JAIL_LINKS.items():
615
action_symlink(src, dst, dry)
616
for src, dst in JAIL_COPYTREES.items():
617
action_copytree(src, dst, dry)
619
def copy_file_to_jail(src, dry):
620
"""Copies a single file from an absolute location into the same location
621
within the jail. src must begin with a '/'. The jail will be located
622
in a 'jail' subdirectory of the current path."""
623
action_copyfile(src, 'jail' + src, dry)
626
# Get "dry" and "nojail" variables from command line
627
(opts, args) = getopt.gnu_getopt(args, "n",
628
['dry', 'nojail', 'nosubjects'])
630
dry = '-n' in opts or '--dry' in opts
631
nojail = '--nojail' in opts
632
nosubjects = '--nosubjects' in opts
635
print "Dry run (no actions will be executed\n"
637
if not dry and os.geteuid() != 0:
638
print >>sys.stderr, "Must be root to run install"
639
print >>sys.stderr, "(I need to chown some files)."
642
# Create the target (install) directory
643
action_mkdir(ivle_install_dir, dry)
645
# Create bin and copy the compiled files there
646
action_mkdir(os.path.join(ivle_install_dir, 'bin'), dry)
647
tramppath = os.path.join(ivle_install_dir, 'bin/trampoline')
648
action_copyfile('trampoline/trampoline', tramppath, dry)
649
# chown trampoline to root and set setuid bit
650
action_chown_setuid(tramppath, dry)
652
# Copy the www directory using the list
653
action_copylist(install_list.list_www, ivle_install_dir, dry)
656
# Copy the local jail directory built by the build action
657
# to the jails template directory (it will be used as a template
658
# for all the students' jails).
659
action_copytree('jail', os.path.join(jail_base, 'template'), dry)
661
# Copy the subjects directory across
662
action_copylist(install_list.list_subjects, subjects_base, dry,
665
# Append IVLE path to ivle.pth in python site packages
666
# (Unless it's already there)
667
ivle_pth = os.path.join(sys.prefix,
668
"lib/python%s/site-packages/ivle.pth" % PYTHON_VERSION)
669
ivle_www = os.path.join(ivle_install_dir, "www")
670
write_ivle_pth = True
672
file = open(ivle_pth, 'r')
674
if line.strip() == ivle_www:
675
write_ivle_pth = False
677
except (IOError, OSError):
680
action_append(ivle_pth, ivle_www)
684
def updatejails(args):
685
# Get "dry" variable from command line
686
(opts, args) = getopt.gnu_getopt(args, "n", ['dry'])
688
dry = '-n' in opts or '--dry' in opts
691
print "Dry run (no actions will be executed\n"
693
if not dry and os.geteuid() != 0:
694
print >>sys.stderr, "Must be root to run install"
695
print >>sys.stderr, "(I need to chown some files)."
698
# Update the template jail directory in case it hasn't been installed
700
action_copytree('jail', os.path.join(jail_base, 'template'), dry)
702
# Re-link all the files in all students jails.
703
for dir in os.listdir(jail_base):
704
if dir == 'template': continue
705
# First back up the student's home directory
706
temp_home = os.tmpnam()
707
action_rename(os.path.join(jail_base, dir, 'home'), temp_home, dry)
708
# Delete the student's jail and relink the jail files
709
action_linktree(os.path.join(jail_base, 'template'),
710
os.path.join(jail_base, dir), dry)
711
# Restore the student's home directory
712
action_rename(temp_home, os.path.join(jail_base, dir, 'home'), dry)
713
# Set up the user's home directory just in case they don't have a
714
# directory for this yet
715
action_mkdir(os.path.join(jail_base, dir, 'home', dir), dry)
719
# The actions call Python os functions but print actions and handle dryness.
720
# May still throw os exceptions if errors occur.
723
"""Represents an error when running a program (nonzero return)."""
724
def __init__(self, prog, retcode):
726
self.retcode = retcode
728
return str(self.prog) + " returned " + repr(self.retcode)
730
def action_runprog(prog, args, dry):
731
"""Runs a unix program. Searches in $PATH. Synchronous (waits for the
732
program to return). Runs in the current environment. First prints the
733
action as a "bash" line.
735
Throws a RunError with a retcode of the return value of the program,
736
if the program did not return 0.
738
prog: String. Name of the program. (No path required, if in $PATH).
739
args: [String]. Arguments to the program.
740
dry: Bool. If True, prints but does not execute.
742
print prog, string.join(args, ' ')
744
ret = os.spawnvp(os.P_WAIT, prog, args)
746
raise RunError(prog, ret)
748
def action_rename(src, dst, dry):
749
"""Calls rename. Deletes the target if it already exists."""
750
if os.access(dst, os.F_OK):
753
shutil.rmtree(dst, True)
754
print "mv ", src, dst
758
except OSError, (err, msg):
759
if err != errno.EEXIST:
762
def action_mkdir(path, dry):
763
"""Calls mkdir. Silently ignored if the directory already exists.
764
Creates all parent directories as necessary."""
765
print "mkdir -p", path
769
except OSError, (err, msg):
770
if err != errno.EEXIST:
773
def action_copytree(src, dst, dry):
774
"""Copies an entire directory tree. Symlinks are seen as normal files and
775
copies of the entire file (not the link) are made. Creates all parent
776
directories as necessary.
778
See shutil.copytree."""
779
if os.access(dst, os.F_OK):
782
shutil.rmtree(dst, True)
783
print "cp -r", src, dst
785
shutil.copytree(src, dst, True)
787
def action_linktree(src, dst, dry):
788
"""Hard-links an entire directory tree. Same as copytree but the created
789
files are hard-links not actual copies. Removes the existing destination.
791
if os.access(dst, os.F_OK):
794
shutil.rmtree(dst, True)
795
print "<cp with hardlinks> -r", src, dst
797
common.makeuser.linktree(src, dst)
799
def action_copylist(srclist, dst, dry, srcdir="."):
800
"""Copies all files in a list to a new location. The files in the list
801
are read relative to the current directory, and their destinations are the
802
same paths relative to dst. Creates all parent directories as necessary.
803
srcdir is "." by default, can be overridden.
805
for srcfile in srclist:
806
dstfile = os.path.join(dst, srcfile)
807
srcfile = os.path.join(srcdir, srcfile)
808
dstdir = os.path.split(dstfile)[0]
809
if not os.path.isdir(dstdir):
810
action_mkdir(dstdir, dry)
811
print "cp -f", srcfile, dstfile
814
shutil.copyfile(srcfile, dstfile)
815
shutil.copymode(srcfile, dstfile)
819
def action_copyfile(src, dst, dry):
820
"""Copies one file to a new location. Creates all parent directories
822
Warn if file not found.
824
dstdir = os.path.split(dst)[0]
825
if not os.path.isdir(dstdir):
826
action_mkdir(dstdir, dry)
827
print "cp -f", src, dst
830
shutil.copyfile(src, dst)
831
shutil.copymode(src, dst)
832
except (shutil.Error, IOError), e:
833
print "Warning: " + str(e)
835
def action_symlink(src, dst, dry):
836
"""Creates a symlink in a given location. Creates all parent directories
839
dstdir = os.path.split(dst)[0]
840
if not os.path.isdir(dstdir):
841
action_mkdir(dstdir, dry)
842
# Delete existing file
843
if os.path.exists(dst):
845
print "ln -fs", src, dst
849
def action_append(ivle_pth, ivle_www):
850
file = open(ivle_pth, 'a+')
851
file.write(ivle_www + '\n')
854
def action_chown_setuid(file, dry):
855
"""Chowns a file to root, and sets the setuid bit on the file.
856
Calling this function requires the euid to be root.
857
The actual mode of path is set to: rws--s--s
859
print "chown root:root", file
862
print "chmod a+xs", file
863
print "chmod u+rw", file
865
os.chmod(file, stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH
866
| stat.S_ISUID | stat.S_IRUSR | stat.S_IWUSR)
868
def action_chmod_x(file, dry):
869
"""Chmod +xs a file (sets execute permission)."""
870
print "chmod u+rwx", file
872
os.chmod(file, stat.S_IXUSR | stat.S_IRUSR | stat.S_IWUSR)
874
def query_user(default, prompt):
875
"""Prompts the user for a string, which is read from a line of stdin.
876
Exits silently if EOF is encountered. Returns the string, with spaces
877
removed from the beginning and end.
879
Returns default if a 0-length line (after spaces removed) was read.
881
sys.stdout.write('%s\n (default: "%s")\n>' % (prompt, default))
883
val = sys.stdin.readline()
884
except KeyboardInterrupt:
886
sys.stdout.write("\n")
888
sys.stdout.write("\n")
890
if val == '': sys.exit(1)
891
# If empty line, return default
893
if val == '': return default
896
def filter_mutate(function, list):
897
"""Like built-in filter, but mutates the given list instead of returning a
898
new one. Returns None."""
901
# Delete elements which do not match
902
if not function(list[i]):
96
906
if __name__ == "__main__":
added
removed
setup.py
