summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAvery Pennarun <apenwarr@gmail.com>2011-02-26 17:23:11 -0800
committerAvery Pennarun <apenwarr@gmail.com>2011-02-26 17:23:11 -0800
commitc3399595d2919934e58b5a5db1d7f3d5eeae5803 (patch)
treec6c627cceca8185e06f11962303bd1bae07e6830
parent6ef9ae1796659630e2d35082d83ab766c443751a (diff)
README/sshuttle.1: add a note about the MacOS kernel bug.
And its side effects. Reported by David Held / Antonio d'Souza.
-rw-r--r--README.md11
-rw-r--r--sshuttle.md11
2 files changed, 22 insertions, 0 deletions
diff --git a/README.md b/README.md
index 6762f72..3119245 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,14 @@
+
+WARNING:
+On MacOS 10.6 (at least up to 10.6.6), your network will
+stop responding about 10 minutes after the first time you
+start sshuttle, because of a MacOS kernel bug relating to
+arp and the net.inet.ip.scopedroute sysctl. To fix it,
+just switch your wireless off and on. Sshuttle makes the
+kernel setting it changes permanent, so this won't happen
+again, even after a reboot.
+
+
sshuttle: where transparent proxy meets VPN meets ssh
=====================================================
diff --git a/sshuttle.md b/sshuttle.md
index 6168740..16bedda 100644
--- a/sshuttle.md
+++ b/sshuttle.md
@@ -253,6 +253,17 @@ between the two separate streams, so a tcp-based tunnel is
fine.
+# BUGS
+
+On MacOS 10.6 (at least up to 10.6.6), your network will
+stop responding about 10 minutes after the first time you
+start sshuttle, because of a MacOS kernel bug relating to
+arp and the net.inet.ip.scopedroute sysctl. To fix it,
+just switch your wireless off and on. Sshuttle makes the
+kernel setting it changes permanent, so this won't happen
+again, even after a reboot.
+
+
# SEE ALSO
`ssh`(1), `python`(1)