mirror of
https://github.com/opnsense/src.git
synced 2026-02-27 03:40:37 -05:00
3245fa215a
We use these to compile libefivar. The particular motivation for this update is
the inclusion of the RISC-V machine definitions that allow us to build the
library on the platform. This support could easily have been submitted as a
small local diff, but the timing of the release coincided with this work, and
it has been over 3 years since these sources were initially imported.
Note that this comes with a license change from regular BSD 2-clause to the
BSD+Patent license. This has been approved by core@ for this particular
project [1].
As with the original import, we retain only the subset of headers that we
actually need to build libefivar. I adapted imp@'s process slightly for this
update:
# Generate list of the headers needed to build
cp -r ../vendor/edk2/dist/MdePkg/Include sys/contrib/edk2
cd lib/libefivar
make
pushd `make -V .OBJDIR`
cat .depend*.o | grep sys/contrib | cut -d' ' -f 3 |
sort -u | sed -e 's=/full/path/sys/contrib/edk2/==' > /tmp/xxx
popd
# Merge the needed files
cd ../../sys/contrib/edk2
svn revert -R .
for i in `cat /tmp/xxx`; do
svn merge -c VendorRevision svn+ssh://repo.freebsd.org/base/vendor/edk2/dist/MdePkg/$i $i
done
svn merge -c VendorRevision svn+ssh://repo.freebsd.org/base/vendor/edk2/dist/MdePkg/MdePkg.dec MdePkg.dec
[1] https://www.freebsd.org/internal/software-license.html
140 lines
4.2 KiB
C
140 lines
4.2 KiB
C
/** @file
|
|
|
|
The file defines the EFI Debugport protocol.
|
|
This protocol is used by debug agent to communicate with the
|
|
remote debug host.
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __DEBUG_PORT_H__
|
|
#define __DEBUG_PORT_H__
|
|
|
|
|
|
///
|
|
/// DebugPortIo protocol {EBA4E8D2-3858-41EC-A281-2647BA9660D0}
|
|
///
|
|
#define EFI_DEBUGPORT_PROTOCOL_GUID \
|
|
{ \
|
|
0xEBA4E8D2, 0x3858, 0x41EC, {0xA2, 0x81, 0x26, 0x47, 0xBA, 0x96, 0x60, 0xD0 } \
|
|
}
|
|
|
|
extern EFI_GUID gEfiDebugPortProtocolGuid;
|
|
|
|
typedef struct _EFI_DEBUGPORT_PROTOCOL EFI_DEBUGPORT_PROTOCOL;
|
|
|
|
//
|
|
// DebugPort member functions
|
|
//
|
|
|
|
/**
|
|
Resets the debugport.
|
|
|
|
@param This A pointer to the EFI_DEBUGPORT_PROTOCOL instance.
|
|
|
|
@retval EFI_SUCCESS The debugport device was reset and is in usable state.
|
|
@retval EFI_DEVICE_ERROR The debugport device could not be reset and is unusable.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_DEBUGPORT_RESET)(
|
|
IN EFI_DEBUGPORT_PROTOCOL *This
|
|
);
|
|
|
|
/**
|
|
Writes data to the debugport.
|
|
|
|
@param This A pointer to the EFI_DEBUGPORT_PROTOCOL instance.
|
|
@param Timeout The number of microseconds to wait before timing out a write operation.
|
|
@param BufferSize On input, the requested number of bytes of data to write. On output, the
|
|
number of bytes of data actually written.
|
|
@param Buffer A pointer to a buffer containing the data to write.
|
|
|
|
@retval EFI_SUCCESS The data was written.
|
|
@retval EFI_DEVICE_ERROR The device reported an error.
|
|
@retval EFI_TIMEOUT The data write was stopped due to a timeout.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_DEBUGPORT_WRITE)(
|
|
IN EFI_DEBUGPORT_PROTOCOL *This,
|
|
IN UINT32 Timeout,
|
|
IN OUT UINTN *BufferSize,
|
|
IN VOID *Buffer
|
|
);
|
|
|
|
/**
|
|
Reads data from the debugport.
|
|
|
|
@param This A pointer to the EFI_DEBUGPORT_PROTOCOL instance.
|
|
@param Timeout The number of microseconds to wait before timing out a read operation.
|
|
@param BufferSize On input, the requested number of bytes of data to read. On output, the
|
|
number of bytes of data actually number of bytes
|
|
of data read and returned in Buffer.
|
|
@param Buffer A pointer to a buffer into which the data read will be saved.
|
|
|
|
@retval EFI_SUCCESS The data was read.
|
|
@retval EFI_DEVICE_ERROR The device reported an error.
|
|
@retval EFI_TIMEOUT The operation was stopped due to a timeout or overrun.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_DEBUGPORT_READ)(
|
|
IN EFI_DEBUGPORT_PROTOCOL *This,
|
|
IN UINT32 Timeout,
|
|
IN OUT UINTN *BufferSize,
|
|
OUT VOID *Buffer
|
|
);
|
|
|
|
/**
|
|
Checks to see if any data is available to be read from the debugport device.
|
|
|
|
@param This A pointer to the EFI_DEBUGPORT_PROTOCOL instance.
|
|
|
|
@retval EFI_SUCCESS At least one byte of data is available to be read.
|
|
@retval EFI_DEVICE_ERROR The debugport device is not functioning correctly.
|
|
@retval EFI_NOT_READY No data is available to be read.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_DEBUGPORT_POLL)(
|
|
IN EFI_DEBUGPORT_PROTOCOL *This
|
|
);
|
|
|
|
///
|
|
/// This protocol provides the communication link between the debug agent and the remote host.
|
|
///
|
|
struct _EFI_DEBUGPORT_PROTOCOL {
|
|
EFI_DEBUGPORT_RESET Reset;
|
|
EFI_DEBUGPORT_WRITE Write;
|
|
EFI_DEBUGPORT_READ Read;
|
|
EFI_DEBUGPORT_POLL Poll;
|
|
};
|
|
|
|
//
|
|
// DEBUGPORT variable definitions...
|
|
//
|
|
#define EFI_DEBUGPORT_VARIABLE_NAME L"DEBUGPORT"
|
|
#define EFI_DEBUGPORT_VARIABLE_GUID EFI_DEBUGPORT_PROTOCOL_GUID
|
|
|
|
extern EFI_GUID gEfiDebugPortVariableGuid;
|
|
|
|
//
|
|
// DebugPort device path definitions...
|
|
//
|
|
#define DEVICE_PATH_MESSAGING_DEBUGPORT EFI_DEBUGPORT_PROTOCOL_GUID
|
|
|
|
extern EFI_GUID gEfiDebugPortDevicePathGuid;
|
|
|
|
typedef struct {
|
|
EFI_DEVICE_PATH_PROTOCOL Header;
|
|
EFI_GUID Guid;
|
|
} DEBUGPORT_DEVICE_PATH;
|
|
|
|
#endif
|