194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood/* Copyright 2008 The Android Open Source Project 294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood */ 394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood#ifndef _BINDER_H_ 594afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood#define _BINDER_H_ 694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 794afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood#include <sys/ioctl.h> 894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood#include <linux/binder.h> 994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 1094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodstruct binder_state; 1194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 1294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodstruct binder_io 1394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood{ 1494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood char *data; /* pointer to read/write from */ 15399b6c3bbc0d887ab016a8bb686ff16d36edc6c8Arve Hjønnevåg binder_size_t *offs; /* array of offsets */ 169b738bb4110926b85da65d36b2e6f1a50199ec4cSerban Constantinescu size_t data_avail; /* bytes available in data buffer */ 179b738bb4110926b85da65d36b2e6f1a50199ec4cSerban Constantinescu size_t offs_avail; /* entries available in offsets array */ 1894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 1994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood char *data0; /* start of data buffer */ 20399b6c3bbc0d887ab016a8bb686ff16d36edc6c8Arve Hjønnevåg binder_size_t *offs0; /* start of offsets buffer */ 2194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood uint32_t flags; 2294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood uint32_t unused; 2394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood}; 2494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 2594afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodstruct binder_death { 2694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood void (*func)(struct binder_state *bs, void *ptr); 2794afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood void *ptr; 289b738bb4110926b85da65d36b2e6f1a50199ec4cSerban Constantinescu}; 2994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 305fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescu/* the one magic handle */ 315fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescu#define BINDER_SERVICE_MANAGER 0U 3294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 3394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood#define SVC_MGR_NAME "android.os.IServiceManager" 3494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 3594afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodenum { 36e5245cbf5d4e830cf605ef07f5d284d7c5d2867eArve Hjønnevåg /* Must match definitions in IBinder.h and IServiceManager.h */ 37e5245cbf5d4e830cf605ef07f5d284d7c5d2867eArve Hjønnevåg PING_TRANSACTION = B_PACK_CHARS('_','P','N','G'), 3894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood SVC_MGR_GET_SERVICE = 1, 3994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood SVC_MGR_CHECK_SERVICE, 4094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood SVC_MGR_ADD_SERVICE, 4194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood SVC_MGR_LIST_SERVICES, 4294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood}; 4394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 4494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodtypedef int (*binder_handler)(struct binder_state *bs, 45bcf38880c65297da58194eb0c0ce8d6e2bab7d94Serban Constantinescu struct binder_transaction_data *txn, 4694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood struct binder_io *msg, 4794afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood struct binder_io *reply); 4894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 499b738bb4110926b85da65d36b2e6f1a50199ec4cSerban Constantinescustruct binder_state *binder_open(size_t mapsize); 5094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid binder_close(struct binder_state *bs); 5194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 5294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood/* initiate a blocking binder call 5394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood * - returns zero on success 5494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood */ 5594afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodint binder_call(struct binder_state *bs, 5694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood struct binder_io *msg, struct binder_io *reply, 575fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescu uint32_t target, uint32_t code); 5894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 5994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood/* release any state associate with the binder_io 6094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood * - call once any necessary data has been extracted from the 6194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood * binder_io after binder_call() returns 6294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood * - can safely be called even if binder_call() fails 6394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood */ 6494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid binder_done(struct binder_state *bs, 6594afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood struct binder_io *msg, struct binder_io *reply); 6694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 6794afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood/* manipulate strong references */ 685fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescuvoid binder_acquire(struct binder_state *bs, uint32_t target); 695fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescuvoid binder_release(struct binder_state *bs, uint32_t target); 7094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 715fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescuvoid binder_link_to_death(struct binder_state *bs, uint32_t target, struct binder_death *death); 7294afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 7394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid binder_loop(struct binder_state *bs, binder_handler func); 7494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 7594afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodint binder_become_context_manager(struct binder_state *bs); 7694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 7794afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood/* allocate a binder_io, providing a stack-allocated working 7894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood * buffer, size of the working buffer, and how many object 7994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood * offset entries to reserve from the buffer 8094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood */ 8194afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid bio_init(struct binder_io *bio, void *data, 829b738bb4110926b85da65d36b2e6f1a50199ec4cSerban Constantinescu size_t maxdata, size_t maxobjects); 8394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 8494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid bio_put_obj(struct binder_io *bio, void *ptr); 855fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescuvoid bio_put_ref(struct binder_io *bio, uint32_t handle); 8694afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid bio_put_uint32(struct binder_io *bio, uint32_t n); 8794afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid bio_put_string16(struct binder_io *bio, const uint16_t *str); 8894afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwoodvoid bio_put_string16_x(struct binder_io *bio, const char *_str); 8994afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 9094afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwooduint32_t bio_get_uint32(struct binder_io *bio); 919b738bb4110926b85da65d36b2e6f1a50199ec4cSerban Constantinescuuint16_t *bio_get_string16(struct binder_io *bio, size_t *sz); 925fb1b8836aa5cf0f38b49bc7bfb8343b84fdf9bfSerban Constantinescuuint32_t bio_get_ref(struct binder_io *bio); 9394afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood 9494afecf4b6f437b3ee9a076242402e421c6c07a6Mike Lockwood#endif 95