| Guido van Rossum | ffa257d | 1995-07-20 21:57:15 +0000 | [diff] [blame] | 1 | /* | 
 | 2 |    Template for a setuid program that calls a script. | 
 | 3 |  | 
 | 4 |    The script should be in an unwritable directory and should itself | 
 | 5 |    be unwritable.  In fact all parent directories up to the root | 
 | 6 |    should be unwritable.  The script must not be setuid, that's what | 
 | 7 |    this program is for. | 
 | 8 |  | 
 | 9 |    This is a template program.  You need to fill in the name of the | 
 | 10 |    script that must be executed.  This is done by changing the | 
 | 11 |    definition of FULL_PATH below. | 
 | 12 |  | 
 | 13 |    There are also some rules that should be adhered to when writing | 
 | 14 |    the script itself. | 
 | 15 |  | 
 | 16 |    The first and most important rule is to never, ever trust that the | 
 | 17 |    user of the program will behave properly.  Program defensively. | 
 | 18 |    Check your arguments for reasonableness.  If the user is allowed to | 
 | 19 |    create files, check the names of the files.  If the program depends | 
 | 20 |    on argv[0] for the action it should perform, check it. | 
 | 21 |  | 
 | 22 |    Assuming the script is a Bourne shell script, the first line of the | 
 | 23 |    script should be | 
 | 24 | 	#!/bin/sh - | 
 | 25 |    The - is important, don't omit it.  If you're using esh, the first | 
 | 26 |    line should be | 
 | 27 | 	#!/usr/local/bin/esh -f | 
 | 28 |    and for ksh, the first line should be | 
 | 29 | 	#!/usr/local/bin/ksh -p | 
 | 30 |    The script should then set the variable IFS to the string | 
 | 31 |    consisting of <space>, <tab>, and <newline>.  After this (*not* | 
 | 32 |    before!), the PATH variable should be set to a reasonable value and | 
 | 33 |    exported.  Do not expect the PATH to have a reasonable value, so do | 
 | 34 |    not trust the old value of PATH.  You should then set the umask of | 
 | 35 |    the program by calling | 
 | 36 | 	umask 077 # or 022 if you want the files to be readable | 
 | 37 |    If you plan to change directories, you should either unset CDPATH | 
 | 38 |    or set it to a good value.  Setting CDPATH to just ``.'' (dot) is a | 
 | 39 |    good idea. | 
 | 40 |    If, for some reason, you want to use csh, the first line should be | 
 | 41 | 	#!/bin/csh -fb | 
 | 42 |    You should then set the path variable to something reasonable, | 
 | 43 |    without trusting the inherited path.  Here too, you should set the | 
 | 44 |    umask using the command | 
 | 45 | 	umask 077 # or 022 if you want the files to be readable | 
 | 46 | */ | 
 | 47 |  | 
 | 48 | #include <unistd.h> | 
 | 49 | #include <stdlib.h> | 
 | 50 | #include <stdio.h> | 
 | 51 | #include <sys/types.h> | 
 | 52 | #include <sys/stat.h> | 
| Jeremy Hylton | 1deebab | 1998-09-10 18:10:59 +0000 | [diff] [blame] | 53 | #include <string.h> | 
| Guido van Rossum | ffa257d | 1995-07-20 21:57:15 +0000 | [diff] [blame] | 54 |  | 
 | 55 | /* CONFIGURATION SECTION */ | 
 | 56 |  | 
 | 57 | #ifndef FULL_PATH	/* so that this can be specified from the Makefile */ | 
| Jeremy Hylton | faff0bd | 1998-09-10 20:18:09 +0000 | [diff] [blame] | 58 | /* Uncomment the following line: | 
| Jeremy Hylton | 1deebab | 1998-09-10 18:10:59 +0000 | [diff] [blame] | 59 | #define FULL_PATH	"/full/path/of/script"  | 
 | 60 | * Then comment out the #error line. */ | 
