# gopinathb87/sonic-swss architecture

> Architecture diagram of the GitHub repository gopinathb87/sonic-swss, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gopinathb87/sonic-swss
- Repository: https://github.com/gopinathb87/sonic-swss

## Overview

SONiC SWSS is the switch-state service: it provides database-backed communication between network applications and switch hardware. Its broad workflow is configuration or network-state updates entering SWSS services, being represented and synchronized through databases, then applied by orchagent through SAI to hardware. The tree also shows routing, neighbor, FDB, port, team, gearbox, and multi-chassis synchronization, plus P4, DASH, counters, and warm-restart support. Source evidence is sampled unevenly, so only directly documented or indexed relationships are connected.

Main entry points: [`orchagent/p4orch/p4orch.cpp`](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/p4orch.cpp) (P4 Orchestration), [`fpmsyncd/routesync.cpp`](https://github.com/gopinathb87/sonic-swss/blob/master/fpmsyncd/routesync.cpp) (FPM Route Sync), [`orchagent/main.cpp`](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/main.cpp) (Orchagent Entry), [`orchagent/orchdaemon.cpp`](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/orchdaemon.cpp) (Orchestration Daemon)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sync["State Synchronization"]
  node_fpm["FPM Route Sync<br/>[routesync.cpp]"]
  node_fdb["FDB Sync<br/>[fdbsync.cpp]"]
  node_neighbor["Neighbor Sync<br/>[neighsync.cpp]"]
  node_portlink["Port Link Sync<br/>[linksync.cpp]"]
  node_team["Team Sync<br/>[teamsync.cpp]"]
  node_mclag["MCLAG Sync<br/>[mclaglink.cpp]"]
  node_nat_sync["NAT Sync<br/>[natsync.cpp]"]
  node_gear["Gearbox Sync<br/>[gearboxparser.cpp]"]
  node_teamd["Teamd Control<br/>[main.cpp]"]
end

subgraph group_config["Configuration Managers"]
  node_cfgmgr["Config Managers"]
end

subgraph group_orch["Hardware Orchestration"]
  node_orch_main["Orchagent Entry<br/>[main.cpp]"]
  node_orchdaemon["Orchestration Daemon<br/>[orchdaemon.cpp]"]
  node_ports["Port Orchestration<br/>[portsorch.h]"]
  node_routing["Route Orchestration<br/>[routeorch.cpp]"]
  node_acl["ACL Orchestration<br/>[aclorch.cpp]"]
  node_dash["DASH Orchestration<br/>[dashorch.cpp]"]
end

subgraph group_p4["P4 Orchestration"]
  node_p4orch["P4 Orchestration<br/>[p4orch.cpp]"]
  node_p4_acl["P4 ACL Managers"]
  node_p4_route["P4 Route Manager<br/>[route_manager.cpp]"]
  node_p4_tables["P4 Table Manager"]
end

subgraph group_support["Operations Support"]
  node_crm["Resource Monitoring<br/>[crmorch.h]"]
  node_flex["Flex Counters"]
  node_warm["Warm Restart"]
end

node_network(("Network Stack"))
node_applications(("Network Applications"))
node_hardware{{"Switch Hardware"}}
node_db[("SWSS Databases")]

node_network -.->|"sends routes"| node_fpm
node_fpm -->|"publishes state"| node_db
node_applications -.->|"exchanges state"| node_db
node_db -.->|"provides state"| node_orch_main
node_orch_main -->|"initializes and starts"| node_orchdaemon
node_orchdaemon -.->|"applies switch state"| node_hardware
node_db -.->|"supplies configuration"| node_cfgmgr
node_fpm -->|"exports route state"| node_db
node_p4orch -->|"uses manager"| node_p4_acl
node_p4orch -->|"uses manager"| node_p4_route
node_p4orch -->|"uses manager"| node_p4_tables
node_ports -->|"uses counters"| node_flex
node_fdb -.->|"synchronizes state"| node_db
node_neighbor -.->|"synchronizes state"| node_db
node_portlink -.->|"synchronizes state"| node_db
node_team -.->|"synchronizes state"| node_db
node_mclag -.->|"synchronizes state"| node_db
node_nat_sync -.->|"synchronizes state"| node_db
node_gear -.->|"synchronizes state"| node_db
node_crm -.->|"reports resources"| node_db
node_dash -.->|"handles state"| node_db
node_teamd -->|"reads and updates"| node_db
node_warm -.->|"assists recovery"| node_db

click node_fpm "https://github.com/gopinathb87/sonic-swss/blob/master/fpmsyncd/routesync.cpp"
click node_fdb "https://github.com/gopinathb87/sonic-swss/blob/master/fdbsyncd/fdbsync.cpp"
click node_neighbor "https://github.com/gopinathb87/sonic-swss/blob/master/neighsyncd/neighsync.cpp"
click node_portlink "https://github.com/gopinathb87/sonic-swss/blob/master/portsyncd/linksync.cpp"
click node_team "https://github.com/gopinathb87/sonic-swss/blob/master/teamsyncd/teamsync.cpp"
click node_mclag "https://github.com/gopinathb87/sonic-swss/blob/master/mclagsyncd/mclaglink.cpp"
click node_nat_sync "https://github.com/gopinathb87/sonic-swss/blob/master/natsyncd/natsync.cpp"
click node_gear "https://github.com/gopinathb87/sonic-swss/blob/master/gearsyncd/gearboxparser.cpp"
click node_cfgmgr "https://github.com/gopinathb87/sonic-swss/tree/master/cfgmgr"
click node_orch_main "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/main.cpp"
click node_orchdaemon "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/orchdaemon.cpp"
click node_ports "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/portsorch.h"
click node_routing "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/routeorch.cpp"
click node_acl "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/aclorch.cpp"
click node_p4orch "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/p4orch.cpp"
click node_p4_acl "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/acl_rule_manager.cpp"
click node_p4_route "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/route_manager.cpp"
click node_p4_tables "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/tables_definition_manager.h"
click node_crm "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/crmorch.h"
click node_flex "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/flex_counter/flex_counter_manager.cpp"
click node_dash "https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/dash/dashorch.cpp"
click node_warm "https://github.com/gopinathb87/sonic-swss/blob/master/warmrestart/warmRestartAssist.cpp"
click node_teamd "https://github.com/gopinathb87/sonic-swss/blob/master/tlm_teamd/main.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_fpm,node_fdb,node_neighbor,node_portlink,node_team,node_mclag,node_nat_sync,node_gear,node_teamd toneBlue
class node_cfgmgr,node_db toneAmber
class node_orch_main,node_orchdaemon,node_ports,node_routing,node_acl,node_dash toneMint
class node_p4orch,node_p4_acl,node_p4_route,node_p4_tables toneRose
class node_crm,node_flex,node_warm,node_network,node_applications,node_hardware toneIndigo
```

## Components

### State Synchronization

- [FPM Route Sync](https://github.com/gopinathb87/sonic-swss/blob/master/fpmsyncd/routesync.cpp): `fpmsyncd/routesync.cpp`
- [FDB Sync](https://github.com/gopinathb87/sonic-swss/blob/master/fdbsyncd/fdbsync.cpp): `fdbsyncd/fdbsync.cpp`
- [Neighbor Sync](https://github.com/gopinathb87/sonic-swss/blob/master/neighsyncd/neighsync.cpp): `neighsyncd/neighsync.cpp`
- [Port Link Sync](https://github.com/gopinathb87/sonic-swss/blob/master/portsyncd/linksync.cpp): `portsyncd/linksync.cpp`
- [Team Sync](https://github.com/gopinathb87/sonic-swss/blob/master/teamsyncd/teamsync.cpp): `teamsyncd/teamsync.cpp`
- [MCLAG Sync](https://github.com/gopinathb87/sonic-swss/blob/master/mclagsyncd/mclaglink.cpp): `mclagsyncd/mclaglink.cpp`
- [NAT Sync](https://github.com/gopinathb87/sonic-swss/blob/master/natsyncd/natsync.cpp): `natsyncd/natsync.cpp`
- [Gearbox Sync](https://github.com/gopinathb87/sonic-swss/blob/master/gearsyncd/gearboxparser.cpp): `gearsyncd/gearboxparser.cpp`
- [Teamd Control](https://github.com/gopinathb87/sonic-swss/blob/master/tlm_teamd/main.cpp): `tlm_teamd/main.cpp`

### Configuration Managers

- [Config Managers](https://github.com/gopinathb87/sonic-swss/tree/master/cfgmgr): `cfgmgr`

### Hardware Orchestration

- [Orchagent Entry](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/main.cpp): `orchagent/main.cpp`
- [Orchestration Daemon](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/orchdaemon.cpp): `orchagent/orchdaemon.cpp`
- [Port Orchestration](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/portsorch.h): `orchagent/portsorch.h`
- [Route Orchestration](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/routeorch.cpp): `orchagent/routeorch.cpp`
- [ACL Orchestration](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/aclorch.cpp): `orchagent/aclorch.cpp`
- [DASH Orchestration](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/dash/dashorch.cpp): `orchagent/dash/dashorch.cpp`

### P4 Orchestration

- [P4 Orchestration](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/p4orch.cpp): `orchagent/p4orch/p4orch.cpp`
- [P4 ACL Managers](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/acl_rule_manager.cpp): `orchagent/p4orch/acl_rule_manager.cpp`
- [P4 Route Manager](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/route_manager.cpp): `orchagent/p4orch/route_manager.cpp`
- [P4 Table Manager](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/p4orch/tables_definition_manager.h): `orchagent/p4orch/tables_definition_manager.h`

### Operations Support

- [Resource Monitoring](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/crmorch.h): `orchagent/crmorch.h`
- [Flex Counters](https://github.com/gopinathb87/sonic-swss/blob/master/orchagent/flex_counter/flex_counter_manager.cpp): `orchagent/flex_counter/flex_counter_manager.cpp`
- [Warm Restart](https://github.com/gopinathb87/sonic-swss/blob/master/warmrestart/warmRestartAssist.cpp): `warmrestart/warmRestartAssist.cpp`

### Other components

- **Network Stack**
- **Network Applications**
- **Switch Hardware**
- **SWSS Databases**

## Connections

- Network Stack → FPM Route Sync: sends routes (evidence: `fpmsyncd/routesync.cpp`)
- FPM Route Sync → SWSS Databases: publishes state
- Network Applications → SWSS Databases: exchanges state
- SWSS Databases → Orchagent Entry: provides state
- Orchagent Entry → Orchestration Daemon: initializes and starts (evidence: `orchagent/main.cpp`)
- Orchestration Daemon → Switch Hardware: applies switch state
- SWSS Databases → Config Managers: supplies configuration
- FPM Route Sync → SWSS Databases: exports route state
- P4 Orchestration → P4 ACL Managers: uses manager
- P4 Orchestration → P4 Route Manager: uses manager
- P4 Orchestration → P4 Table Manager: uses manager
- Port Orchestration → Flex Counters: uses counters (evidence: `orchagent/portsorch.h`)
- FDB Sync → SWSS Databases: synchronizes state
- Neighbor Sync → SWSS Databases: synchronizes state
- Port Link Sync → SWSS Databases: synchronizes state
- Team Sync → SWSS Databases: synchronizes state
- MCLAG Sync → SWSS Databases: synchronizes state
- NAT Sync → SWSS Databases: synchronizes state
- Gearbox Sync → SWSS Databases: synchronizes state
- Resource Monitoring → SWSS Databases: reports resources
- DASH Orchestration → SWSS Databases: handles state
- Teamd Control → SWSS Databases: reads and updates (evidence: `tlm_teamd/main.cpp`)
- Warm Restart → SWSS Databases: assists recovery
