python-netgear-switch-library 0.0.post332__py3-none-any.whl → 0.0.post337__py3-none-any.whl

netgear_switch/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.0.post332'
-__version_tuple__ = version_tuple = (0, 0, 'post332')
+__version__ = version = '0.0.post337'
+__version_tuple__ = version_tuple = (0, 0, 'post337')
 
 __commit_id__ = commit_id = None

netgear_switch/cli_read.py

@@ -103,5 +103,14 @@ class CliReader:
     def get_mgmt_ip(self) -> MgmtIpConfig:
         return parse.parse_mgmt_ip(self.session.run(self._spec.network_cmd))
 
+    def get_hostname(self) -> str:
+        """The switch's host name, from ``show hosts``.
+
+        See ``parse.parse_hostname`` for why this command and not
+        ``show running-config``: the two report different values, and only this
+        one agrees with SNMP's ``sysName``.
+        """
+        return parse.parse_hostname(self.session.run(self._spec.hosts_cmd))
+
     def identify(self) -> DetectedModel:
         return parse.parse_version(self.session.run(self._spec.version_cmd), MODELS)

netgear_switch/cli_write.py

@@ -561,8 +561,10 @@ class CliWriter:
             timeouts=timeouts or _DEFAULT_POE_TIMEOUTS,
             sleep=sleep,
             clock=clock,
-            recovered=lambda st: st is not None
-            and st.detect in (PoEDetect.DELIVERING, PoEDetect.SEARCHING),
+            recovered=lambda st: (
+                st is not None
+                and st.detect in (PoEDetect.DELIVERING, PoEDetect.SEARCHING)
+            ),
             timeout_message=(
                 f"PoE port {port} still in FAULT after clear within {{timeout}}s"
             ),
@@ -596,6 +598,52 @@ class CliWriter:
     def _port_status(self, port: int) -> PortStatus | None:
         return next((p for p in self._reader.get_ports() if p.port == port), None)
 
