[tbb-commits] [tor-browser-build/master] Bug 40298: Add documentation about subuid and subgid

boklm at torproject.org boklm at torproject.org
Thu Feb 10 12:40:39 UTC 2022


commit ddb8212aeaaa10ff21faa84312ccc533d44f8100
Author: Nicolas Vigier <boklm at torproject.org>
Date:   Thu Feb 10 09:14:37 2022 +0100

    Bug 40298: Add documentation about subuid and subgid
---
 README               |  6 ++++++
 doc/BUILD_ERRORS.txt | 19 +++++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/README b/README
index 5407b0c..1e7a4b9 100644
--- a/README
+++ b/README
@@ -53,6 +53,12 @@ To enable them you can use the following command as root:
 
 You can enable them permanently by adding the setting to /etc/sysctl.d/
 
+The user you use to build needs to have a range of subordinate uids and
+gids in /etc/subuid and /etc/subgid. Most of the time they are added by
+default when the user is created. If it was not the case, you can use
+usermod(8) with the --add-subuids and --add-subgids options. See also
+the subuid(5) and subgid(5) man pages.
+
 
 Starting a build
 ----------------
diff --git a/doc/BUILD_ERRORS.txt b/doc/BUILD_ERRORS.txt
index 83f2257..8bad9ea 100644
--- a/doc/BUILD_ERRORS.txt
+++ b/doc/BUILD_ERRORS.txt
@@ -43,3 +43,22 @@ rm /etc/resolv.conf
 Restart network-manager
 
 sudo service network-manager restart
+
+
+Could not find uid in /etc/subuid
+---------------------------------
+
+In some cases you can have the error:
+
+  Error: Error starting remote:
+  Error: Could not find uid in /etc/subuid
+  Error: failed to set uidmap
+
+The user you use to build needs to have a range of subordinate uids and
+gids in /etc/subuid and /etc/subgid. Most of the time they are added by
+default when the user is created. If it was not the case, you can use
+usermod(8) with the --add-subuids and --add-subgids options. See also
+the subuid(5) and subgid(5) man pages.
+
+Note that the root user is not exempted from the requirement for a
+valid /etc/subuid and /etc/subgid entry, if you are building as root.





More information about the tbb-commits mailing list