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

Commit cccd1144 authored by Weston Carvalho's avatar Weston Carvalho
Browse files

Clarify `IStorageSession`'s `WOULD_BLOCK` behavior 

Add an explanation to `IStorageSession`'s doc comment of how the
interface uses `WOULD_BLOCK` error returns.

Test: none
Bug: 278779487
Change-Id: Ib2fa6e5bdf594f62370f2eb8852cf76f1d0c7dde
parent edf61331

staging/security/see/storage/aidl/android/hardware/security/see/storage/ISecureStorage.aidl

+7 −0
Original line number Original line Diff line number Diff line
@@ -34,6 +34,13 @@ interface ISecureStorage { 
    /**

    /**

     * Starts a storage session for a filesystem.

     * Starts a storage session for a filesystem.

     *

     *

     * Clients should be prepared for `startSession` and any methods called on the `IStorageSession`

     * or its sub-interfaces to return `WOULD_BLOCK` (a `binder::Status` with an exception code of

     * `EX_TRANSACTION_FAILED` and a transaction error code of `android::WOULD_BLOCK`), which

     * indicates that the requested storage is not currently available. Possible cases that might

     * cause this return code might be accessing the data partition during boot stages where it

     * isn't yet mounted or attempting to commit changes while an A/B update is in progress.

     *

     * @filesystem:

     * @filesystem:

     *     The minimum filesystem properties requested.

     *     The minimum filesystem properties requested.

     *

     *