gvisor

module
v0.0.0-...-522126a Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 23, 2019 License: Apache-2.0

README

gVisor

Status gVisor chat

What is gVisor?

gVisor is a user-space kernel, written in Go, that implements a substantial portion of the Linux system surface. It includes an Open Container Initiative (OCI) runtime called runsc that provides an isolation boundary between the application and the host kernel. The runsc runtime integrates with Docker and Kubernetes, making it simple to run sandboxed containers.

Why does gVisor exist?

Containers are not a sandbox. While containers have revolutionized how we develop, package, and deploy applications, running untrusted or potentially malicious code without additional isolation is not a good idea. The efficiency and performance gains from using a single, shared kernel also mean that container escape is possible with a single vulnerability.

gVisor is a user-space kernel for containers. It limits the host kernel surface accessible to the application while still giving the application access to all the features it expects. Unlike most kernels, gVisor does not assume or require a fixed set of physical resources; instead, it leverages existing host kernel functionality and runs as a normal user-space process. In other words, gVisor implements Linux by way of Linux.

gVisor should not be confused with technologies and tools to harden containers against external threats, provide additional integrity checks, or limit the scope of access for a service. One should always be careful about what data is made available to a container.

Documentation

User documentation and technical architecture, including quick start guides, can be found at gvisor.dev.

Installing from source

gVisor currently requires x86_64 Linux to build, though support for other architectures may become available in the future.

Requirements

Make sure the following dependencies are installed:

Building

Build and install the runsc binary:

bazel build runsc
sudo cp ./bazel-bin/runsc/linux_amd64_pure_stripped/runsc /usr/local/bin

If you don't want to install bazel on your system, you can build runsc in a Docker container:

make runsc
sudo cp ./bazel-bin/runsc/linux_amd64_pure_stripped/runsc /usr/local/bin

Testing

The test suite can be run with Bazel:

bazel test //...

or in a Docker container:

make unit-tests
make tests

Using remote execution

If you have a Remote Build Execution environment, you can use it to speed up build and test cycles.

You must authenticate with the project first:

gcloud auth application-default login --no-launch-browser

Then invoke bazel with the following flags:

--config=remote
--project_id=$PROJECT
--remote_instance_name=projects/$PROJECT/instances/default_instance

You can also add those flags to your local ~/.bazelrc to avoid needing to specify them each time on the command line.

Using go get

This project uses bazel to build and manage dependencies. A synthetic go branch is maintained that is compatible with standard go tooling for convenience.

For example, to build runsc directly from this branch:

echo "module runsc" > go.mod
GO111MODULE=on go get gvisor.dev/gvisor/runsc@go
CGO_ENABLED=0 GO111MODULE=on go install gvisor.dev/gvisor/runsc

Note that this branch is supported in a best effort capacity, and direct development on this branch is not supported. Development should occur on the master branch, which is then reflected into the go branch.

Community & Governance

The governance model is documented in our community repository.

The gvisor-users mailing list and gvisor-dev mailing list are good starting points for questions and discussion.

Security Policy

See SECURITY.md.

Contributing

See Contributing.md.

Directories

Path Synopsis
benchmarks
tcp
Binary tcp_proxy is a simple TCP proxy.
 Binary tcp_proxy is a simple TCP proxy.
pkg
abi
Package abi describes the interface between a kernel and userspace.
 Package abi describes the interface between a kernel and userspace.
abi/linux
Package linux contains the constants and types needed to interface with a Linux kernel.
 Package linux contains the constants and types needed to interface with a Linux kernel.
amutex
Package amutex provides the implementation of an abortable mutex.
 Package amutex provides the implementation of an abortable mutex.
atomicbitops
Package atomicbitops provides basic bitwise operations in an atomic way.
 Package atomicbitops provides basic bitwise operations in an atomic way.
binary
Package binary translates between select fixed-sized types and a binary representation.
 Package binary translates between select fixed-sized types and a binary representation.
bits
Package bits includes all bit related types and operations.
 Package bits includes all bit related types and operations.
bpf
Package bpf provides tools for working with Berkeley Packet Filter (BPF) programs.
 Package bpf provides tools for working with Berkeley Packet Filter (BPF) programs.
compressio
Package compressio provides parallel compression and decompression, as well as optional SHA-256 hashing.
 Package compressio provides parallel compression and decompression, as well as optional SHA-256 hashing.
