commit ddb8212aeaaa10ff21faa84312ccc533d44f8100 Author: Nicolas Vigier <boklm@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.