3 * Copyright (C) 2003 Enrico Scholz <enrico.scholz@informatik.tu-chemnitz.de>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2, or (at your option)
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 #ifndef H_VSERVER_SYSCALL_H
21 #define H_VSERVER_SYSCALL_H
25 #include <sys/types.h>
27 /** the value which is returned in error-case (no ctx found) */
28 #define VC_NOCTX ((xid_t)(-1))
29 /** the value which means a random (the next free) ctx */
30 #define VC_RANDCTX ((xid_t)(-1))
31 /** the value which means the current ctx */
32 #define VC_SAMECTX ((xid_t)(-2))
34 #define VC_LIM_INFINITY (~0ULL)
35 #define VC_LIM_KEEP (~1ULL)
38 #ifndef S_CTX_INFO_LOCK
39 # define S_CTX_INFO_LOCK 1
42 #ifndef S_CTX_INFO_SCHED
43 # define S_CTX_INFO_SCHED 2
46 #ifndef S_CTX_INFO_NPROC
47 # define S_CTX_INFO_NPROC 4
50 #ifndef S_CTX_INFO_PRIVATE
51 # define S_CTX_INFO_PRIVATE 8
54 #ifndef S_CTX_INFO_INIT
55 # define S_CTX_INFO_INIT 16
58 #ifndef S_CTX_INFO_HIDEINFO
59 # define S_CTX_INFO_HIDEINFO 32
62 #ifndef S_CTX_INFO_ULIMIT
63 # define S_CTX_INFO_ULIMIT 64
66 #define VC_CAP_CHOWN 0
67 #define VC_CAP_DAC_OVERRIDE 1
68 #define VC_CAP_DAC_READ_SEARCH 2
69 #define VC_CAP_FOWNER 3
70 #define VC_CAP_FSETID 4
72 #define VC_CAP_SETGID 6
73 #define VC_CAP_SETUID 7
74 #define VC_CAP_SETPCAP 8
75 #define VC_CAP_LINUX_IMMUTABLE 9
76 #define VC_CAP_NET_BIND_SERVICE 10
77 #define VC_CAP_NET_BROADCAST 11
78 #define VC_CAP_NET_ADMIN 12
79 #define VC_CAP_NET_RAW 13
80 #define VC_CAP_IPC_LOCK 14
81 #define VC_CAP_IPC_OWNER 15
82 #define VC_CAP_SYS_MODULE 16
83 #define VC_CAP_SYS_RAWIO 17
84 #define VC_CAP_SYS_CHROOT 18
85 #define VC_CAP_SYS_PTRACE 19
86 #define VC_CAP_SYS_PACCT 20
87 #define VC_CAP_SYS_ADMIN 21
88 #define VC_CAP_SYS_BOOT 22
89 #define VC_CAP_SYS_NICE 23
90 #define VC_CAP_SYS_RESOURCE 24
91 #define VC_CAP_SYS_TIME 25
92 #define VC_CAP_SYS_TTY_CONFIG 26
93 #define VC_CAP_MKNOD 27
94 #define VC_CAP_LEASE 28
95 #define VC_CAP_QUOTACTL 29
102 struct vc_ip_mask_pair {
107 /** Returns version of the given API-category */
108 int vc_get_version(int category);
110 /** Puts current process into context <ctx>, removes the given caps and
112 * Special values for ctx are
113 * - VC_SAMECTX which means the current context (just for changing caps and flags)
114 * - VC_RANDCTX which means the next free context; this value can be used by
115 * ordinary users also */
116 int vc_new_s_context(xid_t ctx, unsigned int remove_cap, unsigned int flags);
118 /** Sets the ipv4root information.
119 * \precondition: nb<16 */
120 int vc_set_ipv4root(uint32_t bcast, size_t nb, struct vc_ip_mask_pair const *ips);
122 /* rlimit related functions */
123 typedef uint64_t vc_limit_t;
132 struct vc_rlimit_mask {
138 int vc_get_rlimit(xid_t ctx, int resource, struct vc_rlimit *lim);
139 int vc_set_rlimit(xid_t ctx, int resource, struct vc_rlimit const *lim);
140 int vc_get_rlimit_mask(xid_t ctx, struct vc_rlimit_mask *lim);
143 /** sends a signal to a context/pid
144 Special values for pid are:
145 * -1 which means every process in ctx except the init-process
146 * 0 which means every process in ctx inclusive the init-process */
147 int vc_ctx_kill(xid_t ctx, pid_t pid, int sig);
150 /** Returns the context of the given process. pid==0 means the current process. */
151 xid_t vc_X_getctx(pid_t pid);
153 /** Returns the pid of the 'init' process */
154 pid_t vc_X_getinitpid(pid_t pid);
157 int vc_text2cap(char const *);
158 char const * vc_cap2text(int);
161 /* The management part */
163 #define VC_LIMIT_VSERVER_NAME_LEN 1024
165 typedef enum { vcCFG_NONE, vcCFG_AUTO,
168 vcCFG_RECENT_FULL } vcCfgStyle;
170 vcCfgStyle vc_getVserverCfgStyle(char const *id);
172 /** Resolves the name of the vserver. The result will be allocated and must
173 be freed by the caller. */
174 char * vc_getVserverName(char const *id, vcCfgStyle style);
176 char * vc_getVserverVdir(char const *id, vcCfgStyle style);
178 /** Returns the ctx of the given vserver, or VC_NOCTX if vserver is not
180 xid_t vc_getVserverCtx(char const *id, vcCfgStyle style);
182 /** Resolves the cfg-path of the vserver owning the given ctx. 'revdir' will
183 be used as the directory holding the mapping-links; when NULL, the
184 default value will be assumed. The result will be allocated and must be
185 freed by the caller. */
186 char * vc_getVserverByCtx(xid_t ctx, /*@null@*/vcCfgStyle *style,
187 /*@null@*/char const *revdir);