3 // Copyright (C) 2003 Enrico Scholz <enrico.scholz@informatik.tu-chemnitz.de>
4 // based on chcontext.cc by Jacques Gelinas
6 // This program is free software; you can redistribute it and/or modify
7 // it under the terms of the GNU General Public License as published by
8 // the Free Software Foundation; either version 2, or (at your option)
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with this program; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 chcontext is a wrapper to user the new_s_context system call. It
22 does little more than mapping command line option to the system call
35 #include "linuxcaps.h"
40 fprintf (stderr,"chcontext version %s\n",VERSION);
42 ,"chcontext [ options ] command arguments ...\n"
44 "chcontext allocate a new security context and executes\n"
45 "a command in that context.\n"
46 "By default, a new/unused context is allocated\n"
50 "\tAdd a capability from the command. This option may be\n"
51 "\trepeated several time.\n"
52 "\tSee /usr/include/linux/capability.h\n"
53 "\tIn general, this option is used with the --secure option\n"
54 "\t--secure removes most critical capabilities and --cap\n"
55 "\tadds specific ones.\n"
59 "\tRemove a capability from the command. This option may be\n"
60 "\trepeated several time.\n"
61 "\tSee /usr/include/linux/capability.h\n"
64 "\tSelect the context. On root in context 0 is allowed to\n"
65 "\tselect a specific context.\n"
66 "\tContext number 1 is special. It can see all processes\n"
67 "\tin any contexts, but can't kill them though.\n"
68 "\tOption --ctx may be repeated several times to specify up to 16 contexts.\n"
71 "\tStart the command in background and make the process\n"
72 "\ta child of process 1.\n"
74 "--domainname new_domainname\n"
75 "\tSet the domainname (NIS) in the new security context.\n"
76 "\tUse \"none\" to unset the domain name.\n"
79 "\tSet one flag in the new or current security context. The following\n"
80 "\tflags are supported. The option may be used several time.\n"
82 "\tfakeinit: The new process will believe it is process number 1.\n"
83 " Useful to run a real /sbin/init in a vserver.\n"
84 "\tlock: The new process is trapped and can't use chcontext anymore.\n"
85 "\tsched: The new process and its children will share a common \n"
86 " execution priority.\n"
87 "\tnproc: Limit the number of process in the vserver according to\n"
88 " ulimit setting. Normally, ulimit is a per user thing.\n"
89 " With this flag, it becomes a per vserver thing.\n"
90 "\tprivate: No one can join this security context once created.\n"
91 "\tulimit: Apply the current ulimit to the whole context\n"
93 "--hostname new_hostname\n"
94 "\tSet the hostname in the new security context\n"
95 "\tThis is need because if you create a less privileged\n"
96 "\tsecurity context, it may be unable to change its hostname\n"
99 "\tRemove all the capabilities to make a virtual server trustable\n"
102 "\tDo not print the allocated context number.\n"
104 "Information about context is found in /proc/self/status\n");
108 int main (int argc, char *argv[])
118 unsigned remove_cap = 0;
119 unsigned add_cap = 0;
120 unsigned long secure = (1<<CAP_LINUX_IMMUTABLE)
121 |(1<<CAP_NET_BROADCAST)
132 |(1<<CAP_SYS_RESOURCE)
135 const char *hostname=NULL, *domainname=NULL;
137 for (i=1; i<argc; i++){
138 const char *arg = argv[i];
139 const char *opt = argv[i+1];
140 if (strcmp(arg,"--ctx")==0){
142 fprintf (stderr,"Too many context, max 16, ignored.\n");
144 ctxs[nbctx++] = atoi(opt);
147 }else if (strcmp(arg,"--disconnect")==0){
149 }else if (strcmp(arg,"--silent")==0){
151 }else if (strcmp(arg,"--flag")==0){
152 if (strcmp(opt,"lock")==0){
154 }else if (strcmp(opt,"sched")==0){
156 }else if (strcmp(opt,"nproc")==0){
158 }else if (strcmp(opt,"private")==0){
160 }else if (strcmp(opt,"fakeinit")==0){
163 }else if (strcmp(opt,"hideinfo")==0){
165 }else if (strcmp(opt,"ulimit")==0){
168 fprintf (stderr,"Unknown flag %s\n",opt);
171 }else if (strcmp(arg,"--cap")==0){
176 // The following capabilities are normally available
177 // to vservers administrator, but are place for
179 {"CAP_CHOWN",CAP_CHOWN},
180 {"CAP_DAC_OVERRIDE",CAP_DAC_OVERRIDE},
181 {"CAP_DAC_READ_SEARCH",CAP_DAC_READ_SEARCH},
182 {"CAP_FOWNER",CAP_FOWNER},
183 {"CAP_FSETID",CAP_FSETID},
184 {"CAP_KILL",CAP_KILL},
185 {"CAP_SETGID",CAP_SETGID},
186 {"CAP_SETUID",CAP_SETUID},
187 {"CAP_SETPCAP",CAP_SETPCAP},
188 {"CAP_SYS_TTY_CONFIG",CAP_SYS_TTY_CONFIG},
189 {"CAP_LEASE",CAP_LEASE},
190 {"CAP_SYS_CHROOT",CAP_SYS_CHROOT},
192 // Those capabilities are not normally available
193 // to vservers because they are not needed and
194 // may represent a security risk
195 {"CAP_LINUX_IMMUTABLE",CAP_LINUX_IMMUTABLE},
196 {"CAP_NET_BIND_SERVICE",CAP_NET_BIND_SERVICE},
197 {"CAP_NET_BROADCAST",CAP_NET_BROADCAST},
198 {"CAP_NET_ADMIN", CAP_NET_ADMIN},
199 {"CAP_NET_RAW", CAP_NET_RAW},
200 {"CAP_IPC_LOCK", CAP_IPC_LOCK},
201 {"CAP_IPC_OWNER", CAP_IPC_OWNER},
202 {"CAP_SYS_MODULE",CAP_SYS_MODULE},
203 {"CAP_SYS_RAWIO", CAP_SYS_RAWIO},
204 {"CAP_SYS_PACCT", CAP_SYS_PACCT},
205 {"CAP_SYS_ADMIN", CAP_SYS_ADMIN},
206 {"CAP_SYS_BOOT", CAP_SYS_BOOT},
207 {"CAP_SYS_NICE", CAP_SYS_NICE},
208 {"CAP_SYS_RESOURCE",CAP_SYS_RESOURCE},
209 {"CAP_SYS_TIME", CAP_SYS_TIME},
210 {"CAP_MKNOD", CAP_MKNOD},
214 unsigned *cap = &add_cap;
219 for (j=0; tbcap[j].option != NULL; j++){
220 if (strcasecmp(tbcap[j].option,opt)==0){
221 *cap |= (1<<tbcap[j].bit);
225 if (tbcap[j].option == NULL){
226 fprintf (stderr,"Unknown capability %s\n",opt);
229 }else if (strcmp(arg,"--secure")==0){
230 remove_cap |= secure;
231 }else if (strcmp(arg,"--hostname")==0){
234 }else if (strcmp(arg,"--domainname")==0){
235 if (opt != NULL && strcmp(opt,"none")==0) opt = "";
244 }else if (argv[i][0] == '-'){
248 We must fork early because fakeinit set the current
249 process as the special init process
251 if (disconnect == 0 || fork()==0){
253 if (nbctx == 0) ctxs[nbctx++] = -1;
254 newctx = call_new_s_context(nbctx,ctxs,0,flags);
256 if (hostname != NULL){
257 if (sethostname (hostname,strlen(hostname))==-1){
258 fprintf (stderr,"Can't set the host name (%s)\n"
261 printf ("Host name is now %s\n",hostname);
264 if (domainname != NULL){
265 setdomainname (domainname,strlen(domainname));
267 printf ("Domain name is now %s\n",domainname);
270 remove_cap &= (~add_cap);
271 if (remove_cap != 0) call_new_s_context (0,NULL,remove_cap,0);
273 printf ("New security context is %d\n"
274 ,ctxs[0] == -1 ? newctx : ctxs[0]);
276 execvp (argv[i],argv+i);
277 fprintf (stderr,"Can't exec %s (%s)\n",argv[i]
280 perror ("Can't set the new security context\n");
282 if (disconnect != 0) _exit(0);