# ansanjay/unix-domain-mux-state-machine architecture

> Architecture diagram of the GitHub repository ansanjay/unix-domain-mux-state-machine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ansanjay/unix-domain-mux-state-machine
- Repository: https://github.com/ansanjay/unix-domain-mux-state-machine

## Overview

This is a UNIX-domain socket client/server example: a client sends integers, and a `select()`-driven server tracks multiple clients, accumulates each client’s values, and returns its total when it receives zero. The graph separates client interaction, server multiplexing, and per-client state. Relationships reflect the README and sampled C excerpts; helpers and protocol constants are kept at their actual source paths.

Main entry points: [`client.c`](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/client.c) (Client Interaction), [`server.c`](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c) (Select Loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_client_app["Client Interaction<br/>[client.c]"]
end

subgraph group_server["Server"]
  node_listener["Socket Listener<br/>[server.c]"]
  node_multiplexer["Select Loop<br/>[server.c]"]
  node_fd_registry["FD Registry<br/>[server.c]"]
end

subgraph group_state["Client State"]
  node_client_handler["Client Data Handler<br/>[server.c]"]
  node_result_state["Per-Client Totals<br/>[server.c]"]
end

node_user(("Terminal User"))

node_user -->|"enters values"| node_client_app
node_client_app -->|"connects socket"| node_listener
node_listener -->|"registers listener"| node_multiplexer
node_multiplexer -->|"refreshes descriptors"| node_fd_registry
node_multiplexer -->|"accepts connections"| node_listener
node_multiplexer -->|"dispatches ready client"| node_client_handler
node_client_app -->|"sends integers"| node_client_handler
node_client_handler -->|"updates total"| node_result_state
node_client_handler -->|"returns total"| node_client_app
node_client_app -->|"displays result"| node_user

click node_client_app "https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/client.c"
click node_listener "https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c"
click node_multiplexer "https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c"
click node_fd_registry "https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c"
click node_client_handler "https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c"
click node_result_state "https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.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_client_app,node_user toneBlue
class node_listener,node_multiplexer,node_fd_registry toneAmber
class node_client_handler,node_result_state toneMint
```

## Components

### Client

- [Client Interaction](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/client.c): `client.c`

### Server

- [Socket Listener](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c): `server.c`
- [Select Loop](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c): `server.c`
- [FD Registry](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c): `server.c`

### Client State

- [Client Data Handler](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c): `server.c`
- [Per-Client Totals](https://github.com/ansanjay/unix-domain-mux-state-machine/blob/main/server.c): `server.c`

### Other components

- **Terminal User**

## Connections

- Terminal User → Client Interaction: enters values (evidence: `client.c`)
- Client Interaction → Socket Listener: connects socket (evidence: `README.md`)
- Socket Listener → Select Loop: registers listener (evidence: `server.c`)
- Select Loop → FD Registry: refreshes descriptors (evidence: `server.c`)
- Select Loop → Socket Listener: accepts connections (evidence: `server.c`)
- Select Loop → Client Data Handler: dispatches ready client (evidence: `server.c`)
- Client Interaction → Client Data Handler: sends integers (evidence: `README.md`)
- Client Data Handler → Per-Client Totals: updates total (evidence: `server.c`)
- Client Data Handler → Client Interaction: returns total (evidence: `README.md`)
- Client Interaction → Terminal User: displays result (evidence: `client.c`)
