# koush/android_packages_apps_superuser architecture

> Architecture diagram of the GitHub repository koush/android_packages_apps_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/android_packages_apps_superuser
- Repository: https://github.com/koush/android_packages_apps_superuser

## Overview

This Android Superuser application mediates requests to run commands under another UID/GID. The runtime captures the requester and target, checks remembered permissions, and—when a decision is interactive—launches a confirmation activity and receives its response over a local socket. The app also lists and removes remembered permissions. The excerpts show these UI and storage responsibilities, but do not show the native call site that dispatches the activity; that connection is therefore marked unverified.

Main entry points: [`su.c`](https://github.com/koush/android_packages_apps_superuser/blob/donut/su.c) (su request handling), [`src/org/zenthought/android/su/SuRequest.java`](https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/SuRequest.java) (Request confirmation), [`activity.cpp`](https://github.com/koush/android_packages_apps_superuser/blob/donut/activity.cpp) (Request activity dispatch), [`src/org/zenthought/android/su/Su.java`](https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/Su.java) (Permission list and removal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_native["Privilege runtime"]
  node_su_runtime["su request handling<br/>[su.c]"]
  node_permission_store[("Native permission database<br/>[su.c]")]
  node_activity_dispatch["Request activity dispatch<br/>[activity.cpp]"]
end

subgraph group_requestui["Authorization UI"]
  node_request_activity["Request confirmation<br/>[SuRequest.java]"]
end

subgraph group_management["Permission management"]
  node_java_permission_store[("App permission database<br/>[Su.java]")]
  node_permission_list["Permission list and removal<br/>[Su.java]"]
end

node_requester(("Requesting process"))
node_user(("Device user"))

node_requester -->|"requests privilege"| node_su_runtime
node_su_runtime -->|"checks and updates"| node_permission_store
node_su_runtime -.->|"dispatches interactive request"| node_activity_dispatch
node_activity_dispatch -->|"starts with request details"| node_request_activity
node_request_activity -->|"sends decision by socket"| node_su_runtime
node_user -->|"chooses allow or deny"| node_request_activity
node_user -->|"manages permissions"| node_permission_list
node_permission_list -->|"queries and deletes"| node_java_permission_store

click node_su_runtime "https://github.com/koush/android_packages_apps_superuser/blob/donut/su.c"
click node_permission_store "https://github.com/koush/android_packages_apps_superuser/blob/donut/su.c"
click node_activity_dispatch "https://github.com/koush/android_packages_apps_superuser/blob/donut/activity.cpp"
click node_request_activity "https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/SuRequest.java"
click node_java_permission_store "https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/Su.java"
click node_permission_list "https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/Su.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_runtime,node_permission_store,node_activity_dispatch,node_user toneBlue
class node_request_activity toneAmber
class node_java_permission_store,node_permission_list,node_requester toneMint
```

## Components

### Privilege runtime

- [su request handling](https://github.com/koush/android_packages_apps_superuser/blob/donut/su.c): `su.c`
- [Native permission database](https://github.com/koush/android_packages_apps_superuser/blob/donut/su.c): `su.c`
- [Request activity dispatch](https://github.com/koush/android_packages_apps_superuser/blob/donut/activity.cpp): `activity.cpp`

### Authorization UI

- [Request confirmation](https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/SuRequest.java): `src/org/zenthought/android/su/SuRequest.java`

### Permission management

- [App permission database](https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/Su.java): `src/org/zenthought/android/su/Su.java`
- [Permission list and removal](https://github.com/koush/android_packages_apps_superuser/blob/donut/src/org/zenthought/android/su/Su.java): `src/org/zenthought/android/su/Su.java`

### Other components

- **Requesting process**
- **Device user**

## Connections

- Requesting process → su request handling: requests privilege (evidence: `su.c`)
- su request handling → Native permission database: checks and updates (evidence: `su.c`)
- su request handling → Request activity dispatch: dispatches interactive request
- Request activity dispatch → Request confirmation: starts with request details (evidence: `activity.cpp`)
- Request confirmation → su request handling: sends decision by socket (evidence: `src/org/zenthought/android/su/SuRequest.java`)
- Device user → Request confirmation: chooses allow or deny (evidence: `src/org/zenthought/android/su/SuRequest.java`)
- Device user → Permission list and removal: manages permissions (evidence: `src/org/zenthought/android/su/Su.java`)
- Permission list and removal → App permission database: queries and deletes (evidence: `src/org/zenthought/android/su/Su.java`)
