[tbb-commits] [tor-browser-build/master] Add a README.BUILD_ERRORS file listing some common errors

[boklm at torproject.org]

commit 88146b2f6e947d35d672f0b82e39283a46dfe0d4
Author: Nicolas Vigier <boklm at torproject.org>
Date:   Mon Feb 13 00:06:13 2017 +0100

    Add a README.BUILD_ERRORS file listing some common errors
---
 README              |  7 +++++++
 README.BUILD_ERRORS | 44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)

diff --git a/README b/README
index 2c36d74..775f782 100644
--- a/README
+++ b/README
@@ -164,3 +164,10 @@ Cleaning obsolete files and containers images
 There will be a script to clean old build files and containers that are
 no longer used, but it has not been added yet.
 
+
+Common Build Errors
+-------------------
+
+You can look at the README.BUILD_ERRORS file for a list of common build
+errors and their solutions.
+
diff --git a/README.BUILD_ERRORS b/README.BUILD_ERRORS
new file mode 100644
index 0000000..c1ee70c
--- /dev/null
+++ b/README.BUILD_ERRORS
@@ -0,0 +1,44 @@
+This file lists some common build errors and their solutions.
+
+
+Error starting remote
+---------------------
+
+If you have an error like this:
+
+----
+Error: Error starting remote:
+/bin/sh: 1: adduser: not found
+Segmentation fault (core dumped)
+----
+
+You might be having this issue:
+https://github.com/docker/docker/issues/28705
+
+When the kernel is configured with CONFIG_LEGACY_VSYSCALL_NONE, running
+Debian Wheezy containers fails with a segfault. This should be fixed by
+adding "vsyscall=emulate"to the kernel cmdline.
+
+If you are building inside Qubes, you can change the kernel cmdline for
+the VM you are using with something like this in dom0:
+
+----
+$ qvm-pref --get [vmname] kernelopts
+nopat
+$ qvm-pref --set [vmname] kernelopts 'nopat vsyscall=emulate'
+----
+
+
+tmp partition is full
+---------------------
+
+If your /tmp partition is small, you will get a 'No space left on device'
+error during the build. To select an other directory with more space
+available to store temporary files, you can define the TMPDIR environment
+variable:
+
+----
+$ mkdir /home/user/tmp
+$ export TMPDIR=/home/user/tmp
+----
+