+    # --- host name -----------------------------------------------------------
+
+    def set_hostname(self, name: str, *, force: bool = False) -> None:
+        """Set the switch's host name, via global-config ``hostname <name>``.
+
+        Not force-gated: renaming cannot strand the switch and is reversible by
+        writing the old name back, unlike ``set_mgmt_ip`` below which drops the
+        session that issues it. ``force`` is accepted so the signature matches
+        every other writer.
+
+        Verified by re-reading ``show hosts``. That command, rather than
+        ``show running-config``, is deliberate and load-bearing here: the two
+        report different values on real hardware (see
+        ``protocols.cli.parse.parse_hostname``), and ``show hosts`` is the one
+        that agrees with SNMP, so a CLI write verified this way is also
+        observable over SNMP.
+
+        Nothing is persisted -- no ``write memory`` -- exactly like every other
+        write in this module.
+        """
+        del force  # accepted for a uniform writer signature; nothing to gate
+        if not name.strip():
+            # `hostname` with no argument is rejected by the device itself
+            # ("Command not found / Incomplete command"), so sending it would
+            # surface as a confusing CliCommandError from deep in _in_mode.
+            # CLEARING a host name is a different operation -- FASTPATH spells
+            # it `no hostname` -- and that has not been driven against real
+            # hardware here, so it is not offered rather than guessed at.
+            raise ValueError(
+                "hostname must not be empty; clearing a switch's host name is "
+                "`no hostname` on FASTPATH, which this library does not "
+                "implement because it has not been verified on a device"
+            )
+        before = self._reader.get_hostname()
+        self._in_mode(
+            [self._spec.configure_cmd],
+            [self._spec.hostname_config_cmd.format(name=name)],
+        )
+        after = self._reader.get_hostname()
+        if after != name:
+            raise WriteVerificationError(
+                f"`show hosts` reports {after!r} after setting hostname {name!r}",
+                before=before,
+                after=after,
+            )
+
     # --- management IP + reboot --------------------------------------------
 
     def set_mgmt_ip(

netgear_switch/models.py

@@ -119,6 +119,38 @@ class MgmtIpConfig:
     base_mac: str | None = None
 
 
+@dataclass(frozen=True)
+class SyslogServer:
+    """One remote syslog collector the switch is configured to send to."""
+
+    host: str
+    port: int
+    #: Standard syslog severity, 0 (emergency) to 7 (debug). The switch sends
+    #: messages AT OR ABOVE this level. Cross-checked on m4300-24x: the SNMP
+    #: column reads 6 where ``show logging hosts`` prints "info".
+    severity: int
+    #: The switch's own word for the row's state, "Active" in the CLI table.
+    active: bool
+
+
+@dataclass(frozen=True)
+class SyslogConfig:
+    """Remote-logging configuration: whether it is on, and where it sends.
+
+    Deliberately narrower than everything ``show logging`` prints. The console
+    and buffered-logging columns are in the same vendor subtree, but only the
+    console pair could be decoded against captured CLI output; the buffered
+    severity did not match any column read, so it is left out rather than
+    guessed at. See ``VendorOids.syslog_*``.
+    """
+
+    enabled: bool
+    #: The source port the switch sends FROM (``Logging Client Local Port``),
+    #: not the collector's port -- that is per-server in ``servers``.
+    local_port: int
+    servers: tuple[SyslogServer, ...]
+
+
 @dataclass(frozen=True)
 class DetectedModel:
     """Result of identifying a switch's model over SNMP (sysObjectID + sysDescr).

netgear_switch/nsdp_read.py

@@ -216,6 +216,18 @@ class NsdpReader:
         dev = self._device([Tag.PORT_PVID])
         return [(p.port_id, p.vlan_id) for p in dev.port_pvids]
 
+    def get_hostname(self) -> str:
+        """The switch's host name, from the NSDP ``HOSTNAME`` tag (0x0003).
+
+        The same value SNMP would report as ``sysName`` -- except that a Plus
+        switch has no SNMP agent at all, which is why NSDP carries it.
+
+        A switch that has never been named answers the tag with nothing, and
+        that is a real answer rather than a failure: unlike SNMP's ``sysName``,
+        which is a mandatory scalar, this tag is genuinely optional.
+        """
+        return self._device([Tag.HOSTNAME]).hostname or ""
+
     def get_mgmt_ip(self) -> MgmtIpConfig:
         return _mgmt(
             self._device([Tag.IP_ADDRESS, Tag.NETMASK, Tag.GATEWAY, Tag.DHCP_MODE])
@@ -270,6 +282,10 @@ class AsyncNsdpReader:
         dev = await self._device([Tag.PORT_PVID])
         return [(p.port_id, p.vlan_id) for p in dev.port_pvids]
 
+    async def get_hostname(self) -> str:
+        """Async twin of ``NsdpReader.get_hostname`` -- see there."""
+        return (await self._device([Tag.HOSTNAME])).hostname or ""
+
     async def get_mgmt_ip(self) -> MgmtIpConfig:
         return _mgmt(
             await self._device(

netgear_switch/protocols/cli/commands.py

@@ -94,6 +94,18 @@ class CliModelSpec:
     environment_cmd: str = "show environment"
     network_cmd: str = "show network"
     interface_stats_cmd: str = "show interface ethernet {iface}"
+    # Host name. `show hosts` and NOT `show running-config | include hostname`:
+    # the two report DIFFERENT values, measured 2026-08-02. On m4300-16x
+    # (10.1.5.20) `show hosts` gives "sw-netgear-m4300-16x-poe-s2" while
+    # running-config gives "manage-sw-netgear-m4300-16x-poe-s2", and on
+    # gsm7252ps (10.1.5.22) running-config carries no hostname line at all while
+    # `show hosts` still reports one. `show hosts` is the one that agrees with
+    # SNMP's sysName, so it is what keeps the two backends returning the same
+    # answer for the same switch.
+    hosts_cmd: str = "show hosts"
+    # Global-config directive. Quoted on the wire by the device's own
+    # running-config output ('hostname "sw-netgear-m4300-24x"').
+    hostname_config_cmd: str = "hostname {name}"
 
     # --- physical-interface naming -----------------------------------------
     # How this model's firmware ADDRESSES one physical port in a command

netgear_switch/protocols/cli/parse.py

@@ -30,6 +30,7 @@ from __future__ import annotations
 import re
 from typing import TYPE_CHECKING
 
+from ...errors import CliCommandError
 from ...models import (
     DetectedModel,
     IpMode,
@@ -605,6 +606,46 @@ def parse_environment(text: str) -> list[Sensor]:
     return out
 
 
+# ---------------------------------------------------------------------------
+# show hosts -> host name
+# ---------------------------------------------------------------------------
+
+
+def parse_hostname(text: str) -> str:
+    """``show hosts`` -> the switch's host name.
+
+    The command reports far more than the name -- DNS servers, the domain list,
+    resolver retry counts, the static host-to-address table -- and only the
+    first labelled field is wanted::
+
+        Host name...................................... sw-netgear-m4300-24x
+        Default domain................................. Domain name is not configured
+        Name servers (Preference order)................ 8.8.8.8, 10.1.5.1
+
+    Captured 2026-08-02 from m4300-24x (10.1.5.13), m4300-16x (10.1.5.20) and
+    gsm7252ps (10.1.5.22); all three label it exactly "Host name".
+
+    This is deliberately NOT ``show running-config | include hostname``. The two
+    report different values: on m4300-16x running-config holds
+    "manage-sw-netgear-m4300-16x-poe-s2" against this command's
+    "sw-netgear-m4300-16x-poe-s2", and on gsm7252ps running-config has no
+    hostname line at all while this command still answers. ``show hosts`` is the
+    one that matches SNMP's sysName, so parsing it is what stops the CLI and
+    SNMP backends disagreeing about the same switch.
+
+    Raises rather than returning "" when the label is absent: every FASTPATH
+    switch measured answers it, so silence means the command failed or the
+    output drifted, and a blank host name would be a fabrication.
+    """
+    name = labelled_values(text).get("Host name")
+    if name is None:
+        raise CliCommandError(
+            "`show hosts` output carries no 'Host name' field; got: "
+            + " ".join(text.split())[:200]
+        )
+    return name.strip()
+
+
 # ---------------------------------------------------------------------------
 # show network -> management IP
 # ---------------------------------------------------------------------------

netgear_switch/protocols/snmp/oids.py

@@ -21,6 +21,23 @@ SYS_DESCR = "1.3.6.1.2.1.1.1.0"  # sysDescr: text incl. the model name
 SYS_OBJECT_ID = "1.3.6.1.2.1.1.2.0"  # sysObjectID: read-only signal, unused
 # for matching (no known OID->model table exists -- see parse.py's
 # detect_model_from_sysdescr docstring).
+# sysName: the switch's host name. A STANDARD MIB-II scalar, which is why it is
+# the one hostname source that also works on gs728tpp -- that agent publishes no
+# Netgear vendor subtree at all.
+#
+# WRITABLE on every SNMP model in this fleet. Measured 2026-08-02 by SETting the
+# value the switch already had: a zero-impact writability probe, since the device
+# state cannot change but a read-only column still answers notWritable. All five
+# accepted -- gsm7228ps (10.1.5.11) on community `public`, which is the only one
+# it has, and m4300-24x (.13), m4300-16x (.20), gsm7252ps (.22) and gs728tpp
+# (10.2.5.10) on `private`.
+#
+# NOT the same value as the FASTPATH `hostname` running-config directive. On
+# m4300-16x sysName is "sw-netgear-m4300-16x-poe-s2" while running-config holds
+# "manage-sw-netgear-m4300-16x-poe-s2", and on gsm7252ps running-config carries
+# no hostname at all. sysName tracks `show hosts`, which is therefore what the
+# CLI reader parses so that the two backends cannot disagree.
+SYS_NAME = "1.3.6.1.2.1.1.5.0"
 IF_TYPE = "1.3.6.1.2.1.2.2.1.3"  # ifType (6=ethernetCsmacd=physical)
 IF_ADMIN_STATUS = "1.3.6.1.2.1.2.2.1.7"  # ifAdminStatus (1=up,2=down)
 IF_OPER_STATUS = "1.3.6.1.2.1.2.2.1.8"  # ifOperStatus  (1=up,2=down)
@@ -130,6 +147,32 @@ class VendorOids:
     """The ONE symbol every call site uses for the DHCP-mode OID. See
     DHCP_MODE_OID_SUFFIX above — UNVERIFIED, best-effort read only. No call site
     may hard-code a ``.99.1`` literal; they all reference this field."""
+    syslog_admin_mode: str
+    syslog_local_port: str
+    syslog_host_addr: str
+    syslog_host_port: str
+    syslog_host_severity: str
+    syslog_host_status: str
+    """Remote-logging configuration, under ``<base>.14`` on BOTH vendor
+    families -- 4526.10 (FASTPATH) and 4526.11 (S3300) share the column layout.
+
+    Located 2026-08-02 by reading each switch's own ``show logging`` /
+    ``show logging hosts`` and then searching a full walk for those values;
+    every field of the CLI output is accounted for by a column and the two
+    agree. On m4300-24x (10.1.5.13) the host row reads 10.1.5.1 / port 514 /
+    severity 6 / status 1 against a CLI table of ``10.1.5.1  info  514
+    Active`` -- so severity is the standard syslog scale (6 = info) and status
+    1 = Active.
+
+    ``<base>.17`` is NOT this: it looks like logging until you notice it holds
+    port 123 and the string "NTP Bits". It is SNTP, and this fleet's NTP server
+    and syslog server are the same host, which is what makes the confusion easy.
+
+    The admin-mode enum is ``1 = enabled, 2 = disabled``, confirmed twice over
+    on m4300-24x: syslog reads 1 while ``show logging`` says "Syslog Logging :
+    enabled", and the console column reads 2 while it says "Console Logging :
+    disabled". The console severity column independently reads 3 against a CLI
+    "error", matching the same syslog scale."""
     mgmt_write_addr_unverified: str
     mgmt_write_netmask_unverified: str
     mgmt_write_gateway_unverified: str
@@ -219,6 +262,12 @@ def vendor_oids(model: SwitchModel) -> VendorOids:
         box_psu_power=f"{base}.43.1.8.1.5",
         box_temp=f"{base}.43.1.15.1.3",
         dhcp_mode_unverified=f"{base}.{DHCP_MODE_OID_SUFFIX}",
+        syslog_admin_mode=f"{base}.14.1.4.1.0",
+        syslog_local_port=f"{base}.14.1.4.3.0",
+        syslog_host_addr=f"{base}.14.1.4.5.1.3",
+        syslog_host_port=f"{base}.14.1.4.5.1.4",
+        syslog_host_severity=f"{base}.14.1.4.5.1.5",
+        syslog_host_status=f"{base}.14.1.4.5.1.7",
         mgmt_write_addr_unverified=f"{base}.98.1",
         mgmt_write_netmask_unverified=f"{base}.98.2",
         mgmt_write_gateway_unverified=f"{base}.98.3",

netgear_switch/protocols/snmp/parse.py

@@ -17,6 +17,8 @@ from ...models import (
     PortStats,
     PortStatus,
     Sensor,
+    SyslogConfig,
+    SyslogServer,
     VLANInfo,
 )
 from .client import SnmpError, SnmpRow
@@ -716,6 +718,70 @@ def _ipv4_from_rfc4293_index(rows: Sequence[SnmpRow]) -> str | None:
     return None
 
 
+#: The vendor admin-mode enum shared by every logging destination column.
+#: 1 = enabled, 2 = disabled -- confirmed twice on m4300-24x against its own
+#: ``show logging``: syslog reads 1 under "Syslog Logging : enabled" and the
+#: console column reads 2 under "Console Logging : disabled".
+_ADMIN_ENABLED = 1
+
+#: Row status in the syslog host table. 1 is what the CLI prints as "Active".
+_HOST_STATUS_ACTIVE = 1
+
+
+def _first_int(rows: Sequence[SnmpRow]) -> int | None:
+    """The value of a single-varbind scalar GET, when it is an integer."""
+    for row in rows:
+        if isinstance(row.value, int):
+            return row.value
+    return None
+
+
+def parse_syslog(
+    admin_mode: Sequence[SnmpRow],
+    local_port: Sequence[SnmpRow],
+    host_addr: Sequence[SnmpRow],
+    host_port: Sequence[SnmpRow],
+    host_severity: Sequence[SnmpRow],
+    host_status: Sequence[SnmpRow],
+    *,
+    addr_base: str,
+    port_base: str,
+    severity_base: str,
+    status_base: str,
+) -> SyslogConfig:
+    """Vendor logging columns -> ``SyslogConfig``.
+
+    The host table is indexed by an integer row id, and every per-host column is
+    matched to the address column by that index rather than by position -- so a
+    table with a gap in its indices (a deleted row) cannot silently shift one
+    row's port onto another row's address.
+
+    A row whose address is empty is skipped. The address is the only field that
+    makes a row meaningful, and reporting one collector fewer is far better than
+    inventing where logs are being sent.
+    """
+    addresses = index_str_column(host_addr, addr_base)
+    ports = index_int_column(host_port, port_base)
+    severities = index_int_column(host_severity, severity_base)
+    statuses = index_int_column(host_status, status_base)
+
+    servers = tuple(
+        SyslogServer(
+            host=address,
+            port=ports.get(index, 0),
+            severity=severities.get(index, 0),
+            active=statuses.get(index) == _HOST_STATUS_ACTIVE,
+        )
+        for index, address in sorted(addresses.items())
+        if address.strip()
+    )
+    return SyslogConfig(
+        enabled=_first_int(admin_mode) == _ADMIN_ENABLED,
+        local_port=_first_int(local_port) or 0,
+        servers=servers,
+    )
+
+
 def parse_mgmt_ip(
     addr: Sequence[SnmpRow],
     netmask: Sequence[SnmpRow],
@@ -826,6 +892,27 @@ def _scalar_text(rows: Sequence[SnmpRow], oid: str) -> str | None:
     return None
 
 
+def parse_hostname(rows: Sequence[SnmpRow]) -> str:
+    """Extract ``sysName`` from one exact-OID GET.
+
+    Raises rather than returning a placeholder when the scalar is absent. Every
+    switch in this fleet answers ``sysName`` -- it is a mandatory MIB-II scalar
+    -- so an absent one is a real failure to report, not an empty hostname to
+    invent. An empty *string* is a different thing and is passed through: a
+    switch with no name configured genuinely has one.
+    """
+    from . import oids
+
+    value = _scalar_text(rows, oids.SYS_NAME)
+    if value is None:
+        raise SnmpError(
+            f"switch did not answer sysName ({oids.SYS_NAME}); it is a mandatory "
+            "MIB-II scalar, so this is an agent or transport failure rather "
+            "than an absent hostname"
+        )
+    return value
+
+
 def parse_system_info(rows: Sequence[SnmpRow]) -> tuple[str | None, str | None]:
     """Extract the raw sysDescr/sysObjectID scalar text from one combined GET.
 

netgear_switch/snmp_read.py

@@ -23,6 +23,7 @@ if TYPE_CHECKING:
         PortStats,
         PortStatus,
         Sensor,
+        SyslogConfig,
         VLANInfo,
     )
     from .protocols.snmp.client import AsyncSnmpClient, SnmpClient
