- reenabled the copy-all mode; can be disabled by setting the
[util-vserver.git] / util-vserver / lib / vserver.h
index 46c2b1a..e776f09 100644 (file)
@@ -21,6 +21,9 @@
 
 #include <stdint.h>
 #include <stdlib.h>
+#include <sys/types.h>
+
+#define VC_NOCTX       ((ctx_t)(-1))
 
 #ifdef __cplusplus
 extern "C" {
@@ -31,11 +34,27 @@ extern "C" {
     uint32_t   mask;
   };
 
-  int  vc_get_version(int cat);
+    /** Returns version of the given API-category */
+  int  vc_get_version(int category);
+  
+    /** Puts current process into context <ctx>, removes the given caps and
+     *  sets flags.
+     *  Special values for ctx are
+     *  - -2 which means the current context (just for changing caps and flags)
+     *  - -1 which means the next free context; this value can be used by
+     *    ordinary users also */
   int  vc_new_s_context(ctx_t ctx, unsigned int remove_cap, unsigned int flags);
+
+    /** Sets the ipv4root information.
+     *  \precondition: nb<16 */
   int  vc_set_ipv4root(uint32_t  bcast, size_t nb, struct vc_ip_mask_pair const *ips);
+  
   int  vc_chrootsafe(char const *dir);
 
+
+    /** Returns the context of the given process. pid==0 means the current process. */
+  ctx_t        vc_X_getctx(pid_t pid);
+    
 #ifdef __cplusplus
 }
 #endif