ArmPkg/SemihostFs: Fix open file issues revealed by SCT

[mirror_edk2.git] / ArmPkg / Filesystem / SemihostFs / Arm / SemihostFs.h

/** @file\r
  Support a Semi Host file system over a debuggers JTAG\r
\r
  Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>\r
\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions of the BSD License\r
  which accompanies this distribution.  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#ifndef __SEMIHOST_FS_H__\r
#define __SEMIHOST_FS_H__\r
\r
EFI_STATUS\r
VolumeOpen (\r
  IN  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *This,\r
  OUT EFI_FILE                        **Root\r
  );\r
\r
/**\r
  Open a file on the host system by means of the semihosting interface.\r
\r
  @param[in]   This        A pointer to the EFI_FILE_PROTOCOL instance that is\r
                           the file handle to source location.\r
  @param[out]  NewHandle   A pointer to the location to return the opened\r
                           handle for the new file.\r
  @param[in]   FileName    The Null-terminated string of the name of the file\r
                           to be opened.\r
  @param[in]   OpenMode    The mode to open the file : Read or Read/Write or\r
                           Read/Write/Create\r
  @param[in]   Attributes  Only valid for EFI_FILE_MODE_CREATE, in which case these\r
                           are the attribute bits for the newly created file. The\r
                           mnemonics of the attribute bits are : EFI_FILE_READ_ONLY,\r
                           EFI_FILE_HIDDEN, EFI_FILE_SYSTEM, EFI_FILE_RESERVED,\r
                           EFI_FILE_DIRECTORY and EFI_FILE_ARCHIVE.\r
\r
  @retval  EFI_SUCCESS            The file was open.\r
  @retval  EFI_NOT_FOUND          The specified file could not be found.\r
  @retval  EFI_DEVICE_ERROR       The last issued semi-hosting operation failed.\r
  @retval  EFI_WRITE_PROTECTED    Attempt to create a directory. This is not possible\r
                                  with the semi-hosting interface.\r
  @retval  EFI_OUT_OF_RESOURCES   Not enough resources were available to open the file.\r
  @retval  EFI_INVALID_PARAMETER  At least one of the parameters is invalid.\r
\r
**/\r
EFI_STATUS\r
FileOpen (\r
  IN  EFI_FILE  *This,\r
  OUT EFI_FILE  **NewHandle,\r
  IN  CHAR16    *FileName,\r
  IN  UINT64    OpenMode,\r
  IN  UINT64    Attributes\r
  );\r
\r
EFI_STATUS\r
FileClose (\r
  IN EFI_FILE *File\r
  );\r
\r
EFI_STATUS\r
FileDelete(\r
  IN EFI_FILE *File\r
  );\r
\r
EFI_STATUS\r
FileRead (\r
  IN     EFI_FILE *File,\r
  IN OUT UINTN    *BufferSize,\r
  OUT    VOID     *Buffer\r
  );\r
\r
EFI_STATUS\r
FileWrite (\r
  IN     EFI_FILE *File,\r
  IN OUT UINTN    *BufferSize,\r
  IN     VOID     *Buffer\r
  );\r
\r
EFI_STATUS\r
FileGetPosition (\r
  IN  EFI_FILE  *File,\r
  OUT UINT64    *Position\r
  );\r
\r
EFI_STATUS\r
FileSetPosition (\r
  IN EFI_FILE *File,\r
  IN UINT64   Position\r
  );\r
\r
EFI_STATUS\r
FileGetInfo (\r
  IN     EFI_FILE *File,\r
  IN     EFI_GUID *InformationType,\r
  IN OUT UINTN    *BufferSize,\r
  OUT    VOID     *Buffer\r
  );\r
\r
EFI_STATUS\r
FileSetInfo (\r
  IN EFI_FILE *File,\r
  IN EFI_GUID *InformationType,\r
  IN UINTN    BufferSize,\r
  IN VOID     *Buffer\r
  );\r
\r
EFI_STATUS\r
FileFlush (\r
  IN EFI_FILE *File\r
  );\r
\r
#endif // __SEMIHOST_FS_H__\r
\r