# y-lebid/sysmon architecture

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

- Interactive diagram: https://gitdiagram.com/y-lebid/sysmon
- Repository: https://github.com/y-lebid/sysmon

## Overview

sysmon is a Linux command-line system-information utility. Its workflow constructs a SystemInfo snapshot from Linux interfaces, then prints system, hardware, CPU, memory, and GPU details. The implementation excerpt supports the collection and display relationships shown; README-documented capabilities such as serial number and UUID are exposed by the API even though the CLI does not print them.

Main entry points: [`src/system_info.cpp`](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp) (SystemInfo collector), [`src/main.cpp`](https://github.com/y-lebid/sysmon/blob/main/src/main.cpp) (CLI display)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI"]
  node_main["CLI display<br/>[main.cpp]"]
end

subgraph group_collect["Information Collection"]
  node_system_info["SystemInfo collector<br/>[system_info.cpp]"]
  node_system_data["System identity<br/>[system_info.cpp]"]
  node_hardware_data["Hardware details<br/>[system_info.cpp]"]
  node_cpu_data["CPU details<br/>[system_info.cpp]"]
  node_memory_data["Memory details<br/>[system_info.cpp]"]
  node_gpu_data["GPU details<br/>[system_info.cpp]"]
end

subgraph group_sources["Linux Sources"]
  node_os_files["OS files"]
  node_proc_cpu["CPU procfs"]
  node_proc_mem["Memory procfs"]
  node_uptime_file["Uptime procfs"]
  node_dmi["DMI sysfs"]
  node_uname["uname&#40;&#41;"]
  node_drm["DRM sysfs"]
  node_pci_ids["PCI ID database"]
end

node_user(("CLI user"))
node_stdout(("Terminal output"))

node_user -->|"runs"| node_main
node_main -->|"constructs"| node_system_info
node_main -->|"requests fields"| node_system_info
node_main -->|"prints results"| node_stdout
node_system_info -->|"collects"| node_system_data
node_system_info -->|"collects"| node_hardware_data
node_system_info -->|"collects"| node_cpu_data
node_system_info -->|"collects"| node_memory_data
node_system_info -->|"collects"| node_gpu_data
node_system_data -->|"reads"| node_os_files
node_system_data -->|"reads"| node_uptime_file
node_system_data -->|"calls"| node_uname
node_hardware_data -->|"reads"| node_dmi
node_cpu_data -->|"reads"| node_proc_cpu
node_memory_data -->|"reads"| node_proc_mem
node_gpu_data -->|"reads IDs"| node_drm
node_gpu_data -->|"looks up names"| node_pci_ids

click node_main "https://github.com/y-lebid/sysmon/blob/main/src/main.cpp"
click node_system_info "https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp"
click node_system_data "https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp"
click node_hardware_data "https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp"
click node_cpu_data "https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp"
click node_memory_data "https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp"
click node_gpu_data "https://github.com/y-lebid/sysmon/blob/main/src/system_info.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_main,node_user toneBlue
class node_system_info,node_system_data,node_hardware_data,node_cpu_data,node_memory_data,node_gpu_data toneAmber
class node_os_files,node_proc_cpu,node_proc_mem,node_uptime_file,node_dmi,node_uname,node_drm,node_pci_ids toneMint
class node_stdout toneIndigo
```

## Components

### CLI

- [CLI display](https://github.com/y-lebid/sysmon/blob/main/src/main.cpp): `src/main.cpp`

### Information Collection

- [SystemInfo collector](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp): `src/system_info.cpp`
- [System identity](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp): `src/system_info.cpp`
- [Hardware details](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp): `src/system_info.cpp`
- [CPU details](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp): `src/system_info.cpp`
- [Memory details](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp): `src/system_info.cpp`
- [GPU details](https://github.com/y-lebid/sysmon/blob/main/src/system_info.cpp): `src/system_info.cpp`

### Linux Sources

- **OS files**
- **CPU procfs**
- **Memory procfs**
- **Uptime procfs**
- **DMI sysfs**
- **uname()**
- **DRM sysfs**
- **PCI ID database**

### Other components

- **CLI user**
- **Terminal output**

## Connections

- CLI user → CLI display: runs (evidence: `README.md`)
- CLI display → SystemInfo collector: constructs (evidence: `src/main.cpp`)
- CLI display → SystemInfo collector: requests fields (evidence: `src/main.cpp`)
- CLI display → Terminal output: prints results (evidence: `src/main.cpp`)
- SystemInfo collector → System identity: collects (evidence: `src/system_info.cpp`)
- SystemInfo collector → Hardware details: collects (evidence: `src/system_info.cpp`)
- SystemInfo collector → CPU details: collects (evidence: `src/system_info.cpp`)
- SystemInfo collector → Memory details: collects (evidence: `src/system_info.cpp`)
- SystemInfo collector → GPU details: collects (evidence: `src/system_info.cpp`)
- System identity → OS files: reads (evidence: `src/system_info.cpp`)
- System identity → Uptime procfs: reads (evidence: `src/system_info.cpp`)
- System identity → uname(): calls (evidence: `src/system_info.cpp`)
- Hardware details → DMI sysfs: reads (evidence: `src/system_info.cpp`)
- CPU details → CPU procfs: reads (evidence: `src/system_info.cpp`)
- Memory details → Memory procfs: reads (evidence: `src/system_info.cpp`)
- GPU details → DRM sysfs: reads IDs (evidence: `src/system_info.cpp`)
- GPU details → PCI ID database: looks up names (evidence: `src/system_info.cpp`)