@@ -193,6 +194,44 @@ class SnmpReader:
             w(oids.IP_ADDRESS_IFINDEX),  # RFC-4293 fallback (M4300)
         )
 
+    def get_hostname(self) -> str:
+        """The switch's host name, from the standard MIB-II ``sysName`` scalar.
+
+        Standard, so this works on every SNMP model -- including ``gs728tpp``,
+        which publishes no Netgear vendor subtree at all.
+        """
+        return parse.parse_hostname(self.client.get([oids.SYS_NAME]))
+
+    def get_syslog(self) -> SyslogConfig:
+        """Remote-logging configuration: whether it is on, and where it sends.
+
+        VENDOR columns, so a model with no Netgear subtree cannot serve this.
+        ``gs728tpp`` is exactly that model -- a walk of ``1.3.6.1.4.1.4526``
+        answers ``noSuchObject`` -- and it is refused by name rather than
+        returned empty, which would read as "no collectors configured".
+        """
+        if not oids.has_vendor_oids(self.model):
+            raise UnsupportedCapabilityError(
+                f"model {self.model.key!r} registers no Netgear vendor OID "
+                "subtree, and the logging columns are vendor-only; an empty "
+                "result here would be indistinguishable from a switch with no "
+                "syslog collectors configured"
+            )
+        vo = oids.vendor_oids(self.model)
+        w = self.client.walk
+        return parse.parse_syslog(
+            self.client.get([vo.syslog_admin_mode]),
+            self.client.get([vo.syslog_local_port]),
+            w(vo.syslog_host_addr),
+            w(vo.syslog_host_port),
+            w(vo.syslog_host_severity),
+            w(vo.syslog_host_status),
+            addr_base=vo.syslog_host_addr,
+            port_base=vo.syslog_host_port,
+            severity_base=vo.syslog_host_severity,
+            status_base=vo.syslog_host_status,
+        )
+
     def get_system_info(self) -> DetectedModel:
         """Identify this switch's model via sysDescr (see ``read_system_info``).
 
@@ -320,6 +359,10 @@ class AsyncSnmpReader:
             await w(oids.IP_ADDRESS_IFINDEX),  # RFC-4293 fallback (M4300)
         )
 
+    async def get_hostname(self) -> str:
+        """Async twin of ``SnmpReader.get_hostname`` -- see there."""
+        return parse.parse_hostname(await self.client.get([oids.SYS_NAME]))
+
     async def get_system_info(self) -> DetectedModel:
         """Async twin of ``SnmpReader.get_system_info`` -- see there."""
         return await async_read_system_info(self.client)

netgear_switch/snmp_write.py

@@ -238,9 +238,7 @@ def _plan_switchport_membership(
             # rebuild it from the membership the port actually has.
             allowed = _vlan_bitmap({untagged_vlan, *want_tagged})
         varbinds.append(
-            SetVarbind(
-                f"{oids.FASTPATH_SWITCHPORT_ALLOWED_VLANS}.{port}", allowed, "x"
-            )
+            SetVarbind(f"{oids.FASTPATH_SWITCHPORT_ALLOWED_VLANS}.{port}", allowed, "x")
         )
         varbinds.append(
             SetVarbind(
@@ -558,9 +556,7 @@ class SnmpWriter:
             self.client.set(vb)
         problem = _switchport_divergence(plan, vlan, port, self._reader.get_vlans())
         if problem is not None:
-            raise WriteVerificationError(
-                problem, before=before, after=self._vlan(vlan)
-            )
+            raise WriteVerificationError(problem, before=before, after=self._vlan(vlan))
 
     def _switchport_vlan_bitmap(self, base_oid: str, port: int) -> bytes:
         """A switchport VLAN-list column's octets, or an all-zero 512-byte map."""
