# technica-engineering/mkadaemon architecture

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

- Interactive diagram: https://gitdiagram.com/technica-engineering/mkadaemon
- Repository: https://github.com/technica-engineering/mkadaemon

## Overview

MKAdaemon implements IEEE 802.1X MACsec Key Agreement on Linux, with PSK support and GCM-AES cipher suites. The user-facing workflow is to configure the daemon, run its per-bus MKA processing, and control or inspect buses through the D-Bus CLI; Linux interfaces provide packet and MACsec integration. The graph preserves the protocol, key-agreement, control, SecY, crypto, and daemon capabilities. Some internal links are omitted because sampled evidence does not show their calls; unsampled configuration and PHY implementations are represented only at their source paths.

Main entry points: [`src/linux_daemon/main.c`](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/main.c) (Daemon launcher), [`src/pae/mka_kay.c`](https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_kay.c) (Key agreement), [`src/mka_main.c`](https://github.com/technica-engineering/mkadaemon/blob/main/src/mka_main.c) (MKA main loop), [`src/linux_daemon/dbus_server.c`](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/dbus_server.c) (D-Bus service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_daemon["Linux daemon"]
  node_cli["Control CLI<br/>[main.c]"]
  node_launcher["Daemon launcher<br/>[main.c]"]
  node_config["Configuration"]
  node_dbus["D-Bus service<br/>[dbus_server.c]"]
end

subgraph group_protocol["MKA protocol"]
  node_core["MKA main loop<br/>[mka_main.c]"]
  node_kay["Key agreement<br/>[mka_kay.c]"]
  node_kayparams["KAY parameters<br/>[mka_kay_params.c]"]
  node_cp["Connectivity control<br/>[mka_cp.c]"]
  node_logon["Logon process<br/>[mka_logon.c]"]
end

subgraph group_security["Crypto and SecY"]
  node_secy["SecY management<br/>[mka_secy.c]"]
  node_crypto["Crypto primitives"]
  node_aes["Key derivation<br/>[aes-kdf.c]"]
end

subgraph group_platform["Linux platform"]
  node_l2["Layer 2 transport<br/>[mka_l2_linux.c]"]
  node_phy["MACsec PHY driver"]
  node_link["Link monitor<br/>[mka_link_monitor.c]"]
  node_timers["Timer events<br/>[mka_timers_event.c]"]
end

node_operator(("Operator"))

node_operator -->|"runs"| node_cli
node_cli -->|"controls bus"| node_dbus
node_operator -.->|"starts daemon"| node_launcher
node_launcher -->|"loads config"| node_config
node_launcher -->|"runs loop"| node_core
node_launcher -->|"uses service"| node_dbus
node_launcher -.->|"initializes driver"| node_phy
node_core -.->|"processes MKA"| node_kay
node_kay -->|"updates control"| node_cp
node_kay -->|"manages security"| node_secy
node_logon -->|"uses KAY"| node_kay
node_logon -->|"uses control"| node_cp
node_secy -->|"uses interface"| node_dbus
node_kay -.->|"uses parameters"| node_kayparams
node_kay -.->|"derives keys"| node_crypto
node_crypto -.->|"uses derivation"| node_aes
node_core -.->|"sends frames"| node_l2
node_launcher -.->|"monitors link"| node_link
node_launcher -.->|"services timers"| node_timers

click node_cli "https://github.com/technica-engineering/mkadaemon/blob/main/src/mkad_cli/main.c"
click node_launcher "https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/main.c"
click node_config "https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_daemon_config.c"
click node_dbus "https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/dbus_server.c"
click node_core "https://github.com/technica-engineering/mkadaemon/blob/main/src/mka_main.c"
click node_kay "https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_kay.c"
click node_kayparams "https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_kay_params.c"
click node_cp "https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_cp.c"
click node_logon "https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_logon.c"
click node_secy "https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_secy.c"
click node_crypto "https://github.com/technica-engineering/mkadaemon/blob/main/src/crypto/mka_crypto_openssl.c"
click node_aes "https://github.com/technica-engineering/mkadaemon/blob/main/src/crypto/aes-kdf.c"
click node_l2 "https://github.com/technica-engineering/mkadaemon/blob/main/src/l2/mka_l2_linux.c"
click node_phy "https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_phy_driver_libnl.c"
click node_link "https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_link_monitor.c"
click node_timers "https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_timers_event.c"

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_cli,node_launcher,node_config,node_dbus toneBlue
class node_core,node_kay,node_kayparams,node_cp,node_logon toneAmber
class node_secy,node_crypto,node_aes toneMint
class node_l2,node_phy,node_link,node_timers toneRose
class node_operator toneIndigo
```

## Components

### Linux daemon

- [Control CLI](https://github.com/technica-engineering/mkadaemon/blob/main/src/mkad_cli/main.c): `src/mkad_cli/main.c`
- [Daemon launcher](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/main.c): `src/linux_daemon/main.c`
- [Configuration](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_daemon_config.c): `src/linux_daemon/mka_daemon_config.c`
- [D-Bus service](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/dbus_server.c): `src/linux_daemon/dbus_server.c`

### MKA protocol

- [MKA main loop](https://github.com/technica-engineering/mkadaemon/blob/main/src/mka_main.c): `src/mka_main.c`
- [Key agreement](https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_kay.c): `src/pae/mka_kay.c`
- [KAY parameters](https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_kay_params.c): `src/pae/mka_kay_params.c`
- [Connectivity control](https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_cp.c): `src/pae/mka_cp.c`
- [Logon process](https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_logon.c): `src/pae/mka_logon.c`

### Crypto and SecY

- [SecY management](https://github.com/technica-engineering/mkadaemon/blob/main/src/pae/mka_secy.c): `src/pae/mka_secy.c`
- [Crypto primitives](https://github.com/technica-engineering/mkadaemon/blob/main/src/crypto/mka_crypto_openssl.c): `src/crypto/mka_crypto_openssl.c`
- [Key derivation](https://github.com/technica-engineering/mkadaemon/blob/main/src/crypto/aes-kdf.c): `src/crypto/aes-kdf.c`

### Linux platform

- [Layer 2 transport](https://github.com/technica-engineering/mkadaemon/blob/main/src/l2/mka_l2_linux.c): `src/l2/mka_l2_linux.c`
- [MACsec PHY driver](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_phy_driver_libnl.c): `src/linux_daemon/mka_phy_driver_libnl.c`
- [Link monitor](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_link_monitor.c): `src/linux_daemon/mka_link_monitor.c`
- [Timer events](https://github.com/technica-engineering/mkadaemon/blob/main/src/linux_daemon/mka_timers_event.c): `src/linux_daemon/mka_timers_event.c`

### Other components

- **Operator**

## Connections

- Operator → Control CLI: runs
- Control CLI → D-Bus service: controls bus (evidence: `src/mkad_cli/main.c`)
- Operator → Daemon launcher: starts daemon
- Daemon launcher → Configuration: loads config (evidence: `src/linux_daemon/main.c`)
- Daemon launcher → MKA main loop: runs loop (evidence: `src/linux_daemon/main.c`)
- Daemon launcher → D-Bus service: uses service (evidence: `src/linux_daemon/main.c`)
- Daemon launcher → MACsec PHY driver: initializes driver
- MKA main loop → Key agreement: processes MKA
- Key agreement → Connectivity control: updates control (evidence: `src/pae/mka_cp.c`)
- Key agreement → SecY management: manages security
- Logon process → Key agreement: uses KAY (evidence: `src/pae/mka_logon.c`)
- Logon process → Connectivity control: uses control (evidence: `src/pae/mka_logon.c`)
- SecY management → D-Bus service: uses interface (evidence: `src/pae/mka_secy.c`)
- Key agreement → KAY parameters: uses parameters
- Key agreement → Crypto primitives: derives keys
- Crypto primitives → Key derivation: uses derivation
- MKA main loop → Layer 2 transport: sends frames
- Daemon launcher → Link monitor: monitors link
- Daemon launcher → Timer events: services timers
