components/service/attestation/provider/attest_provider.h

/*
 * Copyright (c) 2021, Arm Limited and Contributors. All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

#ifndef ATTEST_PROVIDER_H
#define ATTEST_PROVIDER_H

#include <rpc/common/endpoint/rpc_interface.h>
#include <rpc_caller.h>
#include <service/common/provider/service_provider.h>
#include <service/attestation/provider/serializer/attest_provider_serializer.h>
#include <service/attestation/key_mngr/attest_key_mngr.h>
#include <protocols/rpc/common/packed-c/encoding.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * The attest_provider is a service provider that implements an RPC interface
 * for an instance of the attestation service.
 */
struct attest_provider
{
    struct service_provider base_provider;
    const struct attest_provider_serializer *serializers[TS_RPC_ENCODING_LIMIT];
};

/**
 * \brief Initialize an instance of the service provider
 *
 * Initializes a an attestation service provider.  Returns an rpc_interface
 * that should be associated with a suitable rpc endpoint.
 *
 * \param[in] context   The instance to initialize
 *
 * \return An rpc_interface or NULL on failure
 */
struct rpc_interface *attest_provider_init(struct attest_provider *context);

/**
 * \brief Cleans up when the instance is no longer needed
 *
 * \param[in] context   The instance to de-initialize
 */
void attest_provider_deinit(struct attest_provider *context);

/**
 * \brief Register a protocol serializer
 *
 * \param[in] context     The instance
 * \param[in] encoding    Serialization encoding e.g. packed-c
 * \param[in] serializer  A concrete serializer
 */
void attest_provider_register_serializer(struct attest_provider *context,
    unsigned int encoding, const struct attest_provider_serializer *serializer);

#ifdef __cplusplus
} /* extern "C" */
#endif

#endif /* ATTEST_PROVIDER_H */