You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
76 lines
3.1 KiB
76 lines
3.1 KiB
/*
|
|
* 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);
|
|
}
|