audk/MdeModulePkg/Core/Dxe/SysCall/SupportedProtocols.c

/** @file

  Copyright (c) 2024 - 2025, Mikhail Krichanov. All rights reserved.
  SPDX-License-Identifier: BSD-3-Clause

**/

#include "DxeMain.h"
#include "SupportedProtocols.h"

LIST_ENTRY mUserSpaceDriversHead = INITIALIZE_LIST_HEAD_VARIABLE (mUserSpaceDriversHead);

EFI_STATUS
EFIAPI
GoToRing3 (
  IN UINT8 Number,
  IN VOID  *EntryPoint,
  ...
  )
{
  EFI_STATUS            Status;
  RING3_CALL_DATA       *Input;
  VA_LIST               Marker;
  UINTN                 Index;
  EFI_PHYSICAL_ADDRESS  Ring3Pages;
  UINT32                PagesNumber;

  PagesNumber = (UINT32)EFI_SIZE_TO_PAGES (sizeof (RING3_CALL_DATA) + Number * sizeof (UINTN));

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             PagesNumber,
             &Ring3Pages
             );
  if (EFI_ERROR (Status)) {
    return Status;
  }

  Input = (RING3_CALL_DATA *)(UINTN)Ring3Pages;

  AllowSupervisorAccessToUserMemory ();
  Input->NumberOfArguments = Number;
  Input->EntryPoint        = EntryPoint;

  VA_START (Marker, EntryPoint);
  for (Index = 0; Index < Number; ++Index) {
    Input->Arguments[Index] = VA_ARG (Marker, UINTN);
  }
  VA_END (Marker);
  ForbidSupervisorAccessToUserMemory ();

  Status = CallRing3 (Input);

  CoreFreePages (Ring3Pages, PagesNumber);

  return Status;
}

STATIC
USER_SPACE_DRIVER *
EFIAPI
FindUserSpaceDriver (
  IN VOID  *CoreWrapper
  )
{
  LIST_ENTRY         *Link;
  USER_SPACE_DRIVER  *UserDriver;

  for (Link = mUserSpaceDriversHead.ForwardLink; Link != &mUserSpaceDriversHead; Link = Link->ForwardLink) {
    UserDriver = BASE_CR (Link, USER_SPACE_DRIVER, Link);

    if (UserDriver->CoreWrapper == CoreWrapper) {
      return UserDriver;
    }
  }

  return NULL;
}

EFI_STATUS
EFIAPI
CoreDriverBindingSupported (
  IN EFI_DRIVER_BINDING_PROTOCOL *This,
  IN EFI_HANDLE                  ControllerHandle,
  IN EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath OPTIONAL
  )
{
  EFI_STATUS         Status;
  USER_SPACE_DRIVER  *UserDriver;
  VOID               *EntryPoint;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  EntryPoint = (VOID *)This->Supported;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             3,
             EntryPoint,
             This,
             ControllerHandle,
             RemainingDevicePath
             );

  return Status;
}

EFI_STATUS
EFIAPI
CoreDriverBindingStart (
  IN EFI_DRIVER_BINDING_PROTOCOL *This,
  IN EFI_HANDLE                  ControllerHandle,
  IN EFI_DEVICE_PATH_PROTOCOL    *RemainingDevicePath OPTIONAL
  )
{
  EFI_STATUS         Status;
  USER_SPACE_DRIVER  *UserDriver;
  VOID               *EntryPoint;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  EntryPoint = (VOID *)This->Start;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             3,
             EntryPoint,
             This,
             ControllerHandle,
             RemainingDevicePath
             );

  return Status;
}

