/*
 * Copyright © 2017-2024 Apple Inc. All rights reserved.
 *
 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 *
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. The rights granted to you under the License
 * may not be used to create, or enable the creation or redistribution of,
 * unlawful or unlicensed copies of an Apple operating system, or to
 * circumvent, violate, or enable the circumvention or violation of, any
 * terms of an Apple operating system software license agreement.
 *
 * Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this file.
 *
 * The Original Code and all software distributed under the License are
 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 *
 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
 */
/*!
 * @header
 * Second-generation virtualized Application Processor and associated handles.
 */
#ifndef __IMAGE4_API_COPROCESSOR_VMA2_H
#define __IMAGE4_API_COPROCESSOR_VMA2_H

#include <image4/image4.h>
#include <image4/types.h>

__BEGIN_DECLS
OS_ASSUME_NONNULL_BEGIN
OS_ASSUME_PTR_ABI_SINGLE_BEGIN

/*!
 * @const IMAGE4_COPROCESSOR_VMA2
 * The second-generation virtualized Application Processor executing payloads
 * signed by the Secure Boot Extra Content CA.
 *
 * Handles for this environment are enumerated in the
 * {@link image4_coprocessor_handle_vma2_t} type.
 *
 * @discussion
 * Unlike {@link IMAGE4_COPROCESSOR_AP}, the default handle for this coprocessor
 * will not consult the host's secure boot level since virtualized APs do not
 * have a specific reduced or permissive security policy. They simply use the
 * same policy as physical SoCs.
 *
 * @availability
 * This coprocessor is available starting in API version 20240318.
 */
IMAGE4_API_AVAILABLE_SPRING_2024
OS_EXPORT
const image4_coprocessor_t _image4_coprocessor_vma2;
#define IMAGE4_COPROCESSOR_VMA2 (&_image4_coprocessor_vma2)
IMAGE4_XNU_AVAILABLE_INDIRECT(_image4_coprocessor_vma2);

/*!
 * @typedef image4_coprocessor_handle_x86_t
 * Handles describing supported second-generation virtualized AP execution
 * environments.
 *
 * @const IMAGE4_COPROCESSOR_HANDLE_VMA2
 * The personalized VMA2 environment.
 *
 * @const IMAGE4_COPROCESSOR_HANDLE_VMA2_PDI
 * The sideloading environment used to load a personalized disk image.
 *
 * This handle is available starting in API version 20240406.
 *
 * @const IMAGE4_COPROCESSOR_HANDLE_VMA2_DDI
 * The sideloading environment used to load a personalized disk image which
 * is automatically mounted at boot.
 *
 * This handle is available starting in API version 20240406.
 */
OS_CLOSED_ENUM(image4_coprocessor_handle_vma2, image4_coprocessor_handle_t,
	IMAGE4_COPROCESSOR_HANDLE_VMA2 = 0,
	IMAGE4_COPROCESSOR_HANDLE_VMA2_PDI,
	IMAGE4_COPROCESSOR_HANDLE_VMA2_DDI,
	_IMAGE4_COPROCESSOR_HANDLE_VMA2_CNT,
);

OS_ASSUME_PTR_ABI_SINGLE_END
OS_ASSUME_NONNULL_END
__END_DECLS

#endif // __IMAGE4_API_COPROCESSOR_VMA2_H