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
36 #include "linuxcaps.h"
41 fprintf (stderr,"chcontext version %s\n",VERSION);
43 ,"chcontext [ options ] command arguments ...\n"
45 "chcontext allocate a new security context and executes\n"
46 "a command in that context.\n"
47 "By default, a new/unused context is allocated\n"
51 "\tAdd a capability from the command. This option may be\n"
52 "\trepeated several time.\n"
53 "\tSee /usr/include/linux/capability.h\n"
54 "\tIn general, this option is used with the --secure option\n"
55 "\t--secure removes most critical capabilities and --cap\n"
56 "\tadds specific ones.\n"
60 "\tRemove a capability from the command. This option may be\n"
61 "\trepeated several time.\n"
62 "\tSee /usr/include/linux/capability.h\n"
65 "\tSelect the context. On root in context 0 is allowed to\n"
66 "\tselect a specific context.\n"
67 "\tContext number 1 is special. It can see all processes\n"
68 "\tin any contexts, but can't kill them though.\n"
69 "\tOption --ctx may be repeated several times to specify up to 16 contexts.\n"
72 "\tStart the command in background and make the process\n"
73 "\ta child of process 1.\n"
75 "--domainname new_domainname\n"
76 "\tSet the domainname (NIS) in the new security context.\n"
77 "\tUse \"none\" to unset the domain name.\n"
80 "\tSet one flag in the new or current security context. The following\n"
81 "\tflags are supported. The option may be used several time.\n"
83 "\tfakeinit: The new process will believe it is process number 1.\n"
84 " Useful to run a real /sbin/init in a vserver.\n"
85 "\tlock: The new process is trapped and can't use chcontext anymore.\n"
86 "\tsched: The new process and its children will share a common \n"
87 " execution priority.\n"
88 "\tnproc: Limit the number of process in the vserver according to\n"
89 " ulimit setting. Normally, ulimit is a per user thing.\n"
90 " With this flag, it becomes a per vserver thing.\n"
91 "\tprivate: No one can join this security context once created.\n"
92 "\tulimit: Apply the current ulimit to the whole context\n"
94 "--hostname new_hostname\n"
95 "\tSet the hostname in the new security context\n"
96 "\tThis is need because if you create a less privileged\n"
97 "\tsecurity context, it may be unable to change its hostname\n"
100 "\tRemove all the capabilities to make a virtual server trustable\n"
103 "\tDo not print the allocated context number.\n"
105 "Information about context is found in /proc/self/status\n");
109 int main (int argc, char *argv[])
119 unsigned remove_cap = 0;
120 unsigned add_cap = 0;
121 unsigned long secure = (1<<CAP_LINUX_IMMUTABLE)
122 |(1<<CAP_NET_BROADCAST)
133 |(1<<CAP_SYS_RESOURCE)
136 const char *hostname=NULL, *domainname=NULL;
138 for (i=1; i<argc; i++){
139 const char *arg = argv[i];
140 const char *opt = argv[i+1];
141 if (strcmp(arg,"--ctx")==0){
143 fprintf (stderr,"Too many context, max 16, ignored.\n");
145 ctxs[nbctx++] = atoi(opt);
148 }else if (strcmp(arg,"--disconnect")==0){
150 }else if (strcmp(arg,"--silent")==0){
152 }else if (strcmp(arg,"--flag")==0){
153 if (strcmp(opt,"lock")==0){
155 }else if (strcmp(opt,"sched")==0){
157 }else if (strcmp(opt,"nproc")==0){
159 }else if (strcmp(opt,"private")==0){
161 }else if (strcmp(opt,"fakeinit")==0){
164 }else if (strcmp(opt,"hideinfo")==0){
166 }else if (strcmp(opt,"ulimit")==0){
169 fprintf (stderr,"Unknown flag %s\n",opt);
172 }else if (strcmp(arg,"--cap")==0){
177 // The following capabilities are normally available
178 // to vservers administrator, but are place for
180 {"CAP_CHOWN",CAP_CHOWN},
181 {"CAP_DAC_OVERRIDE",CAP_DAC_OVERRIDE},
182 {"CAP_DAC_READ_SEARCH",CAP_DAC_READ_SEARCH},
183 {"CAP_FOWNER",CAP_FOWNER},
184 {"CAP_FSETID",CAP_FSETID},
185 {"CAP_KILL",CAP_KILL},
186 {"CAP_SETGID",CAP_SETGID},
187 {"CAP_SETUID",CAP_SETUID},
188 {"CAP_SETPCAP",CAP_SETPCAP},
189 {"CAP_SYS_TTY_CONFIG",CAP_SYS_TTY_CONFIG},
190 {"CAP_LEASE",CAP_LEASE},
191 {"CAP_SYS_CHROOT",CAP_SYS_CHROOT},
193 // Those capabilities are not normally available
194 // to vservers because they are not needed and
195 // may represent a security risk
196 {"CAP_LINUX_IMMUTABLE",CAP_LINUX_IMMUTABLE},
197 {"CAP_NET_BIND_SERVICE",CAP_NET_BIND_SERVICE},
198 {"CAP_NET_BROADCAST",CAP_NET_BROADCAST},
199 {"CAP_NET_ADMIN", CAP_NET_ADMIN},
200 {"CAP_NET_RAW", CAP_NET_RAW},
201 {"CAP_IPC_LOCK", CAP_IPC_LOCK},
202 {"CAP_IPC_OWNER", CAP_IPC_OWNER},
203 {"CAP_SYS_MODULE",CAP_SYS_MODULE},
204 {"CAP_SYS_RAWIO", CAP_SYS_RAWIO},
205 {"CAP_SYS_PACCT", CAP_SYS_PACCT},
206 {"CAP_SYS_ADMIN", CAP_SYS_ADMIN},
207 {"CAP_SYS_BOOT", CAP_SYS_BOOT},
208 {"CAP_SYS_NICE", CAP_SYS_NICE},
209 {"CAP_SYS_RESOURCE",CAP_SYS_RESOURCE},
210 {"CAP_SYS_TIME", CAP_SYS_TIME},
211 {"CAP_MKNOD", CAP_MKNOD},
215 unsigned *cap = &add_cap;
220 for (j=0; tbcap[j].option != NULL; j++){
221 if (strcasecmp(tbcap[j].option,opt)==0){
222 *cap |= (1<<tbcap[j].bit);
226 if (tbcap[j].option == NULL){
227 fprintf (stderr,"Unknown capability %s\n",opt);
230 }else if (strcmp(arg,"--secure")==0){
231 remove_cap |= secure;
232 }else if (strcmp(arg,"--hostname")==0){
235 }else if (strcmp(arg,"--domainname")==0){
236 if (opt != NULL && strcmp(opt,"none")==0) opt = "";
245 }else if (argv[i][0] == '-'){
249 We must fork early because fakeinit set the current
250 process as the special init process
252 if (disconnect == 0 || fork()==0){
254 if (nbctx == 0) ctxs[nbctx++] = -1;
255 newctx = vc_new_s_context(ctxs[0],0,flags);
257 if (hostname != NULL){
258 if (sethostname (hostname,strlen(hostname))==-1){
259 fprintf (stderr,"Can't set the host name (%s)\n"
262 printf ("Host name is now %s\n",hostname);
265 if (domainname != NULL){
266 setdomainname (domainname,strlen(domainname));
268 printf ("Domain name is now %s\n",domainname);
271 remove_cap &= (~add_cap);
272 if (remove_cap != 0) vc_new_s_context (-2,remove_cap,0);
274 printf ("New security context is %d\n"
275 ,ctxs[0] == -1 ? newctx : ctxs[0]);
277 execvp (argv[i],argv+i);
278 fprintf (stderr,"Can't exec %s (%s)\n",argv[i]
281 perror ("Can't set the new security context\n");
283 if (disconnect != 0) _exit(0);