diff options
author | Fabricio Voznika <fvoznika@google.com> | 2019-04-16 15:44:35 -0700 |
---|---|---|
committer | Adin Scannell <adin@scannell.ca> | 2019-04-17 12:08:36 -0700 |
commit | 45028bdd82ca3f54d8bb0e99330b1bab6e64cb78 (patch) | |
tree | 705873e3fbcb4b10ffd6fe22840cbe40647cf5ee | |
parent | 80036845c18e1e41e3610cf2ff4a25345f444070 (diff) |
Update Linux version requirement for GSO
-rw-r--r-- | config.toml | 2 | ||||
-rw-r--r-- | content/docs/user_guide/FAQ.md | 4 | ||||
-rw-r--r-- | content/docs/user_guide/docker.md | 4 | ||||
-rw-r--r-- | content/docs/user_guide/networking.md | 22 | ||||
-rw-r--r-- | content/docs/user_guide/oci.md | 4 |
5 files changed, 32 insertions, 4 deletions
diff --git a/config.toml b/config.toml index 0539093be..7c30f13fe 100644 --- a/config.toml +++ b/config.toml @@ -139,4 +139,4 @@ no = 'Sorry to hear that. Please <a href="https://github.com/USERNAME/REPOSITORY desc = "Get info on the development of gVisor" [params.vars] -required_linux = "3.17+" +required_linux = "4.14.77+" 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 |