aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJean-Baptiste Queru <jbq@google.com>2012-04-19 16:41:15 -0700
committerJean-Baptiste Queru <jbq@google.com>2012-04-20 07:06:47 -0700
commitf1694d3896950c9248fd220e0e45073b7c991235 (patch)
tree251aab3e116d1755693e980c010176a778d0559b
parent6c032a9ebdb60a3b2dfc2bb6d8b2c41a6c846ad9 (diff)
downloadsource.android.com-f1694d3896950c9248fd220e0e45073b7c991235.tar.gz
Document known issues with TCP/IP settings
Change-Id: I8c4ef16491fd4edf2cdd54b567881ed3b1f1db74
-rw-r--r--src/source/known-issues.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/src/source/known-issues.md b/src/source/known-issues.md
index be5a846a..4fa1beaf 100644
--- a/src/source/known-issues.md
+++ b/src/source/known-issues.md
@@ -114,6 +114,18 @@ Note that this will only work as long as the servers' addresses
don't change, and if they do and you can't connect you'll have
to resolve those hostnames again and edit `etc/hosts` accordingly.
+## Difficulties syncing the source tree (TCP issues). ##
+
+**Symptom**: `repo sync` hangs while syncing, often when it's
+completed 99% of the sync.
+
+**Cause**: Some settings in the TCP/IP stack cause difficulties
+in some network environments, such that `repo sync` neither completes
+nor fails.
+
+**Fix**: On linux, `sysctl -w net.ipv4.tcp_window_scaling=0`. On
+MacOS, disable the rfc1323 extension in the network settings.
+
## `make snod` and emulator builds. ##
**Symptom**: When using `make snod` (make system no dependencies)