control/client
Package client provides a basic control client interface.
 Package client provides a basic control client interface.
control/server
Package server provides a basic control server interface.
 Package server provides a basic control server interface.
cpuid
Package cpuid provides basic functionality for creating and adjusting CPU feature sets.
 Package cpuid provides basic functionality for creating and adjusting CPU feature sets.
eventchannel
Package eventchannel contains functionality for sending any protobuf message on a socketpair.
 Package eventchannel contains functionality for sending any protobuf message on a socketpair.
fd
Package fd provides types for working with file descriptors.
 Package fd provides types for working with file descriptors.
fdchannel
Package fdchannel implements passing file descriptors between processes over Unix domain sockets.
 Package fdchannel implements passing file descriptors between processes over Unix domain sockets.
fdnotifier
Package fdnotifier contains an adapter that translates IO events (e.g., a file became readable/writable) from native FDs to the notifications in the waiter package.
 Package fdnotifier contains an adapter that translates IO events (e.g., a file became readable/writable) from native FDs to the notifications in the waiter package.
flipcall
Package flipcall implements a protocol providing Fast Local Interprocess Procedure Calls between mutually-distrusting processes.
 Package flipcall implements a protocol providing Fast Local Interprocess Procedure Calls between mutually-distrusting processes.
fspath
Package fspath provides efficient tools for working with file paths in Linux-compatible filesystem implementations.
 Package fspath provides efficient tools for working with file paths in Linux-compatible filesystem implementations.
gate
Package gate provides a usage Gate synchronization primitive.
 Package gate provides a usage Gate synchronization primitive.
ilist
Package ilist provides the implementation of intrusive linked lists.
 Package ilist provides the implementation of intrusive linked lists.
linewriter
Package linewriter provides an io.Writer which calls an emitter on each line.
 Package linewriter provides an io.Writer which calls an emitter on each line.
log
Package log implements a library for logging.
 Package log implements a library for logging.
memutil
Package memutil provides a wrapper for the memfd_create() system call.
 Package memutil provides a wrapper for the memfd_create() system call.
metric
Package metric provides primitives for collecting metrics.
 Package metric provides primitives for collecting metrics.
p9
Package p9 is a 9P2000.L implementation.
 Package p9 is a 9P2000.L implementation.
p9/p9test
Package p9test provides standard mocks for p9.
 Package p9test provides standard mocks for p9.
procid
Package procid provides a way to get the current system thread identifier.
 Package procid provides a way to get the current system thread identifier.
rand
Package rand implements a cryptographically secure pseudorandom number generator.
 Package rand implements a cryptographically secure pseudorandom number generator.
refs
Package refs defines an interface for reference counted objects.
 Package refs defines an interface for reference counted objects.
secio
Package secio provides support for sectioned I/O.
 Package secio provides support for sectioned I/O.
segment
Package segment provides tools for working with collections of segments.
 Package segment provides tools for working with collections of segments.
segment/test
sentry/arch
Package arch provides abstractions around architecture-dependent details, such as syscall calling conventions, native types, etc.
 Package arch provides abstractions around architecture-dependent details, such as syscall calling conventions, native types, etc.
sentry/context
Package context defines an internal context type.
 Package context defines an internal context type.
sentry/context/contexttest
Package contexttest builds a test context.Context.
 Package contexttest builds a test context.Context.
sentry/control
Package control contains types that expose control server methods, and can be used to configure and interact with a running sandbox process.
 Package control contains types that expose control server methods, and can be used to configure and interact with a running sandbox process.
sentry/device
Package device defines reserved virtual kernel devices and structures for managing them.
 Package device defines reserved virtual kernel devices and structures for managing them.
sentry/fs
Package fs implements a virtual filesystem layer.
 Package fs implements a virtual filesystem layer.
sentry/fs/anon
Package anon implements an anonymous inode, useful for implementing inodes for pseudo filesystems.
 Package anon implements an anonymous inode, useful for implementing inodes for pseudo filesystems.
sentry/fs/dev
Package dev provides a filesystem with simple devices.
 Package dev provides a filesystem with simple devices.
sentry/fs/fdpipe
Package fdpipe implements common namedpipe opening and accessing logic.
 Package fdpipe implements common namedpipe opening and accessing logic.
