1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
/*
* Copyright (C) 2020 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.os;
import android.os.IUpdateEngineStableCallback;
import android.os.ParcelFileDescriptor;
/**
* The stable interface exposed by the update engine daemon.
*/
interface IUpdateEngineStable {
/**
* Apply the given payload as provided in the given file descriptor.
*
* See {@link #bind(IUpdateEngineCallback)} for status updates.
*
* @param pfd The file descriptor opened at the payload file. Note that the daemon must have
* enough permission to operate on the file descriptor.
* @param payload_offset offset into pfd where the payload binary starts.
* @param payload_size length after payload_offset to read from pfd. If 0, it will be auto
* detected.
* @param headerKeyValuePairs additional header key value pairs, in the format of "key=value".
* @see android.os.UpdateEngine#applyPayload(android.content.res.AssetFileDescriptor, String[])
*/
void applyPayloadFd(in ParcelFileDescriptor pfd,
in long payload_offset,
in long payload_size,
in String[] headerKeyValuePairs);
/**
* Bind a callback for status updates on payload application.
*
* At any given time, only one callback can be bound. If a callback is already bound,
* subsequent binding will fail and return false until the bound callback is unbound. That is,
* binding is first-come, first-serve.
*
* A bound callback may be unbound explicitly by calling
* {@link #unbind(IUpdateEngineStableCallback)}, or
* implicitly when the process implementing the callback dies.
*
* @param callback See {@link IUpdateEngineStableCallback}
* @return true if binding is successful, false otherwise.
* @see android.os.UpdateEngine#bind(android.os.UpdateEngineCallback)
*/
boolean bind(IUpdateEngineStableCallback callback);
/**
* Unbind a possibly bound callback.
*
* If the provided callback does not match the previously bound callback, unbinding fails.
*
* Note that a callback may also be unbound when the process implementing the callback dies.
* Hence, a client usually does not need to explicitly unbind a callback unless it wants to change
* the bound callback.
*
* @param callback The callback to be unbound. See {@link IUpdateEngineStableCallback}.
* @return true if unbinding is successful, false otherwise.
* @see android.os.UpdateEngine#unbind(android.os.UpdateEngineCallback)
*/
boolean unbind(IUpdateEngineStableCallback callback);
}
|
