101 lines
3.7 KiB
C
101 lines
3.7 KiB
C
/*
|
|
* 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.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
|
|
#define APPLOADER_PORT "com.android.trusty.apploader"
|
|
|
|
enum apploader_command : uint32_t {
|
|
APPLOADER_REQ_SHIFT = 1,
|
|
APPLOADER_RESP_BIT = 1,
|
|
|
|
APPLOADER_CMD_LOAD_APPLICATION = (0 << APPLOADER_REQ_SHIFT),
|
|
APPLOADER_CMD_GET_VERSION = (1 << APPLOADER_REQ_SHIFT),
|
|
APPLOADER_CMD_UNLOAD_APPLICATION = (2 << APPLOADER_REQ_SHIFT),
|
|
};
|
|
|
|
/**
|
|
* enum apploader_error - error codes for apploader
|
|
* @APPLOADER_NO_ERROR: no error
|
|
* @APPLOADER_ERR_UNKNOWN_CMD: unknown or not implemented command
|
|
* @APPLOADER_ERR_INVALID_CMD: invalid arguments or inputs passed to
|
|
* command
|
|
* @APPLOADER_ERR_NO_MEMORY: failed to allocate memory
|
|
* @APPLOADER_ERR_VERIFICATION_FAILED: failed to verify input application
|
|
* package for any reason, e.g., signature
|
|
* verification failed
|
|
* @APPLOADER_ERR_LOADING_FAILED: Trusty kernel or apploader service
|
|
* failed to load application
|
|
* @APPLOADER_ERR_ALREADY_EXISTS: application has already been loaded
|
|
* @APPLOADER_ERR_INTERNAL: miscellaneous or internal apploader
|
|
* error not covered by the above
|
|
* @APPLOADER_ERR_INVALID_VERSION: invalid application version
|
|
* @APPLOADER_ERR_POLICY_VIOLATION: signature verification succeeded but
|
|
* key+manifest combination not allowed
|
|
* by app loader policy engine
|
|
* @APPLOADER_ERR_NOT_ENCRYPTED: unmet application encryption requirement
|
|
*/
|
|
enum apploader_error : uint32_t {
|
|
APPLOADER_NO_ERROR = 0,
|
|
APPLOADER_ERR_UNKNOWN_CMD,
|
|
APPLOADER_ERR_INVALID_CMD,
|
|
APPLOADER_ERR_NO_MEMORY,
|
|
APPLOADER_ERR_VERIFICATION_FAILED,
|
|
APPLOADER_ERR_LOADING_FAILED,
|
|
APPLOADER_ERR_ALREADY_EXISTS,
|
|
APPLOADER_ERR_INTERNAL,
|
|
APPLOADER_ERR_INVALID_VERSION,
|
|
APPLOADER_ERR_POLICY_VIOLATION,
|
|
APPLOADER_ERR_NOT_ENCRYPTED,
|
|
};
|
|
|
|
/**
|
|
* apploader_header - Serial header for communicating with apploader
|
|
* @cmd: the command; one of &enum apploader_command values.
|
|
*/
|
|
struct apploader_header {
|
|
uint32_t cmd;
|
|
} __packed;
|
|
|
|
/**
|
|
* apploader_load_app_req - Serial arguments for LOAD_APPLICATION command
|
|
* @package_size: size of the application package.
|
|
*
|
|
* Load an application from a given memory region. The request message also
|
|
* contains a handle for a memfd that contains the application package.
|
|
*
|
|
* The response is a &struct apploader_resp with the error code or
|
|
* %APPLOADER_NO_ERROR on success.
|
|
*/
|
|
struct apploader_load_app_req {
|
|
uint64_t package_size;
|
|
} __packed;
|
|
|
|
/**
|
|
* apploader_resp - Common header for all apploader responses
|
|
* @hdr - header with command value.
|
|
* @error - error code returned by peer; one of &enum apploader_error values.
|
|
*
|
|
* This structure is followed by the response-specific payload, if the command
|
|
* has one.
|
|
*/
|
|
struct apploader_resp {
|
|
struct apploader_header hdr;
|
|
uint32_t error;
|
|
} __packed;
|