sentry/fs/filetest
Package filetest provides a test implementation of an fs.File.
 Package filetest provides a test implementation of an fs.File.
sentry/fs/fsutil
Package fsutil provides utilities for implementing fs.InodeOperations and fs.FileOperations: - For embeddable utilities, see inode.go and file.go.
 Package fsutil provides utilities for implementing fs.InodeOperations and fs.FileOperations: - For embeddable utilities, see inode.go and file.go.
sentry/fs/gofer
Package gofer implements a remote 9p filesystem.
 Package gofer implements a remote 9p filesystem.
sentry/fs/host
Package host implements an fs.Filesystem for files backed by host file descriptors.
 Package host implements an fs.Filesystem for files backed by host file descriptors.
sentry/fs/lock
Package lock is the API for POSIX-style advisory regional file locks and BSD-style full file locks.
 Package lock is the API for POSIX-style advisory regional file locks and BSD-style full file locks.
sentry/fs/proc
Package proc implements a partial in-memory file system for profs.
 Package proc implements a partial in-memory file system for profs.
sentry/fs/proc/device
Package device contains the proc device to avoid dependency loops.
 Package device contains the proc device to avoid dependency loops.
sentry/fs/proc/seqfile
Package seqfile provides dynamic ordered files.
 Package seqfile provides dynamic ordered files.
sentry/fs/ramfs
Package ramfs provides the fundamentals for a simple in-memory filesystem.
 Package ramfs provides the fundamentals for a simple in-memory filesystem.
sentry/fs/sys
Package sys implements a sysfs filesystem.
 Package sys implements a sysfs filesystem.
sentry/fs/timerfd
Package timerfd implements the semantics of Linux timerfd objects as described by timerfd_create(2).
 Package timerfd implements the semantics of Linux timerfd objects as described by timerfd_create(2).
sentry/fs/tmpfs
Package tmpfs is a filesystem implementation backed by memory.
 Package tmpfs is a filesystem implementation backed by memory.
sentry/fs/tty
Package tty provide pseudoterminals via a devpts filesystem.
 Package tty provide pseudoterminals via a devpts filesystem.
sentry/fsimpl/ext
Package ext implements readonly ext(2/3/4) filesystems.
 Package ext implements readonly ext(2/3/4) filesystems.
sentry/fsimpl/ext/disklayout
Package disklayout provides Linux ext file system's disk level structures which can be directly read into from the underlying device.
 Package disklayout provides Linux ext file system's disk level structures which can be directly read into from the underlying device.
sentry/fsimpl/kernfs
Package kernfs provides the tools to implement inode-based filesystems.
 Package kernfs provides the tools to implement inode-based filesystems.
sentry/fsimpl/memfs
Package memfs provides a filesystem implementation that behaves like tmpfs: the Dentry tree is the sole source of truth for the state of the filesystem.
 Package memfs provides a filesystem implementation that behaves like tmpfs: the Dentry tree is the sole source of truth for the state of the filesystem.
sentry/fsimpl/proc
Package proc implements a partial in-memory file system for procfs.
 Package proc implements a partial in-memory file system for procfs.
sentry/hostcpu
Package hostcpu provides utilities for working with CPU information provided by a host Linux kernel.
 Package hostcpu provides utilities for working with CPU information provided by a host Linux kernel.
sentry/hostmm
Package hostmm provides tools for interacting with the host Linux kernel's virtual memory management subsystem.
 Package hostmm provides tools for interacting with the host Linux kernel's virtual memory management subsystem.
sentry/inet
Package inet defines semantics for IP stacks.
 Package inet defines semantics for IP stacks.
sentry/kernel
Package kernel provides an emulation of the Linux kernel.
 Package kernel provides an emulation of the Linux kernel.
sentry/kernel/auth
Package auth implements an access control model that is a subset of Linux's.
 Package auth implements an access control model that is a subset of Linux's.
sentry/kernel/contexttest
Package contexttest provides a test context.Context which includes a dummy kernel pointing to a valid platform.
 Package contexttest provides a test context.Context which includes a dummy kernel pointing to a valid platform.
sentry/kernel/epoll
Package epoll provides an implementation of Linux's IO event notification facility.
 Package epoll provides an implementation of Linux's IO event notification facility.
