From 7f810d0c9a8cb9644abf1428f63fe3b5c33da0c8 Mon Sep 17 00:00:00 2001
From: Juan RP <xtraeme@voidlinux.eu>
Date: Tue, 14 Apr 2015 08:32:02 +0200
Subject: [PATCH] README: even more info for chroot styles.

---
 README.md | 32 +++++++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 642c61007a9..e36e413ed98 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@ The included `xbps-src` script will fetch and compile the sources, and install i
 files into a `fake destdir` to generate XBPS binary packages that can be installed
 or queried through the `xbps-install(8)` and `xbps-query(8)` utilities, respectively.
 
-The `xbps-src` utility requires an utility to chroot and bind mount existing directories
+`xbps-src` requires an utility to chroot and bind mount existing directories
 into a `masterdir` that is used as its main `chroot` directory. `xbps-src` supports
 multiple utilities to accomplish this task:
 
@@ -31,6 +31,20 @@ This utility requires these linux kernel options:
 - CONFIG\_UTS\_NS
 - CONFIG\_USER\_NS
 
+#### unshare(1)
+
+This utility also requires `user_namespaces(7)` support and these linux kernel options:
+
+- CONFIG\_NAMESPACES
+- CONFIG\_IPC\_NS
+- CONFIG\_UTS\_NS
+- CONFIG\_USER\_NS
+
+To enable it:
+
+    $ cd void-packages
+    $ echo XBPS_CHROOT_CMD=unshare >> etc/conf
+
 #### xbps-uchroot(8)
 
 This utility requires these linux kernel options:
@@ -49,6 +63,22 @@ executable must be `setgid`:
 > NOTE: by default in void you shouldn't do this manually, your user must be a member of
 the `xbuilder` group.
 
+To enable it:
+
+    $ cd void-packages
+    $ echo XBPS_CHROOT_CMD=uchroot >> etc/conf
+
+#### proot(1)
+
+The `proot(1)` utility implements chroot and bind mounts support completely in user space,
+and can be used if your linux kernel does not have support for namespaces. See http://proot.me
+for more information.
+
+To enable it:
+
+    $ cd void-packages
+    $ echo XBPS_CHROOT_CMD=proot >> etc/conf
+
 ### Requirements
 
 - GNU bash