laantungir/fips
1
0
Fork 0
mirror of https://github.com/jmcorgan/fips.git synced 2026-07-22 07:48:26 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
master
fips/docs/reference/transports.md
Johnathan Corgan 507086e39d docs: refresh tutorials, how-to, design, reference, and examples for v0.4.0 
Pre-cut documentation pass for the 0.4.0 release, verified against current source.

Corrections:
- fipsctl: stale 'show identities'/'show node' -> 'show status'
  (host-a-service, run-as-unprivileged-user)
- mesh address derivation: first 16 bytes of SHA-256(pubkey) with the leading
  byte set to 0xfd, not a fixed fd97: prefix (reach-mesh-services,
  ipv6-adapter-walkthrough)
- gateway control socket mode 0660 -> 0770 (troubleshoot-gateway)
- Tor example: add advertised_port: 8443 so the published port matches the
  prose (enable-nostr-discovery)
- bloom mesh-size estimate rewritten to the OR-union-of-peer-filters algorithm;
  plus mtu deep-link, gateway pool wording, and a NAT failure-mode line
- examples: delete orphaned nostr-rs-relay config, accept inbound to the local
  8443 TCP listener, fix fd::/8 -> fd00::/8 typos, dotless wireguard alias

Additions:
- new Nym mixnet transport section (fips-transport-layer) and the architecture
  transport list
- new LAN/mDNS discovery section (fips-nostr-discovery)
- reference docs: Nym transport, LAN discovery, and new control/stats surfaces;
  drop ble from the connect transport list
2026-06-14 15:14:05 +00:00

4.7 KiB
Raw Permalink Blame History

Transport Statistics Reference

Per-transport statistics counter inventories. Counters are exposed through the daemon control socket (fipsctl show transports) and the fipstop operator UI. For the transport-layer design (services provided to FMP, transport categories, the trait surface, connection model), see ../design/fips-transport-layer.md.

All transports report counters via fipsctl show transports; the tables below are source-extracted from each transport's stats.rs module.

UDP

Counter Description
packets_sent / bytes_sent Successful sends
packets_recv / bytes_recv Successful receives
send_errors / recv_errors Send/receive failures
mtu_exceeded Packets rejected for MTU violation
kernel_drops Kernel SO_RXQ_OVFL drop count (feeds ECN congestion detection)

TCP

Counter Description
packets_sent / bytes_sent Successful sends
packets_recv / bytes_recv Successful receives
send_errors / recv_errors Send/receive failures
mtu_exceeded Packets rejected for MTU violation
connections_established Successful outbound connections
connections_accepted Accepted inbound connections
connections_rejected Rejected inbound connections (limit exceeded)
connect_timeouts Connection timeout count
connect_refused Connection refused count
pool_inbound Current inbound connections held in the connection pool (gauge)
pool_outbound Current outbound connections held in the connection pool (gauge)

Ethernet

Counter Description
frames_sent / frames_recv Successful frame send/receive
bytes_sent / bytes_recv Byte counters
send_errors / recv_errors Send/receive failures
beacons_sent / beacons_recv Peer-discovery beacon traffic
frames_too_short Frames below minimum length, dropped
frames_too_long Frames above transport MTU, dropped

Tor

Counter Description
packets_sent / bytes_sent Successful sends
packets_recv / bytes_recv Successful receives
send_errors / recv_errors Send/receive failures
connections_established Successful SOCKS5 connections
connect_timeouts Connection timeout count
connect_refused Connection refused count
socks5_errors SOCKS5 protocol errors
mtu_exceeded Packets rejected for MTU violation
connections_accepted Accepted inbound connections via onion service
connections_rejected Rejected inbound connections (limit exceeded)
control_errors Tor control port errors
pool_inbound Current inbound connections held in the connection pool (gauge)
pool_outbound Current outbound connections held in the connection pool (gauge)

Nym

Counter Description
packets_sent / bytes_sent Successful sends
packets_recv / bytes_recv Successful receives
send_errors / recv_errors Send/receive failures
mtu_exceeded Packets rejected for MTU violation
connections_established Successful SOCKS5 connections through nym-socks5-client
connect_timeouts Connection timeout count
socks5_errors SOCKS5 protocol errors

Nym is outbound-only (no inbound listener), so there are no connections_accepted / connections_rejected counters.

Bluetooth

Counter Description
packets_sent / bytes_sent Successful L2CAP CoC sends
packets_recv / bytes_recv Successful L2CAP CoC receives
send_errors / recv_errors Send/receive failures
mtu_exceeded Packets rejected for MTU violation
connections_established Successful outbound L2CAP connections
connections_accepted Accepted inbound L2CAP connections
connections_rejected Rejected inbound (limit exceeded)
connect_timeouts Connection timeout count
pool_evictions Connection-pool entries evicted
advertisements_sent BLE advertisements emitted
scan_results BLE scan results observed

See also