Expand description
Enhanced container runtime with OCI specification support, cgroup controllers, overlay filesystem, veth networking, and seccomp BPF filtering.
This module implements 7 container enhancement sprints:
- OCI Runtime Specification (config.json parsing, lifecycle, hooks, pivot_root)
- Container Image Format (layers, overlay composition, manifest, SHA-256 IDs)
- Cgroup Memory Controller (limits, usage tracking, OOM, hierarchical accounting)
- Cgroup CPU Controller (shares, quota/period, throttling, burst, hierarchy)
- Overlay Filesystem (lower/upper layers, copy-up, whiteout, directory merge)
- Veth Networking (virtual pairs, bridge, NAT masquerade, ARP proxy, MTU)
- Seccomp BPF (filter instructions, syscall filtering, arg inspection, inheritance)
Modules§
- audit_
arch - Audit architecture values.
- seccomp_
offsets - Seccomp data offsets (for x86_64 struct seccomp_data layout).
Structs§
- ArpProxy
Entry - ARP proxy entry for container IPs.
- BpfInstruction
- A single BPF instruction.
- Cached
Layer - Cgroup
CpuController - Cgroup CPU controller with shares and bandwidth limiting.
- Cgroup
Memory Controller - Cgroup memory controller.
- Container
Image - Container image: manifest + layers + config.
- CpuBandwidth
Stats - CPU bandwidth statistics.
- Image
Layer - A single layer in a container image.
- Image
Manifest - Container image manifest.
- Layer
Cache - Layer cache: stores extracted layers by their digest.
- Layer
Digest - Image layer digest (SHA-256).
- Memory
Stat - Memory statistics counters.
- NatPort
Mapping - NAT port mapping entry.
- NatTable
- NAT masquerade table for outbound SNAT and inbound port forwarding.
- OciConfig
- Parsed OCI runtime configuration (config.json equivalent).
- OciContainer
- An OCI-compliant container runtime instance.
- OciHook
- Lifecycle hook specification.
- OciHooks
- OCI hooks at different lifecycle points.
- OciLinux
Config - Linux-specific configuration.
- OciMount
- A single mount specification from the OCI config.
- OciNamespace
- A namespace entry in the OCI linux config.
- OciProcess
- Process specification from config.json.
- OciRoot
- Root filesystem specification.
- OomEvent
- OOM event information.
- Overlay
Entry - A single entry in an overlay layer.
- Overlay
Fs - Overlay filesystem combining multiple layers.
- Overlay
Layer - A single layer in the overlay filesystem.
- Seccomp
Data - Seccomp data structure matching the kernel’s struct seccomp_data.
- Seccomp
Filter - A seccomp BPF filter program.
- Seccomp
State - Per-process seccomp state.
- Veth
Bridge - Bridge configuration for container networking.
- Veth
Endpoint - Virtual Ethernet interface state.
- Veth
Pair - A virtual Ethernet pair.
Enums§
- BpfOpcode
- BPF instruction opcodes for seccomp filters.
- OciLifecycle
State - OCI container lifecycle states per the runtime-spec.
- OciNamespace
Kind - Linux namespace configuration from the OCI config.
- Overlay
Entry Kind - Entry type in the overlay filesystem.
- Seccomp
Action - Seccomp return action values.
- Seccomp
Mode - Seccomp operating modes.
Functions§
- create_
veth_ pair - Create a veth pair with generated MACs.
- generate_
veth_ mac - Generate a deterministic MAC address from a veth pair ID.
- is_gzip
- Gzip detection: check for gzip magic bytes (0x1f, 0x8b).
- parse_
tar_ filename - TAR header: first 100 bytes are the filename, bytes 124-135 are octal size.
- parse_
tar_ size - Parse octal size from TAR header bytes 124..135.