EFI_STATUS
EFIAPI
CoreDriverBindingStop (
  IN EFI_DRIVER_BINDING_PROTOCOL *This,
  IN EFI_HANDLE                  ControllerHandle,
  IN UINTN                       NumberOfChildren,
  IN EFI_HANDLE                  *ChildHandleBuffer OPTIONAL
  )
{
  EFI_STATUS         Status;
  USER_SPACE_DRIVER  *UserDriver;
  VOID               *EntryPoint;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  EntryPoint = (VOID *)This->Stop;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             4,
             EntryPoint,
             This,
             ControllerHandle,
             NumberOfChildren,
             ChildHandleBuffer
             );

  return Status;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileClose (
  IN EFI_FILE_PROTOCOL  *This
  )
{
  EFI_STATUS         Status;
  USER_SPACE_DRIVER  *UserDriver;
  VOID               *EntryPoint;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  EntryPoint = (VOID *)This->Close;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             1,
             EntryPoint,
             This
             );

  FreePool (UserDriver->CoreWrapper);

  return Status;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileDelete (
  IN EFI_FILE_PROTOCOL  *This
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileRead (
  IN EFI_FILE_PROTOCOL        *This,
  IN OUT UINTN                *BufferSize,
  OUT VOID                    *Buffer
  )
{
  EFI_STATUS            Status;
  UINTN                 *Ring3BufferSize;
  VOID                  *Ring3Buffer;
  EFI_PHYSICAL_ADDRESS  Ring3Pages;
  UINT32                PagesNumber;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;

  if ((This == NULL) || (BufferSize == NULL)) {
    return EFI_INVALID_PARAMETER;
  }

  Ring3Buffer = NULL;
  Ring3Pages  = 0;
  PagesNumber = (UINT32)EFI_SIZE_TO_PAGES (sizeof (UINTN *) + *BufferSize);

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             PagesNumber,
             &Ring3Pages
             );
  if (EFI_ERROR (Status)) {
    return Status;
  }

  Ring3BufferSize = (UINTN *)(UINTN)Ring3Pages;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  *Ring3BufferSize = *BufferSize;
  EntryPoint       = (VOID *)This->Read;
  ForbidSupervisorAccessToUserMemory ();

  if (Buffer != NULL) {
    Ring3Buffer = (VOID *)((UINTN *)(UINTN)Ring3Pages + 1);
  }

  Status = GoToRing3 (
             3,
             EntryPoint,
             This,
             Ring3BufferSize,
             Ring3Buffer
             );

  AllowSupervisorAccessToUserMemory ();
  if ((Ring3Buffer != NULL) && (Buffer != NULL) && (*BufferSize >= *Ring3BufferSize)) {
    CopyMem (Buffer, Ring3Buffer, *Ring3BufferSize);
  }

  *BufferSize = *Ring3BufferSize;
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (Ring3Pages, PagesNumber);

  return Status;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileWrite (
  IN EFI_FILE_PROTOCOL        *This,
  IN OUT UINTN                *BufferSize,
  IN VOID                     *Buffer
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileSetPosition (
  IN EFI_FILE_PROTOCOL        *This,
  IN UINT64                   Position
  )
{
  USER_SPACE_DRIVER  *UserDriver;
  VOID               *EntryPoint;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  EntryPoint = (VOID *)This->SetPosition;
  ForbidSupervisorAccessToUserMemory ();

#if defined (MDE_CPU_X64) || defined (MDE_CPU_AARCH64)
  return GoToRing3 (
           2,
           EntryPoint,
           This,
           Position
           );
#elif defined (MDE_CPU_IA32)
  //
  // UINT64 Position is passed as 2 double words on stack.
  //
  return GoToRing3 (
           3,
           EntryPoint,
           This,
           Position
           );
#elif defined (MDE_CPU_ARM)
  //
  // UINT64 Position is passed as 2 words in 2 registers and is aligned on 8 bytes.
  // R0 == File->Ring3File, R1 == NULL, R2 == Position_Low, R3 == Position_High.
  //
  return GoToRing3 (
           4,
           EntryPoint,
           This,
           Position
           );
#endif

}

STATIC
EFI_STATUS
EFIAPI
CoreFileGetPosition (
  IN EFI_FILE_PROTOCOL        *This,
  OUT UINT64                  *Position
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  Ring3Position;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;

  if ((This == NULL) || (Position == NULL)) {
    return EFI_INVALID_PARAMETER;
  }

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             1,
             &Ring3Position
             );
  if (EFI_ERROR (Status)) {
    return Status;
  }

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  *(UINT64 *)(UINTN)Ring3Position = *Position;
  EntryPoint                      = (VOID *)This->GetPosition;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             2,
             EntryPoint,
             This,
             Ring3Position
             );

  AllowSupervisorAccessToUserMemory ();
  *Position = *(UINT64 *)(UINTN)Ring3Position;
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (Ring3Position, 1);

  return Status;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileGetInfo (
  IN EFI_FILE_PROTOCOL        *This,
  IN EFI_GUID                 *InformationType,
  IN OUT UINTN                *BufferSize,
  OUT VOID                    *Buffer
  )
{
  EFI_STATUS            Status;
  EFI_GUID              *Ring3InformationType;
  UINTN                 *Ring3BufferSize;
  VOID                  *Ring3Buffer;
  EFI_PHYSICAL_ADDRESS  Ring3Pages;
  UINT32                PagesNumber;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;

  if ((This == NULL) || (BufferSize == NULL)) {
    return EFI_INVALID_PARAMETER;
  }

  Ring3Buffer          = NULL;
  Ring3InformationType = NULL;
  Ring3Pages           = 0;

  PagesNumber = (UINT32)EFI_SIZE_TO_PAGES (sizeof (UINTN *) + *BufferSize + sizeof (EFI_GUID));

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             PagesNumber,
             &Ring3Pages
             );
  if (EFI_ERROR (Status)) {
    return Status;
  }

  Ring3BufferSize = (UINTN *)(UINTN)Ring3Pages;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  *Ring3BufferSize = *BufferSize;
  EntryPoint       = (VOID *)This->GetInfo;
  ForbidSupervisorAccessToUserMemory ();

  if (Buffer != NULL) {
    Ring3Buffer = (VOID *)((UINTN *)(UINTN)Ring3Pages + 1);
  }

  if (InformationType != NULL) {
    Ring3InformationType = (EFI_GUID *)((UINTN)Ring3Pages + sizeof (UINTN *) + *BufferSize);

    AllowSupervisorAccessToUserMemory ();
    CopyGuid (Ring3InformationType, InformationType);
    ForbidSupervisorAccessToUserMemory ();
  }

  Status = GoToRing3 (
             4,
             EntryPoint,
             This,
             Ring3InformationType,
             Ring3BufferSize,
             Ring3Buffer
             );

  AllowSupervisorAccessToUserMemory ();
  if ((Ring3Buffer != NULL) && (Buffer != NULL) && (*BufferSize >= *Ring3BufferSize)) {
    CopyMem (Buffer, Ring3Buffer, *Ring3BufferSize);
  }

  *BufferSize = *Ring3BufferSize;
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (Ring3Pages, PagesNumber);

  return Status;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileSetInfo (
  IN EFI_FILE_PROTOCOL        *This,
  IN EFI_GUID                 *InformationType,
  IN UINTN                    BufferSize,
  IN VOID                     *Buffer
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileFlush (
  IN EFI_FILE_PROTOCOL  *This
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileOpenEx (
  IN EFI_FILE_PROTOCOL        *This,
  OUT EFI_FILE_PROTOCOL       **NewHandle,
  IN CHAR16                   *FileName,
  IN UINT64                   OpenMode,
  IN UINT64                   Attributes,
  IN OUT EFI_FILE_IO_TOKEN    *Token
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileReadEx (
  IN EFI_FILE_PROTOCOL        *This,
  IN OUT EFI_FILE_IO_TOKEN    *Token
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileWriteEx (
  IN EFI_FILE_PROTOCOL        *This,
  IN OUT EFI_FILE_IO_TOKEN    *Token
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileFlushEx (
  IN EFI_FILE_PROTOCOL        *This,
  IN OUT EFI_FILE_IO_TOKEN    *Token
  )
{
  return EFI_UNSUPPORTED;
}

STATIC
EFI_STATUS
EFIAPI
CoreFileOpen (
  IN EFI_FILE_PROTOCOL        *This,
  OUT EFI_FILE_PROTOCOL       **NewHandle,
  IN CHAR16                   *FileName,
  IN UINT64                   OpenMode,
  IN UINT64                   Attributes
  )
{
  EFI_STATUS            Status;
  EFI_FILE_PROTOCOL     *NewFile;
  EFI_FILE_PROTOCOL     **Ring3NewHandle;
  CHAR16                *Ring3FileName;
  EFI_PHYSICAL_ADDRESS  Ring3Pages;
  UINT32                PagesNumber;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;

  if ((This == NULL) || (NewHandle == NULL) || (FileName == NULL)) {
    return EFI_INVALID_PARAMETER;
  }

  Ring3NewHandle = NULL;
  Ring3FileName  = NULL;
  Ring3Pages     = 0;

  PagesNumber = (UINT32)EFI_SIZE_TO_PAGES (sizeof (EFI_FILE_PROTOCOL *) + StrSize (FileName));

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             PagesNumber,
             &Ring3Pages
             );
  if (EFI_ERROR (Status)) {
    *NewHandle = NULL;
    return Status;
  }

  Ring3NewHandle = (EFI_FILE_PROTOCOL **)(UINTN)Ring3Pages;
  Ring3FileName  = (CHAR16 *)((EFI_FILE_PROTOCOL **)(UINTN)Ring3Pages + 1);

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  Status     = StrCpyS (Ring3FileName, StrLen (FileName) + 1, FileName);
  EntryPoint = (VOID *)This->Open;
  ForbidSupervisorAccessToUserMemory ();
  if (EFI_ERROR (Status)) {
    *NewHandle = NULL;
    CoreFreePages (Ring3Pages, PagesNumber);
    return Status;
  }

#if defined (MDE_CPU_X64) || defined (MDE_CPU_AARCH64)
  Status = GoToRing3 (
             5,
             EntryPoint,
             This,
             Ring3NewHandle,
             Ring3FileName,
             OpenMode,
             Attributes
             );
#elif defined (MDE_CPU_IA32)
  //
  // UINT64 OpenMode and Attributes are each passed as 2 double words on stack.
  //
  Status = GoToRing3 (
             7,
             EntryPoint,
             This,
             Ring3NewHandle,
             Ring3FileName,
             OpenMode,
             Attributes
             );
#elif defined (MDE_CPU_ARM)
  //
  // UINT64 OpenMode and Attributes are each passed as 2 words on stack.
  // Each of them is aligned on 8 bytes.
  // R0 == File->Ring3File, R1 == Ring3NewHandle, R2 == Ring3FileName, R3 == NULL,
  // [SP] == OpenMode, [SP + 8] == Attributes.
  //
  Status = GoToRing3 (
             8,
             EntryPoint,
             This,
             Ring3NewHandle,
             Ring3FileName,
             OpenMode,
             Attributes
             );
#endif
  if (EFI_ERROR (Status)) {
    *NewHandle = NULL;
    CoreFreePages (Ring3Pages, PagesNumber);
    return Status;
  }

  NewFile = AllocatePool (sizeof (EFI_FILE_PROTOCOL));
  if (NewFile == NULL) {
    *NewHandle = NULL;
    CoreFreePages (Ring3Pages, PagesNumber);
    return EFI_OUT_OF_RESOURCES;
  }

  UserDriver                = AllocatePool (sizeof (USER_SPACE_DRIVER));
  UserDriver->CoreWrapper   = NewFile;
  UserDriver->UserPageTable = gUserPageTable;

  AllowSupervisorAccessToUserMemory ();
  UserDriver->UserSpaceDriver = *Ring3NewHandle;
  NewFile->Revision           = (*Ring3NewHandle)->Revision;
  ForbidSupervisorAccessToUserMemory ();

  InsertTailList (&mUserSpaceDriversHead, &UserDriver->Link);

  NewFile->Open        = CoreFileOpen;
  NewFile->Close       = CoreFileClose;
  NewFile->Delete      = CoreFileDelete;
  NewFile->Read        = CoreFileRead;
  NewFile->Write       = CoreFileWrite;
  NewFile->GetPosition = CoreFileGetPosition;
  NewFile->SetPosition = CoreFileSetPosition;
  NewFile->GetInfo     = CoreFileGetInfo;
  NewFile->SetInfo     = CoreFileSetInfo;
  NewFile->Flush       = CoreFileFlush;
  NewFile->OpenEx      = CoreFileOpenEx;
  NewFile->ReadEx      = CoreFileReadEx;
  NewFile->WriteEx     = CoreFileWriteEx;
  NewFile->FlushEx     = CoreFileFlushEx;

  *NewHandle = (EFI_FILE_PROTOCOL *)NewFile;

  CoreFreePages (Ring3Pages, PagesNumber);

  return Status;
}

EFI_STATUS
EFIAPI
CoreOpenVolume (
  IN  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *This,
  OUT EFI_FILE_PROTOCOL               **Root
  )
{
  EFI_STATUS            Status;
  EFI_FILE_PROTOCOL     **Ring3Root;
  EFI_FILE_PROTOCOL     *File;
  EFI_PHYSICAL_ADDRESS  Physical;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;

  if (Root == NULL) {
    return EFI_INVALID_PARAMETER;
  }

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  AllowSupervisorAccessToUserMemory ();
  EntryPoint = (VOID *)This->OpenVolume;
  ForbidSupervisorAccessToUserMemory ();

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             1,
             &Physical
             );
  if (EFI_ERROR (Status)) {
    *Root = NULL;
    return Status;
  }

  Ring3Root = (EFI_FILE_PROTOCOL **)(UINTN)Physical;

  Status = GoToRing3 (
             2,
             EntryPoint,
             This,
             Ring3Root
             );
  if (EFI_ERROR (Status)) {
    *Root = NULL;
    CoreFreePages (Physical, 1);
    return Status;
  }

  File = AllocatePool (sizeof (EFI_FILE_PROTOCOL));
  if (File == NULL) {
    *Root = NULL;
    CoreFreePages (Physical, 1);
    return EFI_OUT_OF_RESOURCES;
  }

  UserDriver                = AllocatePool (sizeof (USER_SPACE_DRIVER));
  UserDriver->CoreWrapper   = File;
  UserDriver->UserPageTable = gUserPageTable;

  AllowSupervisorAccessToUserMemory ();
  UserDriver->UserSpaceDriver = *Ring3Root;
  File->Revision              = (*Ring3Root)->Revision;
  ForbidSupervisorAccessToUserMemory ();

  InsertTailList (&mUserSpaceDriversHead, &UserDriver->Link);

  File->Open        = CoreFileOpen;
  File->Close       = CoreFileClose;
  File->Delete      = CoreFileDelete;
  File->Read        = CoreFileRead;
  File->Write       = CoreFileWrite;
  File->GetPosition = CoreFileGetPosition;
  File->SetPosition = CoreFileSetPosition;
  File->GetInfo     = CoreFileGetInfo;
  File->SetInfo     = CoreFileSetInfo;
  File->Flush       = CoreFileFlush;
  File->OpenEx      = CoreFileOpenEx;
  File->ReadEx      = CoreFileReadEx;
  File->WriteEx     = CoreFileWriteEx;
  File->FlushEx     = CoreFileFlushEx;

  *Root = (EFI_FILE_PROTOCOL *)File;

  CoreFreePages (Physical, 1);

  return Status;
}

INTN
EFIAPI
CoreUnicodeCollationStriColl (
  IN EFI_UNICODE_COLLATION_PROTOCOL  *This,
  IN CHAR16                          *Str1,
  IN CHAR16                          *Str2
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  UserMem;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;
  UINTN                 Size1;
  UINTN                 Size2;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  Size1 = StrSize (Str1);
  Size2 = StrSize (Str2);

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             EFI_SIZE_TO_PAGES (Size1 + Size2),
             &UserMem
             );
  if (EFI_ERROR (Status)) {
    return 0;
  }

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)(UINTN)UserMem, (VOID *)Str1, Size1);
  CopyMem ((VOID *)((UINTN)UserMem + Size1), (VOID *)Str2, Size2);
  EntryPoint = (VOID *)This->StriColl;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             3,
             EntryPoint,
             This,
             (UINTN)UserMem,
             (UINTN)UserMem + Size1
             );

  CoreFreePages (UserMem, EFI_SIZE_TO_PAGES (Size1 + Size2));

  return (INTN)Status;
}