sentry/kernel/eventfd
Package eventfd provides an implementation of Linux's file-based event notification.
 Package eventfd provides an implementation of Linux's file-based event notification.
sentry/kernel/fasync
Package fasync provides FIOASYNC related functionality.
 Package fasync provides FIOASYNC related functionality.
sentry/kernel/futex
Package futex provides an implementation of the futex interface as found in the Linux kernel.
 Package futex provides an implementation of the futex interface as found in the Linux kernel.
sentry/kernel/memevent
Package memevent implements the memory usage events controller, which periodically emits events via the eventchannel.
 Package memevent implements the memory usage events controller, which periodically emits events via the eventchannel.
sentry/kernel/pipe
Package pipe provides a pipe implementation.
 Package pipe provides a pipe implementation.
sentry/kernel/sched
Package sched implements scheduler related features.
 Package sched implements scheduler related features.
sentry/kernel/semaphore
Package semaphore implements System V semaphores.
 Package semaphore implements System V semaphores.
sentry/kernel/shm
Package shm implements sysv shared memory segments.
 Package shm implements sysv shared memory segments.
sentry/kernel/signalfd
Package signalfd provides an implementation of signal file descriptors.
 Package signalfd provides an implementation of signal file descriptors.
sentry/kernel/time
Package time defines the Timer type, which provides a periodic timer that works by sampling a user-provided clock.
 Package time defines the Timer type, which provides a periodic timer that works by sampling a user-provided clock.
sentry/limits
Package limits provides resource limits.
 Package limits provides resource limits.
sentry/loader
Package loader loads an executable file into a MemoryManager.
 Package loader loads an executable file into a MemoryManager.
sentry/memmap
Package memmap defines semantics for memory mappings.
 Package memmap defines semantics for memory mappings.
sentry/mm
Package mm provides a memory management subsystem.
 Package mm provides a memory management subsystem.
sentry/pgalloc
Package pgalloc contains the page allocator subsystem, which manages memory that may be mapped into application address spaces.
 Package pgalloc contains the page allocator subsystem, which manages memory that may be mapped into application address spaces.
sentry/platform
Package platform provides a Platform abstraction.
 Package platform provides a Platform abstraction.
sentry/platform/interrupt
Package interrupt provides an interrupt helper.
 Package interrupt provides an interrupt helper.
sentry/platform/kvm
Package kvm provides a kvm-based implementation of the platform interface.
 Package kvm provides a kvm-based implementation of the platform interface.
sentry/platform/kvm/testutil
Package testutil provides common assembly stubs for testing.
 Package testutil provides common assembly stubs for testing.
sentry/platform/ptrace
Package ptrace provides a ptrace-based implementation of the platform interface.
 Package ptrace provides a ptrace-based implementation of the platform interface.
sentry/platform/ring0
Package ring0 provides basic operating system-level stubs.
 Package ring0 provides basic operating system-level stubs.
sentry/platform/ring0/gen_offsets
Binary gen_offsets is a helper for generating offset headers.
 Binary gen_offsets is a helper for generating offset headers.
sentry/platform/ring0/pagetables
Package pagetables provides a generic implementation of pagetables.
 Package pagetables provides a generic implementation of pagetables.
sentry/platform/safecopy
Package safecopy provides an efficient implementation of functions to access memory that may result in SIGSEGV or SIGBUS being sent to the accessor.
 Package safecopy provides an efficient implementation of functions to access memory that may result in SIGSEGV or SIGBUS being sent to the accessor.
sentry/safemem
Package safemem provides the Block and BlockSeq types.
 Package safemem provides the Block and BlockSeq types.
sentry/sighandling
Package sighandling contains helpers for handling signals to applications.
 Package sighandling contains helpers for handling signals to applications.
sentry/socket
Package socket provides the interfaces that need to be provided by socket implementations and providers, as well as per family demultiplexing of socket creation.
 Package socket provides the interfaces that need to be provided by socket implementations and providers, as well as per family demultiplexing of socket creation.
sentry/socket/control
Package control provides internal representations of socket control messages.
 Package control provides internal representations of socket control messages.
sentry/socket/hostinet
Package hostinet implements AF_INET and AF_INET6 sockets using the host's network stack.
 Package hostinet implements AF_INET and AF_INET6 sockets using the host's network stack.
