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

99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
1
/* IVLE - Informatics Virtual Learning Environment
2
 * Copyright (C) 2007-2008 The University of Melbourne
3
 *
4
 * This program is free software; you can redistribute it and/or modify
5
 * it under the terms of the GNU General Public License as published by
6
 * the Free Software Foundation; either version 2 of the License, or
7
 * (at your option) any later version.
8
 *
9
 * This program is distributed in the hope that it will be useful,
10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
 * GNU General Public License for more details.
13
 *
14
 * You should have received a copy of the GNU General Public License
15
 * along with this program; if not, write to the Free Software
16
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
17
 *
18
 * Program: Trampoline
19
 * Author:  Tom Conway, Matt Giuca
20
 * Date:    20/12/2007
21
 *
22
 * This program runs a given program in a given working dir.
23
 * First, it chroots to a jail path and setuids to a given user ID.
24
 * This is intented to provide a safe execution environment for arbitrary
25
 * programs and scripts.
26
 *
27
 * Scripts (such as Python programs) should be executed by supplying
28
 * "/usr/bin/python" as the program, and the script as the first argument.
29
 *
30
 * Usage: trampoline uid jail-path working-path program [args...]
31
 * Must run as root. Will safely setuid to the supplied uid, checking that it
32
 * is not root. Recommended that the file is set up as follows:
33
 *  sudo chown root:root trampoline; sudo chroot +s trampoline
34
 */
35
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
36
#include <stdio.h>
37
#include <stdlib.h>
38
#include <string.h>
39
#include <unistd.h>
315 by mattgiuca
trampoline/trampoline.c: Added 2 includes, which are required
40
#include <sys/types.h>
41
#include <sys/stat.h>
337 by drtomc
Make trampoline use the path canonicalization code.
42
#include <limits.h>
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
43
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
44
/* conf.h is admin-configured by the setup process.
45
 * It defines jail_base.
46
 */
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
47
#include "conf.h"
48
110 by mattgiuca
setup.py: Added to trampoline/conf.h an "allowed_uids" array. Asks the user
49
/* Returns TRUE if the given uid is allowed to execute trampoline.
50
 * Only root or the web server should be allowed to execute.
51
 * This is determined by the whitelist allowed_uids in conf.h.
52
 */
53
int uid_allowed(int uid)
54
{
55
    int i;
56
    /* root is always allowed to execute trampoline */
57
    if (uid == 0)
58
        return 1;
59
    /* loop over all allowed_uids */
60
    for (i=(sizeof(allowed_uids)/sizeof(*allowed_uids))-1; i>=0; i--)
61
    {
62
        if (allowed_uids[i] == uid)
63
            return 1;
64
    }
65
    /* default to disallowing */
66
    return 0;
67
}
68
268 by drtomc
Allow the trampoline to run its child as a daemon.
69
/* Turn the process into a daemon using the standard
70
 * 2-fork technique.
71
 */