BOOLEAN
EFIAPI
CoreUnicodeCollationMetaiMatch (
  IN EFI_UNICODE_COLLATION_PROTOCOL  *This,
  IN CHAR16                          *String,
  IN CHAR16                          *Pattern
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  UserMem;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;
  UINTN                 Size1;
  UINTN                 Size2;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  Size1 = StrSize (String);
  Size2 = StrSize (Pattern);

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             EFI_SIZE_TO_PAGES (Size1 + Size2),
             &UserMem
             );
  if (EFI_ERROR (Status)) {
    return FALSE;
  }

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)(UINTN)UserMem, (VOID *)String, Size1);
  CopyMem ((VOID *)((UINTN)UserMem + Size1), (VOID *)Pattern, Size2);
  EntryPoint = (VOID *)This->MetaiMatch;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             3,
             EntryPoint,
             This,
             (UINTN)UserMem,
             (UINTN)UserMem + Size1
             );

  CoreFreePages (UserMem, EFI_SIZE_TO_PAGES (Size1 + Size2));

  return (BOOLEAN)Status;
}

VOID
EFIAPI
CoreUnicodeCollationStrLwr (
  IN EFI_UNICODE_COLLATION_PROTOCOL  *This,
  IN OUT CHAR16                      *Str
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  UserMem;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;
  UINTN                 Size1;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  Size1 = StrSize (Str);

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             EFI_SIZE_TO_PAGES (Size1),
             &UserMem
             );
  if (EFI_ERROR (Status)) {
    return;
  }

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)(UINTN)UserMem, (VOID *)Str, Size1);
  EntryPoint = (VOID *)This->StrLwr;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             2,
             EntryPoint,
             This,
             (UINTN)UserMem
             );

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)Str, (VOID *)(UINTN)UserMem, Size1);
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (UserMem, EFI_SIZE_TO_PAGES (Size1));
}