sentry/socket/netfilter
Package netfilter helps the sentry interact with netstack's netfilter capabilities.
 Package netfilter helps the sentry interact with netstack's netfilter capabilities.
sentry/socket/netlink
Package netlink provides core functionality for netlink sockets.
 Package netlink provides core functionality for netlink sockets.
sentry/socket/netlink/port
Package port provides port ID allocation for netlink sockets.
 Package port provides port ID allocation for netlink sockets.
sentry/socket/netlink/route
Package route provides a NETLINK_ROUTE socket protocol.
 Package route provides a NETLINK_ROUTE socket protocol.
sentry/socket/netlink/uevent
Package uevent provides a NETLINK_KOBJECT_UEVENT socket protocol.
 Package uevent provides a NETLINK_KOBJECT_UEVENT socket protocol.
sentry/socket/netstack
Package netstack provides an implementation of the socket.Socket interface that is backed by a tcpip.Endpoint.
 Package netstack provides an implementation of the socket.Socket interface that is backed by a tcpip.Endpoint.
sentry/socket/rpcinet
Package rpcinet implements sockets using an RPC for each syscall.
 Package rpcinet implements sockets using an RPC for each syscall.
sentry/socket/rpcinet/conn
Package conn is an RPC connection to a syscall RPC server.
 Package conn is an RPC connection to a syscall RPC server.
sentry/socket/rpcinet/notifier
Package notifier implements an FD notifier implementation over RPC.
 Package notifier implements an FD notifier implementation over RPC.
sentry/socket/unix
Package unix provides an implementation of the socket.Socket interface for the AF_UNIX protocol family.
 Package unix provides an implementation of the socket.Socket interface for the AF_UNIX protocol family.
sentry/socket/unix/transport
Package transport contains the implementation of Unix endpoints.
 Package transport contains the implementation of Unix endpoints.
sentry/state
Package state provides high-level state wrappers.
 Package state provides high-level state wrappers.
sentry/strace
Package strace implements the logic to print out the input and the return value of each traced syscall.
 Package strace implements the logic to print out the input and the return value of each traced syscall.
sentry/syscalls
Package syscalls is the interface from the application to the kernel.
 Package syscalls is the interface from the application to the kernel.
sentry/syscalls/linux
Package linux provides syscall tables for amd64 Linux.
 Package linux provides syscall tables for amd64 Linux.
sentry/time
Package time provides a calibrated clock synchronized to a system reference clock.
 Package time provides a calibrated clock synchronized to a system reference clock.
sentry/unimpl
Package unimpl contains interface to emit events about unimplemented features.
 Package unimpl contains interface to emit events about unimplemented features.
sentry/uniqueid
Package uniqueid defines context.Context keys for obtaining system-wide unique identifiers.
 Package uniqueid defines context.Context keys for obtaining system-wide unique identifiers.
sentry/usage
Package usage provides representations of resource usage.
 Package usage provides representations of resource usage.
sentry/usermem
Package usermem governs access to user memory.
 Package usermem governs access to user memory.
sentry/vfs
Package vfs implements a virtual filesystem layer.
 Package vfs implements a virtual filesystem layer.
sentry/watchdog
Package watchdog is responsible for monitoring the sentry for tasks that may potentially be stuck or looping inderterminally causing hard to debug hungs in the untrusted app.
 Package watchdog is responsible for monitoring the sentry for tasks that may potentially be stuck or looping inderterminally causing hard to debug hungs in the untrusted app.
sleep
state
Package state provides functionality related to saving and loading object graphs.
 Package state provides functionality related to saving and loading object graphs.
state/statefile
Package statefile defines the state file data stream.
 Package statefile defines the state file data stream.
syserr
Package syserr contains sandbox-internal errors.
 Package syserr contains sandbox-internal errors.
syserror
Package syserror contains syscall error codes exported as error interface instead of Errno.
 Package syserror contains syscall error codes exported as error interface instead of Errno.
tcpip
Package tcpip provides the interfaces and related types that users of the tcpip stack will use in order to create endpoints used to send and receive data over the network stack.
 Package tcpip provides the interfaces and related types that users of the tcpip stack will use in order to create endpoints used to send and receive data over the network stack.
tcpip/adapters/gonet
Package gonet provides a Go net package compatible wrapper for a tcpip stack.
 Package gonet provides a Go net package compatible wrapper for a tcpip stack.
