mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-11-03 05:51:15 +02:00
feat(compute): report uBridge tc capabilities and gate filters on them
Consume uBridge's ebpf_modes contract (feature/tc-window 40c36ae): a
stateful mode is usable iff ebpf=1 and its token is listed; builds
predating the field keep their shipped modes (nth/quota/flow), so the
pre-correction window semantics can never be installed silently.
- gns3server/utils/tc_capabilities.py: shared reply parser, mode
policy and filter-type mappings (compute and controller gate on the
same rules)
- gns3server/compute/ubridge/tc_probe.py: standalone probe spawning a
throwaway uBridge as the server's own user, cached by binary
identity (path/mtime/size - the version string cannot distinguish
rebuilds); failures cache as unknown
- GET /v3/compute/capabilities gains ubridge_tc {netem, ebpf,
ebpf_modes, cbpf}; the controller forwards it (Compute.capabilities)
and available_filters hides kernel-datapath filter types an endpoint
compute cannot run (both ends apply their own filters, so one
incapable compute hides the type); computes without a report keep
the full list and apply-time 409 stays the guard
- docker: _ubridge_apply_ebpf_drops gates per mode token; the cleanup
path only sends "off" for modes the build declares
- split DockerVM's kernel-datapath machinery (veth lifecycle, carrier,
marker primitives, tc filter translation, kernel NIO teardown) into
compute/docker/docker_kernel_datapath.py (DockerKernelDatapathMixin)
This commit is contained in:
18 files changed
+1280
-571
No files matched your search
@@ -0,0 +1,85 @@
|
||||
#
|
||||
# Copyright (C) 2026 GNS3 Technologies Inc.
|
||||
#
|
||||
# This program is free software: you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation, either version 3 of the License, or
|
||||
# (at your option) any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
"""
|
||||
uBridge ``tc capabilities`` vocabulary: the reply parser and the server-side
|
||||
policy built on top of it. Shared by the compute side (the per-node probe in
|
||||
DockerVM and the standalone /capabilities probe) and the controller side
|
||||
(filter availability), so both gate on the same rules.
|
||||
|
||||
Reply shape (additive by contract — unknown keys pass through untouched):
|
||||
``netem=<kw,...>;ebpf=0|1;cbpf=0|1[;ebpf_modes=<mode,...>]``
|
||||
"""
|
||||
|
||||
# eBPF classifier modes that shipped before the ``ebpf_modes`` field existed
|
||||
# (uBridge feature/tc-precision): the field was added together with the
|
||||
# window-mode correction, so an ebpf=1 build that does not emit it has
|
||||
# exactly these. window is the only mode whose semantics changed after
|
||||
# release — it is never offered unless the build declares the token.
|
||||
LEGACY_EBPF_MODES = ("nth", "quota", "flow")
|
||||
|
||||
# GNS3 filter type -> eBPF classifier mode token
|
||||
FILTER_EBPF_MODES = {
|
||||
"frequency_drop": "nth",
|
||||
"quota": "quota",
|
||||
"window_drop": "window",
|
||||
}
|
||||
|
||||
# GNS3 filter type -> netem keyword (netem= token in the capabilities reply)
|
||||
FILTER_NETEM_KEYWORDS = {
|
||||
"rate": "rate",
|
||||
"reorder": "reorder",
|
||||
"gemodel": "gemodel",
|
||||
"duplicate": "dup",
|
||||
"seed": "seed",
|
||||
"limit": "limit",
|
||||
}
|
||||
|
||||
|
||||
def parse_tc_capabilities(reply):
|
||||
"""
|
||||
Parse the payload of a ``tc capabilities`` reply into a dict.
|
||||
|
||||
:param reply: reply payload (first reply line, no status code)
|
||||
:returns: dict of keys to values, both strings
|
||||
"""
|
||||
|
||||
caps = {}
|
||||
for entry in (reply or "").split(";"):
|
||||
key, _, value = entry.partition("=")
|
||||
if key:
|
||||
caps[key.strip()] = value.strip()
|
||||
return caps
|
||||
|
||||
|
||||
def usable_ebpf_modes(caps):
|
||||
"""
|
||||
The eBPF classifier modes this uBridge build can actually run: a mode is
|
||||
usable iff ``ebpf=1`` and its token is listed in ``ebpf_modes``. Builds
|
||||
that do not emit the field predate it and keep the modes that shipped
|
||||
with it (LEGACY_EBPF_MODES) — gating on ``ebpf=1`` alone would silently
|
||||
accept window_drop on the pre-correction build, which drops it into
|
||||
back-to-back windows.
|
||||
|
||||
:param caps: parsed ``tc capabilities`` dict
|
||||
:returns: tuple of usable mode tokens, in reply order
|
||||
"""
|
||||
|
||||
if caps.get("ebpf") != "1":
|
||||
return ()
|
||||
if "ebpf_modes" not in caps:
|
||||
return LEGACY_EBPF_MODES
|
||||
return tuple(mode for mode in caps["ebpf_modes"].split(",") if mode)
|
||||
Reference in new issue
Block a user