VOID
EFIAPI
CoreUnicodeCollationStrUpr (
  IN EFI_UNICODE_COLLATION_PROTOCOL  *This,
  IN OUT CHAR16                      *Str
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  UserMem;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;
  UINTN                 Size1;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  Size1 = StrSize (Str);

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             EFI_SIZE_TO_PAGES (Size1),
             &UserMem
             );
  if (EFI_ERROR (Status)) {
    return;
  }

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)(UINTN)UserMem, (VOID *)Str, Size1);
  EntryPoint = (VOID *)This->StrUpr;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             2,
             EntryPoint,
             This,
             (UINTN)UserMem
             );

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)Str, (VOID *)(UINTN)UserMem, Size1);
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (UserMem, EFI_SIZE_TO_PAGES (Size1));
}

VOID
EFIAPI
CoreUnicodeCollationFatToStr (
  IN EFI_UNICODE_COLLATION_PROTOCOL  *This,
  IN UINTN                           FatSize,
  IN CHAR8                           *Fat,
  OUT CHAR16                         *String
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  UserMem;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             EFI_SIZE_TO_PAGES (FatSize * 3),
             &UserMem
             );
  if (EFI_ERROR (Status)) {
    return;
  }

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)(UINTN)UserMem, (VOID *)Fat, FatSize);
  EntryPoint = (VOID *)This->FatToStr;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             4,
             EntryPoint,
             This,
             FatSize,
             (UINTN)UserMem,
             (UINTN)UserMem + FatSize
             );

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)String, (VOID *)((UINTN)UserMem + FatSize), FatSize * 2);
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (UserMem, EFI_SIZE_TO_PAGES (FatSize * 3));
}

