--- /dev/null
+/*
+ * Copyright (C) 2020 Michael Brown <mbrown@fensystems.co.uk>.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation; either version 2 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+ * 02110-1301, USA.
+ *
+ * You can also choose to distribute this program under the terms of
+ * the Unmodified Binary Distribution Licence (as given in the file
+ * COPYING.UBDL), provided that you have satisfied its requirements.
+ */
+
+FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
+
+#include <string.h>
+#include <ipxe/efi/efi.h>
+#include <ipxe/efi/efi_null.h>
+
+/** @file
+ *
+ * EFI null interfaces
+ *
+ */
+
+/******************************************************************************
+ *
+ * Simple Network Protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_snp_start ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_stop ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_initialize ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ UINTN extra_rx_bufsize __unused,
+ UINTN extra_tx_bufsize __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_reset ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ BOOLEAN ext_verify __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_shutdown ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_receive_filters ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ UINT32 enable __unused,
+ UINT32 disable __unused,
+ BOOLEAN mcast_reset __unused,
+ UINTN mcast_count __unused,
+ EFI_MAC_ADDRESS *mcast __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_station_address ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ BOOLEAN reset __unused,
+ EFI_MAC_ADDRESS *new __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_statistics ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ BOOLEAN reset __unused, UINTN *stats_len __unused,
+ EFI_NETWORK_STATISTICS *stats __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_mcast_ip_to_mac ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ BOOLEAN ipv6 __unused,
+ EFI_IP_ADDRESS *ip __unused,
+ EFI_MAC_ADDRESS *mac __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_nvdata ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ BOOLEAN read __unused, UINTN offset __unused,
+ UINTN len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_get_status ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ UINT32 *interrupts __unused, VOID **txbuf __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_transmit ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ UINTN ll_header_len __unused, UINTN len __unused,
+ VOID *data __unused, EFI_MAC_ADDRESS *ll_src __unused,
+ EFI_MAC_ADDRESS *ll_dest __unused,
+ UINT16 *net_proto __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_snp_receive ( EFI_SIMPLE_NETWORK_PROTOCOL *snp __unused,
+ UINTN *ll_header_len __unused, UINTN *len __unused,
+ VOID *data __unused, EFI_MAC_ADDRESS *ll_src __unused,
+ EFI_MAC_ADDRESS *ll_dest __unused,
+ UINT16 *net_proto __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_SIMPLE_NETWORK_PROTOCOL efi_null_snp = {
+ .Revision = EFI_SIMPLE_NETWORK_PROTOCOL_REVISION,
+ .Start = efi_null_snp_start,
+ .Stop = efi_null_snp_stop,
+ .Initialize = efi_null_snp_initialize,
+ .Reset = efi_null_snp_reset,
+ .Shutdown = efi_null_snp_shutdown,
+ .ReceiveFilters = efi_null_snp_receive_filters,
+ .StationAddress = efi_null_snp_station_address,
+ .Statistics = efi_null_snp_statistics,
+ .MCastIpToMac = efi_null_snp_mcast_ip_to_mac,
+ .NvData = efi_null_snp_nvdata,
+ .GetStatus = efi_null_snp_get_status,
+ .Transmit = efi_null_snp_transmit,
+ .Receive = efi_null_snp_receive,
+};
+
+/**
+ * Nullify SNP interface
+ *
+ * @v snp SNP interface
+ */
+void efi_nullify_snp ( EFI_SIMPLE_NETWORK_PROTOCOL *snp ) {
+
+ memcpy ( snp, &efi_null_snp,
+ offsetof ( typeof ( *snp ), WaitForPacket ) );
+ snp->Mode->State = EfiSimpleNetworkStopped;
+}
+
+/******************************************************************************
+ *
+ * Network Interface Identification protocol
+ *
+ ******************************************************************************
+ */
+
+static EFIAPI VOID efi_null_undi_issue ( UINT64 cdb_phys ) {
+ PXE_CDB *cdb = ( ( void * ) ( intptr_t ) cdb_phys );
+
+ cdb->StatCode = PXE_STATCODE_UNSUPPORTED;
+ cdb->StatFlags = PXE_STATFLAGS_COMMAND_FAILED;
+}
+
+static PXE_SW_UNDI efi_null_undi __attribute__ (( aligned ( 16 ) )) = {
+ .Signature = PXE_ROMID_SIGNATURE,
+ .Len = sizeof ( efi_null_undi ),
+ .Rev = PXE_ROMID_REV,
+ .MajorVer = PXE_ROMID_MAJORVER,
+ .MinorVer = PXE_ROMID_MINORVER,
+ .Implementation = PXE_ROMID_IMP_SW_VIRT_ADDR,
+};
+
+/**
+ * Nullify NII interface
+ *
+ * @v nii NII interface
+ */
+void efi_nullify_nii ( EFI_NETWORK_INTERFACE_IDENTIFIER_PROTOCOL *nii ) {
+ efi_null_undi.EntryPoint = ( ( intptr_t ) efi_null_undi_issue );
+ nii->Id = ( ( intptr_t ) &efi_null_undi );
+}
+
+/******************************************************************************
+ *
+ * Component name protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_get_driver_name ( EFI_COMPONENT_NAME2_PROTOCOL *name2 __unused,
+ CHAR8 *language __unused,
+ CHAR16 **driver_name __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_get_controller_name ( EFI_COMPONENT_NAME2_PROTOCOL *name2 __unused,
+ EFI_HANDLE device __unused,
+ EFI_HANDLE child __unused,
+ CHAR8 *language __unused,
+ CHAR16 **controller_name __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_COMPONENT_NAME2_PROTOCOL efi_null_name2 = {
+ .GetDriverName = efi_null_get_driver_name,
+ .GetControllerName = efi_null_get_controller_name,
+ .SupportedLanguages = "",
+};
+
+/**
+ * Nullify Component Name Protocol interface
+ *
+ * @v name2 Component name protocol
+ */
+void efi_nullify_name2 ( EFI_COMPONENT_NAME2_PROTOCOL *name2 ) {
+
+ memcpy ( name2, &efi_null_name2, sizeof ( name2 ) );
+}
+
+/******************************************************************************
+ *
+ * Load file protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_load_file ( EFI_LOAD_FILE_PROTOCOL *load_file __unused,
+ EFI_DEVICE_PATH_PROTOCOL *path __unused,
+ BOOLEAN booting __unused, UINTN *len __unused,
+ VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+/**
+ * Nullify Load File Protocol interface
+ *
+ * @v load_file Load file protocol
+ */
+void efi_nullify_load_file ( EFI_LOAD_FILE_PROTOCOL *load_file ) {
+ load_file->LoadFile = efi_null_load_file;
+}
+
+/******************************************************************************
+ *
+ * HII configuration access protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_hii_extract ( const EFI_HII_CONFIG_ACCESS_PROTOCOL *hii __unused,
+ EFI_STRING request __unused,
+ EFI_STRING *progress __unused,
+ EFI_STRING *results __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_hii_route ( const EFI_HII_CONFIG_ACCESS_PROTOCOL *hii __unused,
+ EFI_STRING config __unused,
+ EFI_STRING *progress __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_hii_callback ( const EFI_HII_CONFIG_ACCESS_PROTOCOL *hii __unused,
+ EFI_BROWSER_ACTION action __unused,
+ EFI_QUESTION_ID question_id __unused,
+ UINT8 type __unused, EFI_IFR_TYPE_VALUE *value __unused,
+ EFI_BROWSER_ACTION_REQUEST *action_request __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_HII_CONFIG_ACCESS_PROTOCOL efi_null_hii = {
+ .ExtractConfig = efi_null_hii_extract,
+ .RouteConfig = efi_null_hii_route,
+ .Callback = efi_null_hii_callback,
+};
+
+/**
+ * Nullify HII configuration access protocol
+ *
+ * @v hii HII configuration access protocol
+ */
+void efi_nullify_hii ( EFI_HII_CONFIG_ACCESS_PROTOCOL *hii ) {
+
+ memcpy ( hii, &efi_null_hii, sizeof ( *hii ) );
+}
+
+/******************************************************************************
+ *
+ * Block I/O protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_block_reset ( EFI_BLOCK_IO_PROTOCOL *block __unused,
+ BOOLEAN verify __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_block_read ( EFI_BLOCK_IO_PROTOCOL *block __unused,
+ UINT32 media __unused, EFI_LBA lba __unused,
+ UINTN len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_block_write ( EFI_BLOCK_IO_PROTOCOL *block __unused,
+ UINT32 media __unused, EFI_LBA lba __unused,
+ UINTN len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_block_flush ( EFI_BLOCK_IO_PROTOCOL *block __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_BLOCK_IO_MEDIA efi_null_block_media;
+
+static EFI_BLOCK_IO_PROTOCOL efi_null_block = {
+ .Revision = EFI_BLOCK_IO_INTERFACE_REVISION,
+ .Media = &efi_null_block_media,
+ .Reset = efi_null_block_reset,
+ .ReadBlocks = efi_null_block_read,
+ .WriteBlocks = efi_null_block_write,
+ .FlushBlocks = efi_null_block_flush,
+};
+
+/**
+ * Nullify block I/O protocol
+ *
+ * @v block Block I/O protocol
+ */
+void efi_nullify_block ( EFI_BLOCK_IO_PROTOCOL *block ) {
+
+ memcpy ( block, &efi_null_block, sizeof ( *block ) );
+}
+
+/******************************************************************************
+ *
+ * PXE base code protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_start ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ BOOLEAN use_ipv6 __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_stop ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_dhcp ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ BOOLEAN sort __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_discover ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ UINT16 type __unused, UINT16 *layer __unused,
+ BOOLEAN bis __unused,
+ EFI_PXE_BASE_CODE_DISCOVER_INFO *info __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_mtftp ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ EFI_PXE_BASE_CODE_TFTP_OPCODE opcode __unused,
+ VOID *data __unused, BOOLEAN overwrite __unused,
+ UINT64 *len __unused, UINTN *blksize __unused,
+ EFI_IP_ADDRESS *ip __unused, UINT8 *filename __unused,
+ EFI_PXE_BASE_CODE_MTFTP_INFO *info __unused,
+ BOOLEAN callback __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_udp_write ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ UINT16 flags __unused,
+ EFI_IP_ADDRESS *dest_ip __unused,
+ EFI_PXE_BASE_CODE_UDP_PORT *dest_port __unused,
+ EFI_IP_ADDRESS *gateway __unused,
+ EFI_IP_ADDRESS *src_ip __unused,
+ EFI_PXE_BASE_CODE_UDP_PORT *src_port __unused,
+ UINTN *hdr_len __unused, VOID *hdr __unused,
+ UINTN *len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_udp_read ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ UINT16 flags __unused,
+ EFI_IP_ADDRESS *dest_ip __unused,
+ EFI_PXE_BASE_CODE_UDP_PORT *dest_port __unused,
+ EFI_IP_ADDRESS *src_ip __unused,
+ EFI_PXE_BASE_CODE_UDP_PORT *src_port __unused,
+ UINTN *hdr_len __unused, VOID *hdr __unused,
+ UINTN *len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_set_ip_filter ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ EFI_PXE_BASE_CODE_IP_FILTER *filter __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_arp ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ EFI_IP_ADDRESS *ip __unused,
+ EFI_MAC_ADDRESS *mac __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_set_parameters ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ BOOLEAN *autoarp __unused,
+ BOOLEAN *sendguid __unused, UINT8 *ttl __unused,
+ UINT8 *tos __unused,
+ BOOLEAN *callback __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_set_station_ip ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ EFI_IP_ADDRESS *ip __unused,
+ EFI_IP_ADDRESS *netmask __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_pxe_set_packets ( EFI_PXE_BASE_CODE_PROTOCOL *pxe __unused,
+ BOOLEAN *dhcpdisc_ok __unused,
+ BOOLEAN *dhcpack_ok __unused,
+ BOOLEAN *proxyoffer_ok __unused,
+ BOOLEAN *pxebsdisc_ok __unused,
+ BOOLEAN *pxebsack_ok __unused,
+ BOOLEAN *pxebsbis_ok __unused,
+ EFI_PXE_BASE_CODE_PACKET *dhcpdisc __unused,
+ EFI_PXE_BASE_CODE_PACKET *dhcpack __unused,
+ EFI_PXE_BASE_CODE_PACKET *proxyoffer __unused,
+ EFI_PXE_BASE_CODE_PACKET *pxebsdisc __unused,
+ EFI_PXE_BASE_CODE_PACKET *pxebsack __unused,
+ EFI_PXE_BASE_CODE_PACKET *pxebsbis __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_PXE_BASE_CODE_PROTOCOL efi_null_pxe = {
+ .Revision = EFI_PXE_BASE_CODE_PROTOCOL_REVISION,
+ .Start = efi_null_pxe_start,
+ .Stop = efi_null_pxe_stop,
+ .Dhcp = efi_null_pxe_dhcp,
+ .Discover = efi_null_pxe_discover,
+ .Mtftp = efi_null_pxe_mtftp,
+ .UdpWrite = efi_null_pxe_udp_write,
+ .UdpRead = efi_null_pxe_udp_read,
+ .SetIpFilter = efi_null_pxe_set_ip_filter,
+ .Arp = efi_null_pxe_arp,
+ .SetParameters = efi_null_pxe_set_parameters,
+ .SetStationIp = efi_null_pxe_set_station_ip,
+ .SetPackets = efi_null_pxe_set_packets,
+};
+
+/**
+ * Nullify PXE base code protocol
+ *
+ * @v pxe PXE base code protocol
+ */
+void efi_nullify_pxe ( EFI_PXE_BASE_CODE_PROTOCOL *pxe ) {
+
+ memcpy ( pxe, &efi_null_pxe, offsetof ( typeof ( *pxe ), Mode ) );
+ pxe->Mode->Started = FALSE;
+}
+
+/******************************************************************************
+ *
+ * Apple Net Boot protocol
+ *
+ ******************************************************************************
+ */
+
+static EFI_STATUS EFIAPI
+efi_null_apple_dhcp ( EFI_APPLE_NET_BOOT_PROTOCOL *apple __unused,
+ UINTN *len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_STATUS EFIAPI
+efi_null_apple_bsdp ( EFI_APPLE_NET_BOOT_PROTOCOL *apple __unused,
+ UINTN *len __unused, VOID *data __unused ) {
+ return EFI_UNSUPPORTED;
+}
+
+static EFI_APPLE_NET_BOOT_PROTOCOL efi_null_apple = {
+ .GetDhcpResponse = efi_null_apple_dhcp,
+ .GetBsdpResponse = efi_null_apple_bsdp,
+};
+
+/**
+ * Nullify Apple Net Boot protocol
+ *
+ * @v apple Apple Net Boot protocol
+ */
+void efi_nullify_apple ( EFI_APPLE_NET_BOOT_PROTOCOL *apple ) {
+
+ memcpy ( apple, &efi_null_apple, sizeof ( *apple ) );
+}