| Guido van Rossum | 106a470 | 1998-09-10 18:22:18 +0000 | [diff] [blame] | 61 | #error "You must define FULL_PATH somewhere" | 
| Guido van Rossum | ffa257d | 1995-07-20 21:57:15 +0000 | [diff] [blame] | 62 | #endif | 
 | 63 | #ifndef UMASK | 
 | 64 | #define UMASK		077 | 
 | 65 | #endif | 
 | 66 |  | 
 | 67 | /* END OF CONFIGURATION SECTION */ | 
 | 68 |  | 
 | 69 | #if defined(__STDC__) && defined(__sgi) | 
 | 70 | #define environ _environ | 
 | 71 | #endif | 
 | 72 |  | 
 | 73 | /* don't change def_IFS */ | 
 | 74 | char def_IFS[] = "IFS= \t\n"; | 
 | 75 | /* you may want to change def_PATH, but you should really change it in */ | 
 | 76 | /* your script */ | 
 | 77 | #ifdef __sgi | 
 | 78 | char def_PATH[] = "PATH=/usr/bsd:/usr/bin:/bin:/usr/local/bin:/usr/sbin"; | 
 | 79 | #else | 
 | 80 | char def_PATH[] = "PATH=/usr/ucb:/usr/bin:/bin:/usr/local/bin"; | 
 | 81 | #endif | 
 | 82 | /* don't change def_CDPATH */ | 
 | 83 | char def_CDPATH[] = "CDPATH=."; | 
 | 84 | /* don't change def_ENV */ | 
 | 85 | char def_ENV[] = "ENV=:"; | 
 | 86 |  | 
 | 87 | /* | 
 | 88 |    This function changes all environment variables that start with LD_ | 
 | 89 |    into variables that start with XD_.  This is important since we | 
 | 90 |    don't want the script that is executed to use any funny shared | 
 | 91 |    libraries. | 
 | 92 |  | 
 | 93 |    The other changes to the environment are, strictly speaking, not | 
 | 94 |    needed here.  They can safely be done in the script.  They are done | 
 | 95 |    here because we don't trust the script writer (just like the script | 
 | 96 |    writer shouldn't trust the user of the script). | 
 | 97 |    If IFS is set in the environment, set it to space,tab,newline. | 
 | 98 |    If CDPATH is set in the environment, set it to ``.''. | 
 | 99 |    Set PATH to a reasonable default. | 
 | 100 | */ | 
 | 101 | void | 
 | 102 | clean_environ(void) | 
 | 103 | { | 
 | 104 | 	char **p; | 
 | 105 | 	extern char **environ; | 
 | 106 |  | 
 | 107 | 	for (p = environ; *p; p++) { | 
 | 108 | 		if (strncmp(*p, "LD_", 3) == 0) | 
 | 109 | 			**p = 'X'; | 
 | 110 | 		else if (strncmp(*p, "_RLD", 4) == 0) | 
 | 111 | 			**p = 'X'; | 
| Guido van Rossum | 80eb3c0 | 1997-03-11 18:24:21 +0000 | [diff] [blame] | 112 | 		else if (strncmp(*p, "PYTHON", 6) == 0) | 
 | 113 | 			**p = 'X'; | 
| Guido van Rossum | ffa257d | 1995-07-20 21:57:15 +0000 | [diff] [blame] | 114 | 		else if (strncmp(*p, "IFS=", 4) == 0) | 
 | 115 | 			*p = def_IFS; | 
 | 116 | 		else if (strncmp(*p, "CDPATH=", 7) == 0) | 
 | 117 | 			*p = def_CDPATH; | 
 | 118 | 		else if (strncmp(*p, "ENV=", 4) == 0) | 
 | 119 | 			*p = def_ENV; | 
 | 120 | 	} | 
 | 121 | 	putenv(def_PATH); | 
 | 122 | } | 
 | 123 |  | 
 | 124 | int | 
 | 125 | main(int argc, char **argv) | 
 | 126 | { | 
 | 127 | 	struct stat statb; | 
 | 128 | 	gid_t egid = getegid(); | 
 | 129 | 	uid_t euid = geteuid(); | 
 | 130 |  | 
 | 131 | 	/* | 
 | 132 | 	   Sanity check #1. | 
 | 133 | 	   This check should be made compile-time, but that's not possible. | 
 | 134 | 	   If you're sure that you specified a full path name for FULL_PATH, | 
 | 135 | 	   you can omit this check. | 
 | 136 | 	*/ | 
 | 137 | 	if (FULL_PATH[0] != '/') { | 
 | 138 | 		fprintf(stderr, "%s: %s is not a full path name\n", argv[0], | 
 | 139 | 			FULL_PATH); | 
| Jeremy Hylton | 1deebab | 1998-09-10 18:10:59 +0000 | [diff] [blame] | 140 | 		fprintf(stderr, "You can only use this wrapper if you\n"); | 
 | 141 | 		fprintf(stderr, "compile it with an absolute path.\n"); | 
| Guido van Rossum | ffa257d | 1995-07-20 21:57:15 +0000 | [diff] [blame] | 142 | 		exit(1); | 
 | 143 | 	} | 
 | 144 |  | 
 | 145 | 	/* | 
 | 146 | 	   Sanity check #2. | 
 | 147 | 	   Check that the owner of the script is equal to either the | 
 | 148 | 	   effective uid or the super user. | 
 | 149 | 	*/ | 
 | 150 | 	if (stat(FULL_PATH, &statb) < 0) { | 
 | 151 | 		perror("stat"); | 
 | 152 | 		exit(1); | 
 | 153 | 	} | 
 | 154 | 	if (statb.st_uid != 0 && statb.st_uid != euid) { | 
 | 155 | 		fprintf(stderr, "%s: %s has the wrong owner\n", argv[0], | 
 | 156 | 			FULL_PATH); | 
| Jeremy Hylton | 1deebab | 1998-09-10 18:10:59 +0000 | [diff] [blame] | 157 | 		fprintf(stderr, "The script should be owned by root,\n"); | 
 | 158 | 		fprintf(stderr, "and shouldn't be writeable by anyone.\n"); | 
| Guido van Rossum | ffa257d | 1995-07-20 21:57:15 +0000 | [diff] [blame] | 159 | 		exit(1); | 
 | 160 | 	} | 
 | 161 |  | 
 | 162 | 	if (setregid(egid, egid) < 0) | 
 | 163 | 		perror("setregid"); | 
 | 164 | 	if (setreuid(euid, euid) < 0) | 
 | 165 | 		perror("setreuid"); | 
 | 166 |  | 
 | 167 | 	clean_environ(); | 
 | 168 |  | 
 | 169 | 	umask(UMASK); | 
 | 170 |  | 
 | 171 | 	while (**argv == '-')	/* don't let argv[0] start with '-' */ | 
 | 172 | 		(*argv)++; | 
 | 173 | 	execv(FULL_PATH, argv); | 
 | 174 | 	fprintf(stderr, "%s: could not execute the script\n", argv[0]); | 
 | 175 | 	exit(1); | 
 | 176 | } |