BOOLEAN
EFIAPI
CoreUnicodeCollationStrToFat (
  IN EFI_UNICODE_COLLATION_PROTOCOL  *This,
  IN CHAR16                          *String,
  IN UINTN                           FatSize,
  OUT CHAR8                          *Fat
  )
{
  EFI_STATUS            Status;
  EFI_PHYSICAL_ADDRESS  UserMem;
  USER_SPACE_DRIVER     *UserDriver;
  VOID                  *EntryPoint;
  UINTN                 Size1;

  UserDriver = FindUserSpaceDriver (This);
  ASSERT (UserDriver != NULL);

  This           = UserDriver->UserSpaceDriver;
  gUserPageTable = UserDriver->UserPageTable;

  Size1 = StrSize (String);

  Status = CoreAllocatePages (
             AllocateAnyPages,
             EfiRing3MemoryType,
             EFI_SIZE_TO_PAGES (FatSize + Size1),
             &UserMem
             );
  if (EFI_ERROR (Status)) {
    return FALSE;
  }

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)(UINTN)UserMem, (VOID *)String, Size1);
  EntryPoint = (VOID *)This->StrToFat;
  ForbidSupervisorAccessToUserMemory ();

  Status = GoToRing3 (
             4,
             EntryPoint,
             This,
             (UINTN)UserMem,
             FatSize,
             (UINTN)UserMem + Size1
             );

  AllowSupervisorAccessToUserMemory ();
  CopyMem ((VOID *)Fat, (VOID *)((UINTN)UserMem + Size1), FatSize);
  ForbidSupervisorAccessToUserMemory ();

  CoreFreePages (UserMem, EFI_SIZE_TO_PAGES (FatSize + Size1));

  return (BOOLEAN)Status;
}