@@ -596,11 +592,18 @@ class SnmpWriter:
         raw_egress = self._raw_bitmap(oids.DOT1Q_VLAN_STATIC_EGRESS, vlan)
         raw_untagged = self._raw_bitmap(oids.DOT1Q_VLAN_STATIC_UNTAGGED, vlan)
         new_egress, new_untagged = membership_bitmaps(
-            mode=mode, port=port,
-            egress=(raw_egress if raw_egress is not None
-                    else encode_port_bitmap(before.member_ports)),
-            untagged=(raw_untagged if raw_untagged is not None
-                      else encode_port_bitmap(before.untagged_ports)),
+            mode=mode,
+            port=port,
+            egress=(
+                raw_egress
+                if raw_egress is not None
+                else encode_port_bitmap(before.member_ports)
+            ),
+            untagged=(
+                raw_untagged
+                if raw_untagged is not None
+                else encode_port_bitmap(before.untagged_ports)
+            ),
             width_bytes=vlan_bitmap_width(self.model),
         )
         egress_vb = SetVarbind(
@@ -704,6 +707,30 @@ class SnmpWriter:
                 after=after,
             )
 
+    def set_hostname(self, name: str, *, force: bool = False) -> None:
+        """Set the switch's host name via the standard MIB-II ``sysName``.
+
+        GROUNDED, unlike ``set_mgmt_ip`` below: ``sysName`` was confirmed
+        writable on every SNMP model in this fleet on 2026-08-02, by SETting
+        each switch the value it already held. See ``oids.SYS_NAME`` for the
+        hosts and communities, and for why this is NOT the same value as the
+        FASTPATH ``hostname`` running-config directive.
+
+        Not force-gated: renaming a switch cannot strand it the way a mgmt-IP
+        write can, and it is trivially reversible by writing the old name back.
+        ``force`` is accepted so the signature matches every other writer.
+        """
+        del force  # accepted for a uniform writer signature; nothing to gate
+        before = self._reader.get_hostname()
+        self.client.set_many([SetVarbind(oids.SYS_NAME, name, "s")])
+        after = self._reader.get_hostname()
+        if after != name:
+            raise WriteVerificationError(
+                f"sysName is {after!r} after writing {name!r}",
+                before=before,
+                after=after,
+            )
+
     def set_mgmt_ip(
         self, address: str, netmask: str, gateway: str, *, force: bool = False
     ) -> None:
@@ -982,11 +1009,18 @@ class AsyncSnmpWriter:
         raw_egress = await self._raw_bitmap(oids.DOT1Q_VLAN_STATIC_EGRESS, vlan)
         raw_untagged = await self._raw_bitmap(oids.DOT1Q_VLAN_STATIC_UNTAGGED, vlan)
         new_egress, new_untagged = membership_bitmaps(
-            mode=mode, port=port,
-            egress=(raw_egress if raw_egress is not None
-                    else encode_port_bitmap(before.member_ports)),
-            untagged=(raw_untagged if raw_untagged is not None
-                      else encode_port_bitmap(before.untagged_ports)),
+            mode=mode,
+            port=port,
+            egress=(
+                raw_egress
+                if raw_egress is not None
+                else encode_port_bitmap(before.member_ports)
+            ),
+            untagged=(
+                raw_untagged
+                if raw_untagged is not None
+                else encode_port_bitmap(before.untagged_ports)
+            ),
             width_bytes=vlan_bitmap_width(self.model),
         )
         egress_vb = SetVarbind(
@@ -1078,6 +1112,19 @@ class AsyncSnmpWriter:
                 after=after,
             )
 
+    async def set_hostname(self, name: str, *, force: bool = False) -> None:
+        """Async twin of ``SnmpWriter.set_hostname`` -- see there."""
+        del force  # accepted for a uniform writer signature; nothing to gate
+        before = await self._reader.get_hostname()
+        await self.client.set_many([SetVarbind(oids.SYS_NAME, name, "s")])
+        after = await self._reader.get_hostname()
+        if after != name:
+            raise WriteVerificationError(
+                f"sysName is {after!r} after writing {name!r}",
+                before=before,
+                after=after,
+            )
+
     async def set_mgmt_ip(
         self, address: str, netmask: str, gateway: str, *, force: bool = False
     ) -> None:

netgear_switch/virtual/cli_fastpath.py

@@ -127,6 +127,44 @@ def render_network(state: VirtualSwitchState) -> str:
     )
 
 
+# --- show hosts -------------------------------------------------------------
+
+
+def render_hosts(state: VirtualSwitchState) -> str:
+    """``show hosts``, transcribed from real output captured 2026-08-02.
+
+    From m4300-24x (10.1.5.13), m4300-16x (10.1.5.20) and gsm7252ps
+    (10.1.5.22). All three label the name exactly "Host name", and the resolver
+    and static-mapping sections around it are reproduced because the reader has
+    to pick one field out of them -- a mock emitting only the wanted line would
+    not exercise that at all.
+
+    The trailing static-mapping tables are the empty form all three returned;
+    none had a host-to-address mapping configured.
+    """
+    return "\n".join(
+        [
+            _dotted("Host name", state.hostname),
+            _dotted("Default domain", "Domain name is not configured"),
+            _dotted("Default domain list", "Domain Name List is not configured"),
+            _dotted("Domain Name Lookup", "Enabled"),
+            _dotted("Number of retries", "2"),
+            _dotted("Retry timeout period", "3"),
+            _dotted("Name servers (Preference order)", "10.1.5.1"),
+            "",
+            "Configured host name-to-address mapping:",
+            "",
+            " Host                                Addresses",
+            "------------------------ ----------------------",
+            "No host name is configured to IP address",
+            "",
+            " Host                   Total   Elapsed    Type        Addresses",
+            "---------------------- -------  -------    ----        --------------",
+            "No hostname is mapped to an IP address",
+        ]
+    )
+
+
 # --- show port all ----------------------------------------------------------
 
 

netgear_switch/virtual/faces/cli.py

@@ -59,6 +59,7 @@ _COPY_RE = re.compile(r"^copy\s+(\S+)\s+(\S+)$")
 
 # --- configuration-mode commands -------------------------------------------
 _CONFIGURE_RE = re.compile(r"^config(?:ure)?(?: terminal)?$")
+_HOSTNAME_RE = re.compile(r'^hostname\s+("?[^"]+"?)$')
 _VLAN_DATABASE_RE = re.compile(r"^vlan database$")
 _VLAN_CREATE_RE = re.compile(r"^vlan (\d+)$")
 _VLAN_NAME_RE = re.compile(r"^vlan name (\d+) (\S+)$")
@@ -339,6 +340,14 @@ class VirtualCliFace:
         if self._mode == _VLAN_DB:
             return self._vlan_db_command(c)
         if self._mode == _CONFIG:
+            m = _HOSTNAME_RE.match(c)
+            if m:
+                # The device stores the name unquoted; its running-config
+                # renders it quoted, and `show hosts` reports it bare. Accept
+                # either form on the wire so a caller that quotes is not
+                # silently given a name with quotes embedded in it.
+                self.state.hostname = m.group(1).strip().strip('"')
+                return _ACCEPTED
             m = _INTERFACE_RE.match(c)
             if m:
                 port = cli_fastpath.port_for_iface(self.state, m.group(1))
@@ -406,6 +415,8 @@ class VirtualCliFace:
             return cli_fastpath.render_environment(self.state)
         if c == self.spec.network_cmd:
             return cli_fastpath.render_network(self.state)
+        if c == self.spec.hosts_cmd:
+            return cli_fastpath.render_hosts(self.state)
         m = _SHOW_VLAN_ID_RE.match(c)
         if m:
             return cli_fastpath.render_vlan_detail(self.state, int(m.group(1)))

netgear_switch/virtual/seed.py

@@ -2123,7 +2123,9 @@ _M4300_24X_SWITCHPORT: dict[int, _SwitchportRow] = {
     # VLAN (90) differs from its NATIVE VLAN (5) -- proving membership follows
     # col4 not col3 in trunk mode -- with a genuinely sparse allowed list.
     5: (
-        2, 90, 5,
+        2,
+        90,
+        5,
         frozenset({1, 5, 6, 7, 10, 20, 41, 90, 99, 121, 141}),
         {1, 90},
         set(),
@@ -2393,6 +2395,9 @@ def seed_m4300_24x() -> VirtualSwitchState:
         mode="static",
     )
     state = VirtualSwitchState(
+        # Measured 2026-08-02: sysName and `show hosts` both report this on the
+        # real switch. Was empty here, which no real FASTPATH switch is.
+        hostname="sw-netgear-m4300-24x",
         model_key="m4300-24x",
         ports=ports,
         vlans=vlans,
@@ -2587,6 +2592,9 @@ def seed_m4300_16x() -> VirtualSwitchState:
         ),
     ]
     state = VirtualSwitchState(
+        # Measured 2026-08-02: sysName and `show hosts` both report this on the
+        # real switch. Was empty here, which no real FASTPATH switch is.
+        hostname="sw-netgear-m4300-16x-poe-s2",
         model_key="m4300-16x",
         ports=ports,
         vlans=vlans,

netgear_switch/virtual/state.py

@@ -729,6 +729,13 @@ class VirtualSwitchState:
         # has no vendor subtree at all -- see the field docstring).
         default_object_id = f"{v.base}.1" if v is not None else "1.3.6.1.2.1"
         m[oids.SYS_OBJECT_ID] = ("OID", self.sys_object_id or default_object_id)
+        # sysName: the same host name the CLI face reports through `show hosts`
+        # and the web faces render, so the backends cannot disagree about it
+        # here any more than they do on real hardware. Projected for EVERY model
+        # with an SNMP backend, matching the devices: all five reachable
+        # switches answered sysName on 2026-08-02, including gs728tpp, which
+        # publishes no vendor subtree at all.
+        m[oids.SYS_NAME] = ("OCTETSTR", self.hostname)
 
         for port, sim in self.ports.items():
             m[f"{oids.IF_ADMIN_STATUS}.{port}"] = ("INTEGER", "1" if sim.admin else "2")

{python_netgear_switch_library-0.0.post332.dist-info → python_netgear_switch_library-0.0.post337.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-netgear-switch-library
-Version: 0.0.post332
+Version: 0.0.post337
 Summary: Python library and CLI to query and control Netgear switches over SNMP, NSDP and HTTP.
 Author-email: Tim Ansell <me@mith.ro>
 License-Expression: Apache-2.0

{python_netgear_switch_library-0.0.post332.dist-info → python_netgear_switch_library-0.0.post337.dist-info}/RECORD

@@ -1,20 +1,20 @@
 netgear_switch/__init__.py,sha256=3P68qR3Rcf9zl5u4_SMkmloD8MnzZi6VWv7n4AMb_-4,5835
 netgear_switch/_dispatch.py,sha256=JO30TCPjE_1Y10SIGEkQybPT5EQB5z0LGfyT5YDQYMc,12615
-netgear_switch/_version.py,sha256=d-pPwfCr3anPWgjTk2fTrcAvIDOcRmWxnZPflC9vBPw,534
+netgear_switch/_version.py,sha256=uMRJAWzO1-i1mtkD61NytADooaJBGMBYCFaIxMqo8tk,534
 netgear_switch/aio_api.py,sha256=_KY6CnUesVLSAzVI7Qs9cJYxh0SyaoE_rU2-GgOnpdM,27558
 netgear_switch/capabilities.py,sha256=3TXHpSDHaM4TO5kbtC5ecIK5ammVlEea4dapW7Xh698,16658
-netgear_switch/cli_read.py,sha256=1mOzCGp2gZ3OoZtYLDu8sIuDaT9qngh2L01unuRcpE8,4531
-netgear_switch/cli_write.py,sha256=o4F2ARt00Q7-DDNrQF1xTxcqBdnHudkgE7eZfeEjUhU,30357
+netgear_switch/cli_read.py,sha256=77fyvMRp3Pi9UuKf8hoGE0ySK1F1TNDz4Jcqpa-evwc,4902
+netgear_switch/cli_write.py,sha256=K1vjhYs4_lb20W6UgzlZT0DKJVlT_K7Y0s3oe5-rcIY,32689
 netgear_switch/config.py,sha256=z2vV1LqsLTb83ekEJwy_nnkeUlxcknicmkmKfILH5kc,5787
 netgear_switch/errors.py,sha256=zb9fFU71o69NXBhH51OOe5tXVp1UigMd2U64TN5cTW0,2203
 netgear_switch/http_read.py,sha256=X-sZfB818Hq0RV37jjPZ2UI9t_H6Cw10PYvbBQ7LRoM,35018
 netgear_switch/http_write.py,sha256=6S1G8vh_Uu1v233OcgBbH8Vv-RmYqTKySjoxg4dk2mQ,59907
-netgear_switch/models.py,sha256=XDkd9SHG9EsfPnGDaR5jVC4g65OYQ5U_1dxlUki3FZI,5005
-netgear_switch/nsdp_read.py,sha256=Fvm4m1ZUUAknELIcMavljmC_x1v4AWTTYXvgAeVLJB4,11874
+netgear_switch/models.py,sha256=SEpgg7juz9IRZ1HTdcaTZAE1jX687qrbLal9yvvpLAs,6195
+netgear_switch/nsdp_read.py,sha256=lupPC3O9h5j9hwrKTY7YoCWfya90_C478QbyOJMy874,12613
 netgear_switch/nsdp_write.py,sha256=Am6X4ztuiY66h2GuMA6-rE7UO4xBDRw66aa2DXYljEg,18983
 netgear_switch/registry.py,sha256=gyR8diWnq95ZqXMl9q2PLbZ3H-F3So9NjLtcA9gFvfo,19706
-netgear_switch/snmp_read.py,sha256=SqRLu0QP0Pv2Zrf5HE8gU22ZvP4qJqq4Gr9vjJEnNs0,13805
-netgear_switch/snmp_write.py,sha256=SIvOjrv5XHe0hyV_cmZ1yMkoxBumTuny9cyHI04l83M,47288
+netgear_switch/snmp_read.py,sha256=1Of3sT9CJ6jIeVVhuumZhRjKVjfRe58atGPWLcsEi5Y,15734
+netgear_switch/snmp_write.py,sha256=iY5ENb3M9Cf-y6ReTfcU_SflM2IhRhg6MZtprYfchaw,49221
 netgear_switch/sync_api.py,sha256=BgiYbDLrjs23k3g8KRajP9RfM7J8Wka1WUipwmVjekc,38575
 netgear_switch/cli/__init__.py,sha256=tWZVE4BHoVLwYF-KKXIyrilqFpKBkAmHGC68UEK78e4,74
 netgear_switch/cli/capture.py,sha256=Cs8O3wFsPqCosXw88XHnRkbQb6oDkp2lV8AywHzmaYI,4546
@@ -27,8 +27,8 @@ netgear_switch/mcp/__init__.py,sha256=zpdWW_mSjSaj81ZFf5y9-N_RabR2Ncb-rLm2eZ-ihX
 netgear_switch/mcp/server.py,sha256=7YIYc-eu1egE0RM_9BzJrL8rqPKAR-WkLY9W6yVkV0I,21517
 netgear_switch/protocols/__init__.py,sha256=gWdi-aLLU-zDi7XAIoIjrdvHn4bQBlZDGmZy2b6nysk,44
 netgear_switch/protocols/cli/__init__.py,sha256=3jQRQlNylAFzw9Gf8E_rpLgHMyrsE7gcnT50DS-4RDY,69
-netgear_switch/protocols/cli/commands.py,sha256=9R6RY-A8YxpOR872M_WGF6s-6AIIwT99z7yrGwYuTGA,21846
-netgear_switch/protocols/cli/parse.py,sha256=jRxKatf6-N43YsHR8EYx8TKxMRVChSmNA2EYBkwrMUo,27064
+netgear_switch/protocols/cli/commands.py,sha256=KXEdB514hQQheg5k4e8lNuIF2Mxwk-EWNwz3iv3tDv4,22634
+netgear_switch/protocols/cli/parse.py,sha256=pVwvXq3bLJHC0iilh-GxaI3jXDIQUhBvTQg_gQh9wdQ,28923
 netgear_switch/protocols/http/__init__.py,sha256=n_iSvNTdSqeEE8U2hbk5SYSNXrWHDYzlqok89FVnK10,85
 netgear_switch/protocols/http/crypt.py,sha256=zwFqE9ff49-j-qlvo7k-ydcG3z1l2SNJ8WLel65-w58,976
 netgear_switch/protocols/http/endpoints.py,sha256=krxd8cDbvOPecHQzk8SMbWOrdKmqlAWKRH9YcYZmZ1c,52469
@@ -45,8 +45,8 @@ netgear_switch/protocols/nsdp/types.py,sha256=vjATxuy-6MqyipiQI6T4LQVO8uvrnaUTaD
 netgear_switch/protocols/nsdp/write.py,sha256=LRY9wOc4MGDrn3Q1WuxcFYcOv3R9keqWh01tJBayu0s,6305
 netgear_switch/protocols/snmp/__init__.py,sha256=gWdi-aLLU-zDi7XAIoIjrdvHn4bQBlZDGmZy2b6nysk,44
 netgear_switch/protocols/snmp/client.py,sha256=YsSuav6kkZZrqUTHgsEwEcrP9uIm85xzdC88epsE-MU,2912
-netgear_switch/protocols/snmp/oids.py,sha256=jygRdZidK61oJiUfjgMTp5IXLhSl4DC7BqljDJ4Dm-Y,10353
-netgear_switch/protocols/snmp/parse.py,sha256=fGQvWNGC23yJbBQMRsW5Iw1VD3hDhIB4iM27ikiqnbM,40163
+netgear_switch/protocols/snmp/oids.py,sha256=TUbUQek0frFSNjD9p_Oc9Lj3QkVbSPPzW9RSaMCqUS0,13075
+netgear_switch/protocols/snmp/parse.py,sha256=lgcVT_4rC_JYGXEtyb1NUvkFgdS1RL5tgWX3PwCLW0s,43271
 netgear_switch/protocols/snmp/write.py,sha256=jVInRdTVKjs6nH0dhZVK8Chkkccekyho0Di2y1DwFDM,4090
 netgear_switch/transport/__init__.py,sha256=h_kjWqAcadW0Tvwdp930BACZO7-fwKVFlJ68yOLINQo,80
 netgear_switch/transport/aio/__init__.py,sha256=bC64jAmHQpa5q1UUK84ANaZ5h3d-Sg7v0B3SGcc6fqI,51
@@ -63,10 +63,10 @@ netgear_switch/transport/sync/__init__.py,sha256=RF_zqpgYttAnAoU-GFDlbJt7qcAwvUe
 netgear_switch/transport/sync/nsdp_udp.py,sha256=X3OOEvr6i6A3JBUB0UpZdbVLjhomFwAZg0ieRdqvj98,6456
 netgear_switch/transport/sync/snmp_netsnmp_cli.py,sha256=NM2mB114AjrUmBnCZYTnKAvDHZt7nrHpHnOBhuTIzTo,10761
 netgear_switch/virtual/__init__.py,sha256=uNWEXBp9g4FM7MdgCoey0qeG25zH_x5BOn5A4Io5asA,415
-netgear_switch/virtual/cli_fastpath.py,sha256=hDf7qLSaEGC4surhhFeDgnkJHQKwd99EiPn649A_Nlk,15225
-netgear_switch/virtual/seed.py,sha256=c_7c1L8nHAgNa2qbjpT11xgV4xm3lgeSKdg5Pl34uTw,95417
+netgear_switch/virtual/cli_fastpath.py,sha256=Mk1ER8_PRp2apT-l85Imnd8fPhQcM05RaM5bSF-WVLw,16885
+netgear_switch/virtual/seed.py,sha256=RG2o-ZPzgnDqL4A_j5ilVz4tc6_pXkNtIWKkeQxdcDw,95828
 netgear_switch/virtual/server.py,sha256=L6pkdsK48nVhSOVx-TCNLQTtjTJkud-xi-EuRh5CbiQ,9335
-netgear_switch/virtual/state.py,sha256=jh3XXdZtEVSui33N3PNatLExYhOhb8WVs3r8S4EHr8Q,71854
+netgear_switch/virtual/state.py,sha256=zykUe-U29kyP86l_vFhMoDral1jZjP49H90UBeErPp4,72343
 netgear_switch/virtual/web.py,sha256=abRn0pr_T_SycW2khBt8lvErPiq1KdiMVqSnloeG-WY,7323
 netgear_switch/virtual/web_fastpath_vlan.py,sha256=W5TsIrjRzt57jno-YAjXUiuXW_6IwIzTzPqs1N2O_Pw,19443
 netgear_switch/virtual/web_fastpath_xui.py,sha256=B2K3c_CJ5dzOzCw8ELIdMiUyCj1wmw_psp7luNh70s0,11208
@@ -78,14 +78,14 @@ netgear_switch/virtual/web_gsm7228ps.py,sha256=ZuDaVF9r14fB1yQ21LlOqlhw7QjY2kGAn
 netgear_switch/virtual/web_gsm7252ps.py,sha256=Y9clRqXOuZIKv84p3AV8ff0teEGJ5kP4JrfHPtjKuWI,20876
 netgear_switch/virtual/web_m4300.py,sha256=nCW_4MTfakH4tUXCiQeaYB4Awo3Ph-U5ew2rsQbLAf4,10863
 netgear_switch/virtual/faces/__init__.py,sha256=HmrZ8ebAu6gTnnS8F7mDfteZD5AP_-dNWfLHIbavTdo,114
-netgear_switch/virtual/faces/cli.py,sha256=A8WCQQAZnoThMmCmO7BY1smbuFsf29ZY2qc3hmCWlnk,19141
+netgear_switch/virtual/faces/cli.py,sha256=OEOMF1lps7YqskC-PWDbNXsVkkBY5mNeFSvq92_9jdM,19740
 netgear_switch/virtual/faces/http.py,sha256=bgpwjZcPL-rXmsizGuJgWGZlNtplOuq3K_N1zRxSF5A,34272
 netgear_switch/virtual/faces/mibview.py,sha256=g4EsSfXO6ojyPDT633lEkNVmPcqzU0VdbqNFpApRdMQ,4875
 netgear_switch/virtual/faces/nsdp.py,sha256=WX9w1YWArUvm4-L2Y7QI8njvBRD4t0TVFUL2V0yuQmI,10395
 netgear_switch/virtual/faces/snmp.py,sha256=y8N3rDwO3AuHWi9Ke10WLG1yzZITpn363PunIG_ZuSk,21252
 netgear_switch/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-python_netgear_switch_library-0.0.post332.dist-info/METADATA,sha256=eeTC7CoEnDaRngHgcVVH3OwD1dzXGalYpcbb82sFbzk,6682
-python_netgear_switch_library-0.0.post332.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-python_netgear_switch_library-0.0.post332.dist-info/entry_points.txt,sha256=mf6HFDGVV0KIDI0dHkh0BNcCjHkSg1lhE70xTzB47WQ,96
-python_netgear_switch_library-0.0.post332.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-python_netgear_switch_library-0.0.post332.dist-info/RECORD,,
+python_netgear_switch_library-0.0.post337.dist-info/METADATA,sha256=XoqUaR7w3F1zOrx4kIjg30fVZZ_azJ0A12Y3GhwlJTA,6682
+python_netgear_switch_library-0.0.post337.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+python_netgear_switch_library-0.0.post337.dist-info/entry_points.txt,sha256=mf6HFDGVV0KIDI0dHkh0BNcCjHkSg1lhE70xTzB47WQ,96
+python_netgear_switch_library-0.0.post337.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+python_netgear_switch_library-0.0.post337.dist-info/RECORD,,