tcpip/buffer
Package buffer provides the implementation of a buffer view.
 Package buffer provides the implementation of a buffer view.
tcpip/checker
Package checker provides helper functions to check networking packets for validity.
 Package checker provides helper functions to check networking packets for validity.
tcpip/hash/jenkins
Package jenkins implements Jenkins's one_at_a_time, non-cryptographic hash functions created by by Bob Jenkins.
 Package jenkins implements Jenkins's one_at_a_time, non-cryptographic hash functions created by by Bob Jenkins.
tcpip/header
Package header provides the implementation of the encoding and decoding of network protocol headers.
 Package header provides the implementation of the encoding and decoding of network protocol headers.
tcpip/iptables
Package iptables supports packet filtering and manipulation via the iptables tool.
 Package iptables supports packet filtering and manipulation via the iptables tool.
tcpip/link/channel
Package channel provides the implemention of channel-based data-link layer endpoints.
 Package channel provides the implemention of channel-based data-link layer endpoints.
tcpip/link/fdbased
Package fdbased provides the implemention of data-link layer endpoints backed by boundary-preserving file descriptors (e.g., TUN devices, seqpacket/datagram sockets).
 Package fdbased provides the implemention of data-link layer endpoints backed by boundary-preserving file descriptors (e.g., TUN devices, seqpacket/datagram sockets).
tcpip/link/loopback
Package loopback provides the implemention of loopback data-link layer endpoints.
 Package loopback provides the implemention of loopback data-link layer endpoints.
tcpip/link/muxed
Package muxed provides a muxed link endpoints.
 Package muxed provides a muxed link endpoints.
tcpip/link/rawfile
Package rawfile contains utilities for using the netstack with raw host files on Linux hosts.
 Package rawfile contains utilities for using the netstack with raw host files on Linux hosts.
tcpip/link/sharedmem
Package sharedmem provides the implemention of data-link layer endpoints backed by shared memory.
 Package sharedmem provides the implemention of data-link layer endpoints backed by shared memory.
tcpip/link/sharedmem/pipe
Package pipe implements a shared memory ring buffer on which a single reader and a single writer can operate (read/write) concurrently.
 Package pipe implements a shared memory ring buffer on which a single reader and a single writer can operate (read/write) concurrently.
tcpip/link/sharedmem/queue
Package queue provides the implementation of transmit and receive queues based on shared memory ring buffers.
 Package queue provides the implementation of transmit and receive queues based on shared memory ring buffers.
tcpip/link/sniffer
Package sniffer provides the implementation of data-link layer endpoints that wrap another endpoint and logs inbound and outbound packets.
 Package sniffer provides the implementation of data-link layer endpoints that wrap another endpoint and logs inbound and outbound packets.
tcpip/link/tun
Package tun contains methods to open TAP and TUN devices.
 Package tun contains methods to open TAP and TUN devices.
tcpip/link/waitable
Package waitable provides the implementation of data-link layer endpoints that wrap other endpoints, and can wait for inflight calls to WritePacket or DeliverNetworkPacket to finish (and new ones to be prevented).
 Package waitable provides the implementation of data-link layer endpoints that wrap other endpoints, and can wait for inflight calls to WritePacket or DeliverNetworkPacket to finish (and new ones to be prevented).
tcpip/network/arp
Package arp implements the ARP network protocol.
 Package arp implements the ARP network protocol.
tcpip/network/fragmentation
Package fragmentation contains the implementation of IP fragmentation.
 Package fragmentation contains the implementation of IP fragmentation.
tcpip/network/hash
Package hash contains utility functions for hashing.
 Package hash contains utility functions for hashing.
tcpip/network/ipv4
Package ipv4 contains the implementation of the ipv4 network protocol.
 Package ipv4 contains the implementation of the ipv4 network protocol.
tcpip/network/ipv6
Package ipv6 contains the implementation of the ipv6 network protocol.
 Package ipv6 contains the implementation of the ipv6 network protocol.
tcpip/ports
Package ports provides PortManager that manages allocating, reserving and releasing ports.
 Package ports provides PortManager that manages allocating, reserving and releasing ports.
tcpip/sample/tun_tcp_connect
This sample creates a stack with TCP and IPv4 protocols on top of a TUN device, and connects to a peer.
 This sample creates a stack with TCP and IPv4 protocols on top of a TUN device, and connects to a peer.
