80 lines
2.5 KiB
C++
80 lines
2.5 KiB
C++
/*
|
|
* Copyright 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 <memory>
|
|
|
|
#include <keymaster/android_keymaster_messages.h>
|
|
#include <keymaster/serializable.h>
|
|
|
|
namespace keymaster {
|
|
|
|
/**
|
|
* keymaster_message - Serial header for communicating with KM server
|
|
* @cmd: the command, one of AndroidKeymasterCommand.
|
|
* @payload: start of the serialized command specific payload
|
|
*/
|
|
struct keymaster_message {
|
|
AndroidKeymasterCommand cmd : 31;
|
|
bool is_response : 1;
|
|
std::uint32_t payload_size;
|
|
std::uint8_t payload[0];
|
|
};
|
|
|
|
} // namespace keymaster
|
|
|
|
namespace cuttlefish {
|
|
|
|
using keymaster::AndroidKeymasterCommand;
|
|
using keymaster::keymaster_message;
|
|
|
|
/**
|
|
* A destroyer for keymaster_message instances created with
|
|
* CreateKeymasterMessage. Wipes memory from the keymaster_message instances.
|
|
*/
|
|
class KeymasterCommandDestroyer {
|
|
public:
|
|
void operator()(keymaster_message* ptr);
|
|
};
|
|
|
|
/** An owning pointer for a keymaster_message instance. */
|
|
using ManagedKeymasterMessage =
|
|
std::unique_ptr<keymaster_message, KeymasterCommandDestroyer>;
|
|
|
|
/**
|
|
* Allocates memory for a keymaster_message carrying a message of size
|
|
* `payload_size`.
|
|
*/
|
|
ManagedKeymasterMessage CreateKeymasterMessage(AndroidKeymasterCommand command,
|
|
bool is_response,
|
|
std::size_t payload_size);
|
|
|
|
/*
|
|
* Interface for communication channels that synchronously communicate Keymaster
|
|
* IPC/RPC calls. Sends messages over a file descriptor.
|
|
*/
|
|
class KeymasterChannel {
|
|
public:
|
|
virtual bool SendRequest(AndroidKeymasterCommand command,
|
|
const keymaster::Serializable& message) = 0;
|
|
virtual bool SendResponse(AndroidKeymasterCommand command,
|
|
const keymaster::Serializable& message) = 0;
|
|
virtual ManagedKeymasterMessage ReceiveMessage() = 0;
|
|
virtual ~KeymasterChannel() {}
|
|
};
|
|
|
|
} // namespace cuttlefish
|