summaryrefslogtreecommitdiffhomepage
path: root/content/docs
diff options
context:
space:
mode:
authorFabricio Voznika <fvoznika@google.com>2019-04-16 15:44:35 -0700
committerAdin Scannell <adin@scannell.ca>2019-04-17 12:08:36 -0700
commit45028bdd82ca3f54d8bb0e99330b1bab6e64cb78 (patch)
tree705873e3fbcb4b10ffd6fe22840cbe40647cf5ee /content/docs
parent80036845c18e1e41e3610cf2ff4a25345f444070 (diff)
Update Linux version requirement for GSO
Diffstat (limited to 'content/docs')
-rw-r--r--content/docs/user_guide/FAQ.md4
-rw-r--r--content/docs/user_guide/docker.md4
-rw-r--r--content/docs/user_guide/networking.md22
-rw-r--r--content/docs/user_guide/oci.md4
4 files changed, 31 insertions, 3 deletions
diff --git a/content/docs/user_guide/FAQ.md b/content/docs/user_guide/FAQ.md
index da881f171..3226da8b1 100644
--- a/content/docs/user_guide/FAQ.md
+++ b/content/docs/user_guide/FAQ.md
@@ -5,7 +5,7 @@ weight = 1000
### What operating systems are supported?
-gVisor requires Linux {{< required_linux >}}.
+gVisor requires Linux {{< required_linux >}} ([older Linux][old-linux]).
### What CPU architectures are supported?
@@ -57,3 +57,5 @@ directories.
### What's the security model?
See the [Security Model](../../architecture_guide/security/).
+
+[old-linux]: /docs/user_guide/networking/#gso
diff --git a/content/docs/user_guide/docker.md b/content/docs/user_guide/docker.md
index 4b8f3acb6..99cb766ff 100644
--- a/content/docs/user_guide/docker.md
+++ b/content/docs/user_guide/docker.md
@@ -7,7 +7,8 @@ gVisor.
## Install gVisor
-> Note: gVisor supports only x86\_64 and requires Linux {{< required_linux >}}.
+> Note: gVisor supports only x86\_64 and requires Linux {{< required_linux >}}
+> ([older Linux][old-linux]).
{{% readfile file="docs/includes/install_gvisor.md" markdown="true" %}}
@@ -87,4 +88,5 @@ Next, look at the different options available for gVisor: [platform](../platform
[network](../networking/), [filesystem](../filesystem/).
[docker]: https://docs.docker.com/install/
+[old-linux]: /docs/user_guide/networking/#gso
[storage-driver]: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-storage-driver
diff --git a/content/docs/user_guide/networking.md b/content/docs/user_guide/networking.md
index f1aa77625..92447b3fb 100644
--- a/content/docs/user_guide/networking.md
+++ b/content/docs/user_guide/networking.md
@@ -60,4 +60,26 @@ Add the following `runtimeArgs` to your Docker configuration
}
```
+### Disable GSO {#gso}
+
+If your Linux is older than {{< required_linux >}}, you can disable Generic
+Segmentation Offload (GSO) to run with a kernel that is newer than 3.17. Add the
+`--gso=false` flag to your Docker runtime configuration (`/etc/docker/daemon.json`)
+and restart the Docker daemon:
+
+> Note: Network performance, especially for large payloads, will be greatly reduced.
+
+```json
+{
+ "runtimes": {
+ "runsc": {
+ "path": "/usr/local/bin/runsc",
+ "runtimeArgs": [
+ "--gso=false"
+ ]
+ }
+ }
+}
+```
+
[netstack]: https://github.com/google/netstack
diff --git a/content/docs/user_guide/oci.md b/content/docs/user_guide/oci.md
index cfde696e9..288575fc4 100644
--- a/content/docs/user_guide/oci.md
+++ b/content/docs/user_guide/oci.md
@@ -7,7 +7,8 @@ container using the runtime directly with the default platform.
## Install gVisor
-> Note: gVisor supports only x86\_64 and requires Linux {{< required_linux >}}.
+> Note: gVisor supports only x86\_64 and requires Linux {{< required_linux >}}
+> ([older Linux][old-linux]).
{{% readfile file="docs/includes/install_gvisor.md" markdown="true" %}}
@@ -47,3 +48,4 @@ sudo runsc run hello
Next try [running gVisor using Docker](../docker/).
[oci]: https://opencontainers.org/
+[old-linux]: /docs/user_guide/networking/#gso