STRUCT BINDER_PROC(9)

💖 NAME 💖

struct binder_proc — binder process bookkeeping 💖

Hey bestie, welcome to the struct binder_proc(9) page from the Kernel API Manual ✨ This is the bookkeeping struct for binder processes, and it's honestly giving the main-character planner of the whole operation 📒💅

---

✨ SYNOPSIS ✨

Here's the exact struct, bestie — every field in its assigned little seat 🪑✨:

struct binder_proc {
    struct hlist_node proc_node;
    struct rb_root threads;
    struct rb_root nodes;
    struct rb_root refs_by_desc;
    struct rb_root refs_by_node;
    struct list_head waiting_threads;
    int pid;
    struct task_struct *tsk;
    const struct cred *cred;
    struct hlist_node deferred_work_node;
    int deferred_work;
    int outstanding_txns;
    bool is_dead;
    bool is_frozen;
    bool sync_recv;
    bool async_recv;
    wait_queue_head_t freeze_wait;
    struct dbitmap dmap;
    struct list_head todo;
    struct binder_stats stats;
    struct list_head delivered_death;
    struct list_head delivered_freeze;
    u32 max_threads;
    int requested_threads;
    int requested_threads_started;
    int tmp_ref;
    long default_priority;
    struct dentry *debugfs_entry;
    struct binder_alloc alloc;
    struct binder_context *context;
    spinlock_t inner_lock;
    spinlock_t outer_lock;
    struct dentry *binderfs_entry;
    bool oneway_spam_detection_enabled;
};

---

🧚 Members 🧚

Okay, member-by-member tea time ☕ — all the lock notes are staying, no cap:

• proc_node — the element for the binder_procs list 🔗
• threads — an rbtree of binder_threads in this proc (protected by inner_lock) 🌳
• nodes — an rbtree of binder nodes associated with this proc, ordered by node->ptr (protected by inner_lock) 🧭
• refs_by_desc — an rbtree of refs ordered by ref->desc (protected by outer_lock) 📇
• refs_by_node — an rbtree of refs ordered by ref->node (protected by outer_lock) 🗂️
• waiting_threads — threads currently waiting for proc work (protected by inner_lock) ⏳
• pid — PID of group_leader of process (invariant after initialized) 🆔
• tsk — task_struct for group_leader of process (invariant after initialized) 🧵
• cred — struct cred associated with the struct file in binder_open (invariant after initialized) 🪪
• deferred_work_node — element for binder_deferred_list (protected by binder_deferred_lock) 📋
• deferred_work — bitmap of deferred work to perform (protected by binder_deferred_lock) 🗒️
• outstanding_txns — number of transactions to be transmitted before processes in freeze_wait are woken up (protected by inner_lock) 🔁
• is_dead — process is dead and awaiting free when outstanding transactions are cleaned up (protected by inner_lock) 💀
• is_frozen — process is frozen and unable to service binder transactions (protected by inner_lock) 🧊
• sync_recv — process received sync transactions since last frozen; bit 0: received sync transaction after being frozen; bit 1: new pending sync transaction during freezing (protected by inner_lock) 📥
• async_recv — process received async transactions since last frozen (protected by inner_lock) 📨
• freeze_wait — waitqueue of processes waiting for all outstanding transactions to be processed (protected by inner_lock) 🕰️
• dmap — dbitmap to manage available reference descriptors (protected by outer_lock) 🗺️
• todo — list of work for this process (protected by inner_lock) ✅
• stats — per-process binder statistics (atomics, no lock needed) 📊
• delivered_death — list of delivered death notification (protected by inner_lock) 🪦
• delivered_freeze — list of delivered freeze notification (protected by inner_lock) ❄️
• max_threads — cap on number of binder threads (protected by inner_lock) 🚦
• requested_threads — number of binder threads requested but not yet started; in current implementation, can only be 0 or 1 (protected by inner_lock) 🙋‍♀️
• requested_threads_started — number binder threads started (protected by inner_lock) 🏁
• tmp_ref — temporary reference to indicate proc is in use (protected by inner_lock) 📌
• default_priority — default scheduler priority (invariant after initialized) 🎚️
• debugfs_entry — debugfs node 🐞
• alloc — binder allocator bookkeeping 🧮
• context — binder_context for this proc (invariant after initialized) 🧠
• inner_lock — can nest under outer_lock and/or node lock 🔒
• outer_lock — no nesting under innor or node lock; Lock order: 1) outer, 2) node, 3) inner 🚨
• binderfs_entry — process-specific binderfs log file 📝
• oneway_spam_detection_enabled — process enabled oneway spam detection or not 🚫

---

💫 Description 💫

Bookkeeping structure for binder processes — literally that, bestie. It's the planner, the ledger, the whole binder-process vibe in one struct 📚💅

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/android/binder_internal.h — plus the whole squad of structs:

• struct binder_device(9)
• struct binder_work(9)
• struct binder_node(9)
• struct binder_ref_data(9)
• struct binder_ref(9)
• struct binder_thread(9)
• struct binder_txn_fd_fixup(9)
• struct binder_object(9)

---

That's the page, bestie 💖 Source/version: ./drivers/android · date: October 2026 · page: struct binder_proc(9) — slay and goodbye 🎀💅