tcpip/sample/tun_tcp_echo
This sample creates a stack with TCP and IPv4 protocols on top of a TUN device, and listens on a port.
 This sample creates a stack with TCP and IPv4 protocols on top of a TUN device, and listens on a port.
tcpip/seqnum
Package seqnum defines the types and methods for TCP sequence numbers such that they fit in 32-bit words and work properly when overflows occur.
 Package seqnum defines the types and methods for TCP sequence numbers such that they fit in 32-bit words and work properly when overflows occur.
tcpip/stack
Package stack provides the glue between networking protocols and the consumers of the networking stack.
 Package stack provides the glue between networking protocols and the consumers of the networking stack.
tcpip/transport/icmp
Package icmp contains the implementation of the ICMP and IPv6-ICMP transport protocols for use in ping.
 Package icmp contains the implementation of the ICMP and IPv6-ICMP transport protocols for use in ping.
tcpip/transport/packet
Package packet provides the implementation of packet sockets (see packet(7)).
 Package packet provides the implementation of packet sockets (see packet(7)).
tcpip/transport/raw
Package raw provides the implementation of raw sockets (see raw(7)).
 Package raw provides the implementation of raw sockets (see raw(7)).
tcpip/transport/tcp
Package tcp contains the implementation of the TCP transport protocol.
 Package tcp contains the implementation of the TCP transport protocol.
tcpip/transport/tcp/testing/context
Package context provides a test context for use in tcp tests.
 Package context provides a test context for use in tcp tests.
tcpip/transport/tcpconntrack
Package tcpconntrack implements a TCP connection tracking object.
 Package tcpconntrack implements a TCP connection tracking object.
tcpip/transport/udp
Package udp contains the implementation of the UDP transport protocol.
 Package udp contains the implementation of the UDP transport protocol.
tmutex
Package tmutex provides the implementation of a mutex that implements an efficient TryLock function in addition to Lock and Unlock.
 Package tmutex provides the implementation of a mutex that implements an efficient TryLock function in addition to Lock and Unlock.
unet
Package unet provides a minimal net package based on Unix Domain Sockets.
 Package unet provides a minimal net package based on Unix Domain Sockets.
urpc
Package urpc provides a minimal RPC package based on unet.
 Package urpc provides a minimal RPC package based on unet.
waiter
Package waiter provides the implementation of a wait queue, where waiters can be enqueued to be notified when an event of interest happens.
 Package waiter provides the implementation of a wait queue, where waiters can be enqueued to be notified when an event of interest happens.
Binary runsc is an implementation of the Open Container Initiative Runtime that runs applications inside a sandbox.
 Binary runsc is an implementation of the Open Container Initiative Runtime that runs applications inside a sandbox.
boot
Package boot loads the kernel and runs a container.
 Package boot loads the kernel and runs a container.
boot/filter
Package filter defines all syscalls the sandbox is allowed to make to the host, and installs seccomp filters to prevent prohibited syscalls in case it's compromised.
 Package filter defines all syscalls the sandbox is allowed to make to the host, and installs seccomp filters to prevent prohibited syscalls in case it's compromised.
boot/platforms
Package platforms imports all available platform packages.
 Package platforms imports all available platform packages.
cgroup
Package cgroup provides an interface to read and write configuration to cgroup.
 Package cgroup provides an interface to read and write configuration to cgroup.
cmd
Package cmd holds implementations of the runsc commands.
 Package cmd holds implementations of the runsc commands.
console
Package console contains utilities for working with pty consols in runsc.
 Package console contains utilities for working with pty consols in runsc.
container
Package container creates and manipulates containers.
 Package container creates and manipulates containers.
container/test_app
Binary test_app is like a swiss knife for tests that need to run anything inside the sandbox.
 Binary test_app is like a swiss knife for tests that need to run anything inside the sandbox.
criutil
Package criutil contains utility functions for interacting with the Container Runtime Interface (CRI), principally via the crictl command line tool.
 Package criutil contains utility functions for interacting with the Container Runtime Interface (CRI), principally via the crictl command line tool.
dockerutil
Package dockerutil is a collection of utility functions, primarily for testing.
 Package dockerutil is a collection of utility functions, primarily for testing.
