How koush/superuser works
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: MultitaskSuRequestActivity.java Request Prompt · MainActivity.java Main App · SuDatabaseHelper.java UID Policy Store · daemon.c su Daemon
Components 18
Native Root Access
- su Command
Superuser/jni/su/su.c - su Daemon
Superuser/jni/su/daemon.c - Native Policy Lookup
Superuser/jni/su/db.c
Request Approval
- Request Prompt
Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java - Request Entry
Superuser/src/com/koushikdutta/superuser/RequestActivity.java - PIN Entry
Superuser/src/com/koushikdutta/superuser/PinViewHelper.java
Policy and History
- Policy Management
Superuser/src/com/koushikdutta/superuser/PolicyFragment.java - Access History
Superuser/src/com/koushikdutta/superuser/LogFragment.java - UID Policy Store
Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java - Access Log Store
Superuser/src/com/koushikdutta/superuser/db/SuperuserDatabaseHelper.java - Policy Model
Superuser/src/com/koushikdutta/superuser/db/UidPolicy.java - Log Record
Superuser/src/com/koushikdutta/superuser/db/LogEntry.java
App Operations
- Security Settings
Superuser/src/com/koushikdutta/superuser/SettingsFragment.java - Settings Access
Superuser/src/com/koushikdutta/superuser/util/Settings.java - Main App
Superuser/src/com/koushikdutta/superuser/MainActivity.java - su Installation Check
Superuser/src/com/koushikdutta/superuser/util/SuHelper.java
Other components
- Root-Requesting App
- Android System
Connections 19
- 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
Superuser/src/com/koushikdutta/superuser/RequestActivity.java - Request Prompt → PIN Entry: uses
Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java - Request Prompt → UID Policy Store: reads policy
Superuser/src/com/koushikdutta/superuser/MultitaskSuRequestActivity.java - Policy Management → UID Policy Store: manages
Superuser/src/com/koushikdutta/superuser/PolicyFragment.java - Policy Management → Access History: opens history
Superuser/src/com/koushikdutta/superuser/PolicyFragment.java - Access History → Access Log Store: reads and deletes
Superuser/src/com/koushikdutta/superuser/LogFragment.java - Access History → UID Policy Store: loads policy
Superuser/src/com/koushikdutta/superuser/LogFragment.java - UID Policy Store → Policy Model: loads and saves
Superuser/src/com/koushikdutta/superuser/db/SuDatabaseHelper.java - Access Log Store → Log Record: loads and records
Superuser/src/com/koushikdutta/superuser/db/SuperuserDatabaseHelper.java - Security Settings → Settings Access: updates
Superuser/src/com/koushikdutta/superuser/SettingsFragment.java - Main App → Settings Access: reads settings
Superuser/src/com/koushikdutta/superuser/MainActivity.java - Main App → su Installation Check: checks su
Superuser/src/com/koushikdutta/superuser/MainActivity.java - Main App → Policy Management: shows
Superuser/src/com/koushikdutta/superuser/MainActivity.java - Main App → Security Settings: shows
Superuser/src/com/koushikdutta/superuser/MainActivity.java - Android System → Request Prompt: launches