Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 58311dcc authored by Steven Moreland's avatar Steven Moreland
Browse files

TransactionTooLargeException: doc clarification 

- buffer is in bytes, not bits (1MB vs 1Mb)
- this exception is actually a heuristic currently, pending b/28321379

Fixes: 149869862
Test: N/A
Change-Id: Id409a1ce7348666ec9ad6437acf67382be0a0a1f
parent e126101f

core/java/android/os/TransactionTooLargeException.java

+4 −2
Original line number Diff line number Diff line
@@ -23,9 +23,11 @@ import android.os.RemoteException; 
 * During a remote procedure call, the arguments and the return value of the call

 * are transferred as {@link Parcel} objects stored in the Binder transaction buffer.

 * If the arguments or the return value are too large to fit in the transaction buffer,

 * then the call will fail and {@link TransactionTooLargeException} will be thrown.

 * then the call will fail.  {@link TransactionTooLargeException} is thrown as a

 * heuristic when a transaction is large, and it fails, since these are the transactions

 * which are most likely to overfill the transaction buffer.

 * </p><p>

 * The Binder transaction buffer has a limited fixed size, currently 1Mb, which

 * The Binder transaction buffer has a limited fixed size, currently 1MB, which

 * is shared by all transactions in progress for the process.  Consequently this

 * exception can be thrown when there are many transactions in progress even when

 * most of the individual transactions are of moderate size.