binder

func APILevelFromBinder ¶ added in v0.0.8

func APILevelFromBinder(b IBinder) int

APILevelFromBinder returns the Android API level from the transport backing the given IBinder. Returns 0 if the transport does not support API level detection (e.g., raw kernel binder without version-aware wrapping).

func MatchParamsToSignature ¶ added in v0.0.8

func MatchParamsToSignature(
	compiledDescs []string,
	deviceSig []string,
) []int

MatchParamsToSignature determines which compiled parameters to write and in what order, given the device's expected method signature.

compiledDescs is the DEX type descriptor for each compiled parameter (in the order the proxy method declares them). deviceSig is the device's expected parameter type descriptors.

Returns a slice of compiled parameter indices in device order. Each element is an index into compiledDescs. If a device-expected type has no match among compiled params, -1 is used (the caller should write a zero value or skip).

The matching is greedy left-to-right: for each device param type, the first unused compiled param with that type is selected. This handles the common case where params are added or removed between API levels but the relative order of shared types is preserved.

func ReadStatus ¶

func ReadStatus(p *parcel.Parcel) error

ReadStatus reads an AIDL Status from a reply parcel. Returns nil if the status indicates success (ExceptionNone). Returns a *aidlerrors.StatusError if an exception is present.

Android Java services may prepend reply parcels with "fat reply headers":

• EX_HAS_NOTED_APPOPS_REPLY_HEADER (-127): AppOps header, skip then read the real exception code.
• EX_HAS_REPLY_HEADER (-128): StrictMode header, skip then treat as success.

func ResolveMethodSignature ¶ added in v0.0.8

func ResolveMethodSignature(
	b IBinder,
	ctx context.Context,
	descriptor string,
	method string,
) []string

ResolveMethodSignature returns the device's parameter type descriptor list (DEX format) for the given method. Returns nil if the backing transport does not support signature resolution or the signature is unknown.

This is a convenience wrapper that extracts the VersionAwareTransport from the IBinder and delegates to its ResolveMethodSignature method.

func SignatureMatches ¶ added in v0.0.8

func SignatureMatches(
	compiledDescs []string,
	deviceSig []string,
) bool

SignatureMatches returns true if the compiled parameter descriptors match the device signature exactly (same length, same types in order). When true, the proxy can write all params normally without adaptation.

func WriteBinderToParcel ¶

func WriteBinderToParcel(
	ctx context.Context,
	p *parcel.Parcel,
	b IBinder,
	transport Transport,
)

WriteBinderToParcel writes an IBinder to a parcel, choosing the correct wire format based on whether the binder is a local stub or a remote proxy.

For remote proxies (ProxyBinder), it writes BINDER_TYPE_HANDLE with the handle. For local stubs (StubBinder), it auto-registers the stub with the transport (if not already registered) and writes BINDER_TYPE_BINDER with the cookie.

func WriteStatus ¶

func WriteStatus(
	p *parcel.Parcel,
	err error,
)

WriteStatus writes an AIDL Status to a parcel. If err is nil, writes ExceptionNone (success). If err is a *aidlerrors.StatusError, writes its contents. Otherwise, wraps the error as ExceptionIllegalState.