Function do_ptp_detect

network_diagnostics.py:1793–1825

Detect PTP (IEEE-1588 / PTPv2) on a segment by sniffing the PTP event/ general UDP ports and the 802.1AS ethertype. Reports whether a grandmaster is announcing, which message types are present, and the domain(s). Precise clock-offset needs ptp4l running; this is the field 'is PTP here?'

(interface, seconds=8)

            out.append({'name': name, 'members': _bridge_members(name)})
    return out


def _wired_nics():
    """Physical wired NICs eligible to be bridged (eth*/en*/usb*), excluding the
    default-route interface and anything already in a non-snoop bridge."""
    names = []
    for n in _list_iface_names(include_virtual=False):
        if _DHCP_SNOOP_WIRED_RE.match(n) and not _is_wireless(n):
            names.append(n)
    return names


def do_dhcp_snoop_config(trusted=None, untrusted=None):
    """Get or set the trusted/untrusted port designation (persisted). Pass both
    to set; pass neither to just read."""
    with _dhcp_snoop_lock:
        cfg = _dhcp_snoop_load()
        if trusted is not None and untrusted is not None:
            if not _valid_iface(trusted) or not _valid_iface(untrusted):
                return {'success': False, 'error': 'invalid interface name'}
            if trusted == untrusted:
                return {'success': False, 'error': 'trusted and untrusted must differ'}
            cfg['trusted'] = trusted
            cfg['untrusted'] = untrusted
            _dhcp_snoop_save(cfg)
        return {'success': True, 'trusted': cfg.get('trusted'),
                'untrusted': cfg.get('untrusted')}


def do_dhcp_snoop_status():
    """Report the inline-snooping setup: bridges present, eligible wired NICs,
    the default-route interface (never bridged), and the trusted/untrusted
    config — everything the UI needs to guide wiring."""
    bridges = _list_bridges()
    snoop_bridge = next((b for b in bridges if b['name'] == _DHCP_SNOOP_BRIDGE), None)
    with _dhcp_snoop_lock: