docs: collect what is known for LANCOM drivers

No code yet and no test device. The README maps LANCOM's four operating
systems (LCOS, LCOS SX, LCOS LX, LCOS FX) to planned entry points and
napalm-device-types role bases. docs/lcos-sx3.md covers the first target
(GS-23xx on LCOS SX 3.34): CLI model, getter-to-command map from the
GS-2300 CLI reference, and the open get_config question (TFTP-only
export). docs/fixtures.md lists the output to record from a real device.

Refs NetOrk/netork#1094
This commit is contained in:
Christian Manivong committed 2026-10-13 00:31:29 +02:00
commit 83fba8646d
9 files changed
+488

No files matched your search

+52
View File
@@ -0,0 +1,52 @@
# Fixtures to capture
Record raw output from a real device the first time one is connected. Store it under
`tests/fixtures/<model>-<firmware>/` (e.g. `gs-2310p-plus-3.34/`), one file per command,
plus a `COMMANDS.txt` that lists the command, the section it ran in, and the device state
that matters (links up/down, PoE consumers, LLDP neighbours present or not).
Scrub before committing: serial numbers, public IPs, SNMP communities, hostnames that
identify a site.
## LCOS SX 3 (GS-23xx)
Session basics:
- [ ] login banner and the first prompt after SSH login
- [ ] `?` at the top level (list of sections)
- [ ] `?` inside each section listed below
- [ ] the error text of an invalid command and of an invalid parameter
Per section:
- [ ] `system` → `show`
- [ ] `firmware` → `show`
- [ ] `port` → `show configuration`
- [ ] `port` → `show status` (with at least one link up and one down)
- [ ] `port` → `show simple-counter`
- [ ] `port` → `show detail-counter 1`
- [ ] `port` → `show sfp <sfp-port>` (with and without a module)
- [ ] `ip` → `show`
- [ ] `ipv6` → `show current`
- [ ] `fdb` → `show mac-table`
- [ ] `fdb` → `show static-mac`
- [ ] `lldp` → `show config`
- [ ] `lldp` → `show info <port-list>` (with a neighbour, e.g. another switch or a router)
- [ ] `vlan` → `show vlan`
- [ ] `vlan` → `show port-config`
- [ ] `vlan` → `show port-status static`
- [ ] `thermal` → `show`
- [ ] `snmp` → `show snmp`
- [ ] `snmp` → `show community`
- [ ] `time` → `show ntp`
- [ ] `poe` → `show config` (PoE models only)
- [ ] `poe` → `show status` (with a powered device attached)
- [ ] `aggregation` → `show`
- [ ] `lacp` → `show status`
- [ ] `stp` → `show status`
- [ ] `syslog` → `show log`
Configuration:
- [ ] `config-file` → `export` to a TFTP server once (the XML file itself)
- [ ] whether the web UI offers a configuration download, and how (URL, auth)