# qualcomm/userspace-resource-manager architecture

> Architecture diagram of the GitHub repository qualcomm/userspace-resource-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qualcomm/userspace-resource-manager
- Repository: https://github.com/qualcomm/userspace-resource-manager

## Overview

URM is a userspace resource manager, with resource-tuner as its request-driven resource-control service and contextual-classifier as an optional use-case identification capability. The documented client interface encodes requests and communicates over a Unix socket; the server-side modules manage requests and configured resources. Configuration also covers resources, signals, properties, targets, and application settings. The graph preserves these product branches, but sampled source does not establish every runtime dispatch or the classifier’s final effect on tuning; those links are omitted rather than assumed.

Main entry points: [`contextual-classifier/ContextualClassifier.cpp`](https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/ContextualClassifier.cpp) (Contextual classifier), [`client/APIs/UrmAPIs.cpp`](https://github.com/qualcomm/userspace-resource-manager/blob/main/client/APIs/UrmAPIs.cpp) (Client APIs), [`resource-tuner/core/ResourceRegistry.cpp`](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/ResourceRegistry.cpp) (Resource registry), [`resource-tuner/signals/SignalRegistry.cpp`](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/signals/SignalRegistry.cpp) (Signal registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client interface"]
  node_client_api["Client APIs<br/>[UrmAPIs.cpp]"]
  node_socket_client["Socket client<br/>[SocketClient.cpp]"]
end

subgraph group_runtime["URM runtime"]
  node_daemon["URM daemon<br/>[urm.cpp]"]
  node_request_receiver["Request receiver"]
  node_request_handler["Request handler<br/>[RequestHandler.cpp]"]
  node_request_manager["Request manager<br/>[RequestManager.cpp]"]
  node_client_data[("Client tracking")]
  node_dbus["D-Bus integration"]
end

subgraph group_config["Configuration and signals"]
  node_resource_registry[("Resource registry")]
  node_config_parser["Config parser<br/>[RestuneParser.cpp]"]
  node_signal_handler["Signal handler<br/>[SignalHandler.cpp]"]
  node_signal_registry[("Signal registry<br/>[SignalRegistry.cpp]")]
end

subgraph group_classifier["Contextual classifier"]
  node_classifier["Contextual classifier"]
  node_feature_extractor["Feature extractor"]
  node_feature_pruner["Feature pruner<br/>[FeaturePruner.cpp]"]
  node_ml_inference["ML inference<br/>[MLInference.cpp]"]
end

subgraph group_shared["Shared runtime"]
  node_extensions["Extensions<br/>[Extensions.cpp]"]
  node_request_model["Request model<br/>[Request.cpp]"]
  node_aux_routines["Core utilities<br/>[AuxRoutines.cpp]"]
  node_settings["URM settings<br/>[UrmSettings.cpp]"]
end

node_application(("URM client"))

node_application -->|"submits requests"| node_client_api
node_client_api -->|"uses socket"| node_socket_client
node_client_api -->|"uses utilities"| node_aux_routines
node_request_handler -->|"references"| node_request_manager
node_request_handler -->|"references"| node_resource_registry
node_config_parser -->|"configures"| node_resource_registry
node_config_parser -->|"configures"| node_signal_registry
node_signal_handler -->|"queries signals"| node_signal_registry
node_classifier -->|"references"| node_signal_registry
node_classifier -->|"uses features"| node_feature_extractor
node_classifier -->|"uses pruning"| node_feature_pruner
node_classifier -->|"uses inference"| node_ml_inference
node_ml_inference -->|"uses features"| node_feature_extractor
node_request_model -->|"resource types"| node_resource_registry
node_aux_routines -->|"uses settings"| node_settings
node_classifier -->|"references extensions"| node_extensions

click node_client_api "https://github.com/qualcomm/userspace-resource-manager/blob/main/client/APIs/UrmAPIs.cpp"
click node_socket_client "https://github.com/qualcomm/userspace-resource-manager/blob/main/client/Comm/Socket/SocketClient.cpp"
click node_daemon "https://github.com/qualcomm/userspace-resource-manager/blob/main/urm.cpp"
click node_request_receiver "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/Server/RequestReceiver.cpp"
click node_request_handler "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/RequestHandler.cpp"
click node_request_manager "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/RequestManager.cpp"
click node_client_data "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/ClientDataManager.cpp"
click node_resource_registry "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/ResourceRegistry.cpp"
click node_config_parser "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/init/RestuneParser.cpp"
click node_signal_handler "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/signals/SignalHandler.cpp"
click node_signal_registry "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/signals/SignalRegistry.cpp"
click node_classifier "https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/ContextualClassifier.cpp"
click node_feature_extractor "https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/FeatureExtractor.cpp"
click node_feature_pruner "https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/FeaturePruner.cpp"
click node_ml_inference "https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/MLInference.cpp"
click node_extensions "https://github.com/qualcomm/userspace-resource-manager/blob/main/extensions/Extensions.cpp"
click node_request_model "https://github.com/qualcomm/userspace-resource-manager/blob/main/modula/Common/Request.cpp"
click node_aux_routines "https://github.com/qualcomm/userspace-resource-manager/blob/main/modula/CoreModules/AuxRoutines.cpp"
click node_settings "https://github.com/qualcomm/userspace-resource-manager/blob/main/modula/CoreModules/UrmSettings.cpp"
click node_dbus "https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/dbus-modules/RestuneDBusInternal.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_client_api,node_socket_client,node_application toneBlue
class node_daemon,node_request_receiver,node_request_handler,node_request_manager,node_client_data,node_dbus toneAmber
class node_resource_registry,node_config_parser,node_signal_handler,node_signal_registry toneMint
class node_classifier,node_feature_extractor,node_feature_pruner,node_ml_inference toneRose
class node_extensions,node_request_model,node_aux_routines,node_settings toneIndigo
```

## Components

### Client interface

- [Client APIs](https://github.com/qualcomm/userspace-resource-manager/blob/main/client/APIs/UrmAPIs.cpp): `client/APIs/UrmAPIs.cpp`
- [Socket client](https://github.com/qualcomm/userspace-resource-manager/blob/main/client/Comm/Socket/SocketClient.cpp): `client/Comm/Socket/SocketClient.cpp`

### URM runtime

- [URM daemon](https://github.com/qualcomm/userspace-resource-manager/blob/main/urm.cpp): `urm.cpp`
- [Request receiver](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/Server/RequestReceiver.cpp): `resource-tuner/core/Server/RequestReceiver.cpp`
- [Request handler](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/RequestHandler.cpp): `resource-tuner/core/RequestHandler.cpp`
- [Request manager](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/RequestManager.cpp): `resource-tuner/core/RequestManager.cpp`
- [Client tracking](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/ClientDataManager.cpp): `resource-tuner/core/ClientDataManager.cpp`
- [D-Bus integration](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/dbus-modules/RestuneDBusInternal.cpp): `resource-tuner/dbus-modules/RestuneDBusInternal.cpp`

### Configuration and signals

- [Resource registry](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/core/ResourceRegistry.cpp): `resource-tuner/core/ResourceRegistry.cpp`
- [Config parser](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/init/RestuneParser.cpp): `resource-tuner/init/RestuneParser.cpp`
- [Signal handler](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/signals/SignalHandler.cpp): `resource-tuner/signals/SignalHandler.cpp`
- [Signal registry](https://github.com/qualcomm/userspace-resource-manager/blob/main/resource-tuner/signals/SignalRegistry.cpp): `resource-tuner/signals/SignalRegistry.cpp`

### Contextual classifier

- [Contextual classifier](https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/ContextualClassifier.cpp): `contextual-classifier/ContextualClassifier.cpp`
- [Feature extractor](https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/FeatureExtractor.cpp): `contextual-classifier/FeatureExtractor.cpp`
- [Feature pruner](https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/FeaturePruner.cpp): `contextual-classifier/FeaturePruner.cpp`
- [ML inference](https://github.com/qualcomm/userspace-resource-manager/blob/main/contextual-classifier/MLInference.cpp): `contextual-classifier/MLInference.cpp`

### Shared runtime

- [Extensions](https://github.com/qualcomm/userspace-resource-manager/blob/main/extensions/Extensions.cpp): `extensions/Extensions.cpp`
- [Request model](https://github.com/qualcomm/userspace-resource-manager/blob/main/modula/Common/Request.cpp): `modula/Common/Request.cpp`
- [Core utilities](https://github.com/qualcomm/userspace-resource-manager/blob/main/modula/CoreModules/AuxRoutines.cpp): `modula/CoreModules/AuxRoutines.cpp`
- [URM settings](https://github.com/qualcomm/userspace-resource-manager/blob/main/modula/CoreModules/UrmSettings.cpp): `modula/CoreModules/UrmSettings.cpp`

### Other components

- **URM client**

## Connections

- URM client → Client APIs: submits requests (evidence: `README.md`)
- Client APIs → Socket client: uses socket (evidence: `client/APIs/UrmAPIs.cpp`)
- Client APIs → Core utilities: uses utilities (evidence: `client/APIs/UrmAPIs.cpp`)
- Request handler → Request manager: references
- Request handler → Resource registry: references
- Config parser → Resource registry: configures
- Config parser → Signal registry: configures
- Signal handler → Signal registry: queries signals (evidence: `resource-tuner/signals/SignalHandler.cpp`)
- Contextual classifier → Signal registry: references (evidence: `contextual-classifier/ContextualClassifier.cpp`)
- Contextual classifier → Feature extractor: uses features (evidence: `contextual-classifier/ContextualClassifier.cpp`)
- Contextual classifier → Feature pruner: uses pruning (evidence: `contextual-classifier/ContextualClassifier.cpp`)
- Contextual classifier → ML inference: uses inference (evidence: `contextual-classifier/ContextualClassifier.cpp`)
- ML inference → Feature extractor: uses features (evidence: `contextual-classifier/MLInference.cpp`)
- Request model → Resource registry: resource types
- Core utilities → URM settings: uses settings
- Contextual classifier → Extensions: references extensions (evidence: `contextual-classifier/ContextualClassifier.cpp`)
