# koush/superuser architecture

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

- Interactive diagram: https://gitdiagram.com/koush/superuser
- Repository: https://github.com/koush/superuser

## Overview

Superuser is an Android root-access gateway: an app invokes `su`, the native request path brokers authorization, and the Android app can prompt for a decision and retain policy and audit history. The app also exposes policy, log, and security settings screens, plus recovery-install support. The README documents multiuser and concurrent-request handling as product requirements. Some native-to-app and native database interactions are not visible in the excerpts, so those links are marked unverified rather than asserted.

Main entry points: [`Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java`](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java) (Request Prompt), [`Superuser/src/com/koushikdutta/superuser/MainActivity.java`](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/MainActivity.java) (Main App), [`Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java`](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java) (UID Policy Store), [`Superuser/jni/su/daemon.c`](https://github.com/koush/superuser/blob/master/Superuser/jni/su/daemon.c) (su Daemon)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_native["Native Root Access"]
  node_su_cli["su Command<br/>[su.c]"]
  node_daemon["su Daemon<br/>[daemon.c]"]
  node_native_db["Native Policy Lookup<br/>[db.c]"]
end

subgraph group_approval["Request Approval"]
  node_app_request["Request Prompt"]
  node_request_entry["Request Entry"]
  node_pin["PIN Entry<br/>[PinViewHelper.java]"]
end

subgraph group_management["Policy and History"]
  node_policy_ui["Policy Management"]
  node_log_ui["Access History<br/>[LogFragment.java]"]
  node_policy_store[("UID Policy Store")]
  node_audit_store[("Access Log Store")]
  node_policy_model["Policy Model<br/>[UidPolicy.java]"]
  node_log_model["Log Record<br/>[LogEntry.java]"]
end

subgraph group_operations["App Operations"]
  node_settings_ui["Security Settings"]
  node_settings["Settings Access<br/>[Settings.java]"]
  node_main["Main App<br/>[MainActivity.java]"]
  node_su_helper["su Installation Check<br/>[SuHelper.java]"]
end

node_requester(("Root-Requesting App"))
node_android(("Android System"))

node_requester -.->|"invokes"| node_su_cli
node_su_cli -.->|"sends request"| node_daemon
node_daemon -.->|"checks policy"| node_native_db
node_daemon -.->|"requests decision"| node_app_request
node_request_entry -->|"delegates to"| node_app_request
node_app_request -->|"uses"| node_pin
node_app_request -->|"reads policy"| node_policy_store
node_policy_ui -->|"manages"| node_policy_store
node_policy_ui -->|"opens history"| node_log_ui
node_log_ui -->|"reads and deletes"| node_audit_store
node_log_ui -->|"loads policy"| node_policy_store
node_policy_store -->|"loads and saves"| node_policy_model
node_audit_store -->|"loads and records"| node_log_model
node_settings_ui -->|"updates"| node_settings
node_main -->|"reads settings"| node_settings
node_main -->|"checks su"| node_su_helper
node_main -->|"shows"| node_policy_ui
node_main -->|"shows"| node_settings_ui
node_android -.->|"launches"| node_app_request

click node_su_cli "https://github.com/koush/superuser/blob/master/Superuser/jni/su/su.c"
click node_daemon "https://github.com/koush/superuser/blob/master/Superuser/jni/su/daemon.c"
click node_native_db "https://github.com/koush/superuser/blob/master/Superuser/jni/su/db.c"
click node_app_request "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java"
click node_request_entry "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/RequestActivity.java"
click node_pin "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/PinViewHelper.java"
click node_policy_ui "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/PolicyFragment.java"
click node_log_ui "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/LogFragment.java"
click node_policy_store "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java"
click node_audit_store "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/SuperuserDatabaseHelper.java"
click node_policy_model "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/UidPolicy.java"
click node_log_model "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/LogEntry.java"
click node_settings_ui "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/SettingsFragment.java"
click node_settings "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/util/Settings.java"
click node_main "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/MainActivity.java"
click node_su_helper "https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/util/SuHelper.java"

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_su_cli,node_daemon,node_native_db toneBlue
class node_app_request,node_request_entry,node_pin toneAmber
class node_policy_ui,node_log_ui,node_policy_store,node_audit_store,node_policy_model,node_log_model,node_requester toneMint
class node_settings_ui,node_settings,node_main,node_su_helper toneRose
class node_android toneIndigo
```

## Components

### Native Root Access

- [su Command](https://github.com/koush/superuser/blob/master/Superuser/jni/su/su.c): `Superuser/jni/su/su.c`
- [su Daemon](https://github.com/koush/superuser/blob/master/Superuser/jni/su/daemon.c): `Superuser/jni/su/daemon.c`
- [Native Policy Lookup](https://github.com/koush/superuser/blob/master/Superuser/jni/su/db.c): `Superuser/jni/su/db.c`

### Request Approval

- [Request Prompt](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java): `Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java`
- [Request Entry](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/RequestActivity.java): `Superuser/src/com/koushikdutta/superuser/RequestActivity.java`
- [PIN Entry](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/PinViewHelper.java): `Superuser/src/com/koushikdutta/superuser/PinViewHelper.java`

### Policy and History

- [Policy Management](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/PolicyFragment.java): `Superuser/src/com/koushikdutta/superuser/PolicyFragment.java`
- [Access History](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/LogFragment.java): `Superuser/src/com/koushikdutta/superuser/LogFragment.java`
- [UID Policy Store](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java): `Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java`
- [Access Log Store](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/SuperuserDatabaseHelper.java): `Superuser/src/com/koushikdutta/superuser/db/SuperuserDatabaseHelper.java`
- [Policy Model](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/UidPolicy.java): `Superuser/src/com/koushikdutta/superuser/db/UidPolicy.java`
- [Log Record](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/db/LogEntry.java): `Superuser/src/com/koushikdutta/superuser/db/LogEntry.java`

### App Operations

- [Security Settings](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/SettingsFragment.java): `Superuser/src/com/koushikdutta/superuser/SettingsFragment.java`
- [Settings Access](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/util/Settings.java): `Superuser/src/com/koushikdutta/superuser/util/Settings.java`
- [Main App](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/MainActivity.java): `Superuser/src/com/koushikdutta/superuser/MainActivity.java`
- [su Installation Check](https://github.com/koush/superuser/blob/master/Superuser/src/com/koushikdutta/superuser/util/SuHelper.java): `Superuser/src/com/koushikdutta/superuser/util/SuHelper.java`

### Other components

- **Root-Requesting App**
- **Android System**

## Connections

- Root-Requesting App → su Command: invokes
- su Command → su Daemon: sends request
- su Daemon → Native Policy Lookup: checks policy
- su Daemon → Request Prompt: requests decision
- Request Entry → Request Prompt: delegates to (evidence: `Superuser/src/com/koushikdutta/superuser/RequestActivity.java`)
- Request Prompt → PIN Entry: uses (evidence: `Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java`)
- Request Prompt → UID Policy Store: reads policy (evidence: `Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java`)
- Policy Management → UID Policy Store: manages (evidence: `Superuser/src/com/koushikdutta/superuser/PolicyFragment.java`)
- Policy Management → Access History: opens history (evidence: `Superuser/src/com/koushikdutta/superuser/PolicyFragment.java`)
- Access History → Access Log Store: reads and deletes (evidence: `Superuser/src/com/koushikdutta/superuser/LogFragment.java`)
- Access History → UID Policy Store: loads policy (evidence: `Superuser/src/com/koushikdutta/superuser/LogFragment.java`)
- UID Policy Store → Policy Model: loads and saves (evidence: `Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java`)
- Access Log Store → Log Record: loads and records (evidence: `Superuser/src/com/koushikdutta/superuser/db/SuperuserDatabaseHelper.java`)
- Security Settings → Settings Access: updates (evidence: `Superuser/src/com/koushikdutta/superuser/SettingsFragment.java`)
- Main App → Settings Access: reads settings (evidence: `Superuser/src/com/koushikdutta/superuser/MainActivity.java`)
- Main App → su Installation Check: checks su (evidence: `Superuser/src/com/koushikdutta/superuser/MainActivity.java`)
- Main App → Policy Management: shows (evidence: `Superuser/src/com/koushikdutta/superuser/MainActivity.java`)
- Main App → Security Settings: shows (evidence: `Superuser/src/com/koushikdutta/superuser/MainActivity.java`)
- Android System → Request Prompt: launches