fsgofer
Package fsgofer implements p9.File giving access to local files using a simple mapping from a path prefix that is added to the path requested by the sandbox.
 Package fsgofer implements p9.File giving access to local files using a simple mapping from a path prefix that is added to the path requested by the sandbox.
fsgofer/filter
Package filter defines all syscalls the gofer is allowed to make, and installs seccomp filters to prevent prohibited syscalls in case it's compromised.
 Package filter defines all syscalls the gofer is allowed to make, and installs seccomp filters to prevent prohibited syscalls in case it's compromised.
sandbox
Package sandbox creates and manipulates sandboxes.
 Package sandbox creates and manipulates sandboxes.
specutils
Package specutils contains utility functions for working with OCI runtime specs.
 Package specutils contains utility functions for working with OCI runtime specs.
testutil
Package testutil contains utility functions for runsc tests.
 Package testutil contains utility functions for runsc tests.
test
e2e
Package integration is empty.
 Package integration is empty.
image
Package image is empty.
 Package image is empty.
iptables
Package iptables contains a set of iptables tests implemented as TestCases
 Package iptables contains a set of iptables tests implemented as TestCases
iptables/runner
Package main runs iptables tests from within a docker container.
 Package main runs iptables tests from within a docker container.
root
Package root is used for tests that requires sysadmin privileges run.
 Package root is used for tests that requires sysadmin privileges run.
runtimes
Binary runner runs the runtime tests in a Docker container.
 Binary runner runs the runtime tests in a Docker container.
runtimes/images/proctor
Binary proctor runs the test for a particular runtime.
 Binary proctor runs the test for a particular runtime.
syscalls
Binary syscall_test_runner runs the syscall test suites in gVisor containers and on the host platform.
 Binary syscall_test_runner runs the syscall test suites in gVisor containers and on the host platform.
syscalls/gtest
Package gtest contains helpers for running google-test tests from Go.
 Package gtest contains helpers for running google-test tests from Go.
uds
Package uds contains helpers for testing external UDS functionality.
 Package uds contains helpers for testing external UDS functionality.
tools
checkunsafe
Package checkunsafe allows unsafe imports only in files named appropriately.
 Package checkunsafe allows unsafe imports only in files named appropriately.
go_generics
go_generics reads a Go source file and writes a new version of that file with a few transformations applied to each.
 go_generics reads a Go source file and writes a new version of that file with a few transformations applied to each.
go_generics/generics_tests/all_stmts
go_generics/generics_tests/all_stmts/output
go_generics/generics_tests/all_types
go_generics/generics_tests/all_types/lib
go_generics/generics_tests/all_types/output
go_generics/generics_tests/anon
go_generics/generics_tests/anon/output
go_generics/generics_tests/consts
go_generics/generics_tests/consts/output
go_generics/generics_tests/imports
go_generics/generics_tests/imports/output
go_generics/generics_tests/remove_typedef
go_generics/generics_tests/remove_typedef/output
go_generics/generics_tests/simple
go_generics/generics_tests/simple/output
go_generics/globals
Package globals provides an AST visitor that calls the visit function for all global identifiers.
 Package globals provides an AST visitor that calls the visit function for all global identifiers.
go_generics/go_merge
go_generics/rules_tests
go_marshal
go_marshal is a code generation utility for automatically generating code to marshal go data structures to memory.
 go_marshal is a code generation utility for automatically generating code to marshal go data structures to memory.
go_marshal/analysis
Package analysis implements common functionality used by generated go_marshal tests.
 Package analysis implements common functionality used by generated go_marshal tests.
go_marshal/gomarshal
Package gomarshal implements the go_marshal code generator.
 Package gomarshal implements the go_marshal code generator.
go_marshal/marshal
Package marshal defines the Marshallable interface for serialize/deserializing go data structures to/from memory, according to the Linux ABI.
 Package marshal defines the Marshallable interface for serialize/deserializing go data structures to/from memory, according to the Linux ABI.
go_marshal/test
Package test contains data structures for testing the go_marshal tool.
 Package test contains data structures for testing the go_marshal tool.
go_marshal/test/external
Package external defines types we can import for testing.
 Package external defines types we can import for testing.
go_stateify
Stateify provides a simple way to generate Load/Save methods based on existing types and struct tags.
 Stateify provides a simple way to generate Load/Save methods based on existing types and struct tags.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.