72
void daemonize(void)
73
{
74
    pid_t pid, sid;
75
76
    /* already a daemon */
77
    if ( getppid() == 1 ) return;
78
79
    /* Fork off the parent process */
80
    pid = fork();
81
    if (pid < 0) {
82
        exit(1);
83
    }
84
    /* If we got a good PID, then we can exit the parent process. */
85
    if (pid > 0) {
86
        exit(0);
87
    }
88
89
    /* At this point we are executing as the child process */
90
91
    /* Change the file mode mask */
92
    umask(0);
93
94
    /* Create a new SID for the child process */
95
    sid = setsid();
96
    if (sid < 0) {
97
        exit(1);
98
    }
99
100
    /* Change the current working directory.  This prevents the current
101
       directory from being locked; hence not being able to remove it. */
102
    if ((chdir("/")) < 0) {
103
        exit(1);
104
    }
105
106
    /* Redirect standard files to /dev/null */
107
    freopen( "/dev/null", "r", stdin);
108
    freopen( "/dev/null", "w", stdout);
109
    freopen( "/dev/null", "w", stderr);
110
}
111
112
static void usage(const char* nm)
113
{
114
    fprintf(stderr,
115
        "usage: %s [-d] <uid> <jail> <cwd> <program> [args...]\n", nm);
116
    exit(1);
117
}
118
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
119
int main(int argc, char* const argv[])
120
{
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
121
    char* jailpath;
268 by drtomc
Allow the trampoline to run its child as a daemon.
122
    char* work_dir;
123
    char* prog;
124
    char* const * args;
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
125
    int uid;
268 by drtomc
Allow the trampoline to run its child as a daemon.
126
    int arg_num = 1;
127
    int daemon_mode = 0;
337 by drtomc
Make trampoline use the path canonicalization code.
128
    char canonical_jailpath[PATH_MAX];
110 by mattgiuca
setup.py: Added to trampoline/conf.h an "allowed_uids" array. Asks the user
129
130
    /* Disallow execution from all users but the whitelisted ones, and root */
131
    if (!uid_allowed(getuid()))
132
    {
133
        fprintf(stderr, "only the web server may execute trampoline\n");
134
        exit(1);
135
    }
136
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
137
    /* Args check and usage */
268 by drtomc
Allow the trampoline to run its child as a daemon.
138
    if (argc < 5)
139
    {
140
        usage(argv[0]);
141
    }
142
143
    if (strcmp(argv[arg_num], "-d") == 0)
144
    {
145
        if (argc < 6)
146
        {
147
            usage(argv[0]);
148
        }
149
        daemon_mode = 1;
150
        arg_num++;
151
    }
152
    uid = atoi(argv[arg_num++]);
153
    jailpath = argv[arg_num++];
154
    work_dir = argv[arg_num++];
155
    prog = argv[arg_num];
156
    args = argv + arg_num;
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
157
158
    /* Disallow suiding to the root user */
268 by drtomc
Allow the trampoline to run its child as a daemon.
159
    if (uid == 0)
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
160
    {
161
        fprintf(stderr, "cannot set up a jail as root\n");
162
        exit(1);
163
    }
164
337 by drtomc
Make trampoline use the path canonicalization code.
165
    /* Jail path must be an absolute path,
166
     * and it must begin with jail_base.
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
167
     */
337 by drtomc
Make trampoline use the path canonicalization code.
168
    if (norm(canonical_jailpath, PATH_MAX, jailpath) != 0)
169
    {
170
        fprintf(stderr, "bad jail path: %s\n", jailpath);
171
        exit(1);
172
    }
173
    if (strncmp(canonical_jailpath, jail_base, strlen(jail_base)))
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
174
    {
175
        fprintf(stderr, "bad jail path: %s\n", jailpath);
176
        exit(1);
177
    }
178
179
    /* chroot into the jail.
180
     * Henceforth this process, and its children, cannot see anything above
337 by drtomc
Make trampoline use the path canonicalization code.
181
     * canoncial_jailpath. */
182
    if (chroot(canonical_jailpath))
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
183
    {
184
        perror("could not chroot");
185
        exit(1);
186
    }
187
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
188
    /* chdir into the specified working directory */
268 by drtomc
Allow the trampoline to run its child as a daemon.
189
    if (chdir(work_dir))
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
190
    {
191
        perror("could not chdir");
192
        exit(1);
193
    }
194
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
195
    /* setuid to the given user ID.
196
     * Henceforth we will be running as this user instead of root.
197
     */
198
    if (setuid(uid))
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
199
    {
200
        perror("could not setuid");
201
        exit(1);
202
    }
203
268 by drtomc
Allow the trampoline to run its child as a daemon.
204
    if (daemon_mode)
205
    {
206
        daemonize();
207
    }
208
99 by mattgiuca
trampoline/trampoline.c: Tidied up, added comments, #defines and variables.
209
    /* exec (replace this process with the a new instance of the target
210
     * program). Pass along all the arguments.
211
     * Note that for script execution, the "program" will be the interpreter,
212
     * and the first argument will be the script. */
268 by drtomc
Allow the trampoline to run its child as a daemon.
213
    execv(prog, args);
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
214
268 by drtomc
Allow the trampoline to run its child as a daemon.
215
    /* XXX if (daemon_mode) use syslog? */
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
216
    /* nb exec won't return unless there was an error */
217
    perror("could not exec");
268 by drtomc
Allow the trampoline to run its child as a daemon.
218
    return 1;
95 by mattgiuca
Moved some things out of www into their respective dirs, console and
219
}