AcpiParser.h

Go to the documentation of this file.

 
#ifndef ACPI_PARSER_H
#define ACPI_PARSER_H
 
typedef struct {
  UINT8     *CurrentOpcode;
  UINT8     *TableStart;
  UINT8     *TableEnd;
  UINT32    *PathStart;
  UINT32    *CurrentIdentifier;
  UINT32    *PathEnd;
  UINT32    Nesting;
  UINT32    RequiredEntry;
  UINT32    EntriesFound;
} ACPI_PARSER_CONTEXT;
 
#define IDENT_LEN    4
#define OPCODE_LEN   8
#define MAX_NESTING  1024
 
#define CONTEXT_ENTER(Context, Name) \
  DEBUG (( \
    DEBUG_VERBOSE, \
    "%a 0x%x (looking for %c%c%c%c)\n", \
    (Name), \
    (UINT32) ((Context)->CurrentOpcode - (Context)->TableStart), \
    ((CHAR8 *) (Context)->CurrentIdentifier)[3], \
    ((CHAR8 *) (Context)->CurrentIdentifier)[2], \
    ((CHAR8 *) (Context)->CurrentIdentifier)[1], \
    ((CHAR8 *) (Context)->CurrentIdentifier)[0] \
    ));
 
#define PRINT_ACPI_NAME(Str, Name, Length) \
  DEBUG (( \
    DEBUG_VERBOSE, \
    "%a %u (%c%c%c%c)\n", \
    (Str), \
    (Length), \
    (Length) > 0 ? (Name)[((Length) - 1) * 4 + 0] : 'Z', \
    (Length) > 0 ? (Name)[((Length) - 1) * 4 + 1] : 'Z', \
    (Length) > 0 ? (Name)[((Length) - 1) * 4 + 2] : 'Z', \
    (Length) > 0 ? (Name)[((Length) - 1) * 4 + 3] : 'Z' \
    ));
 
#define CONTEXT_HAS_WORK(Context)  do {\
    ASSERT ((Context) != NULL); \
    ASSERT ((Context)->CurrentOpcode != NULL); \
    ASSERT ((Context)->TableEnd != NULL); \
    ASSERT ((Context)->CurrentOpcode < (Context)->TableEnd); /* Must always have work to do. */ \
    ASSERT ((Context)->PathStart != NULL); \
    ASSERT ((Context)->PathEnd != NULL); \
    ASSERT ((Context)->CurrentIdentifier != NULL); \
    ASSERT ((Context)->CurrentIdentifier < (Context)->PathEnd); /* Must always have IDs to parse. */ \
    ASSERT ((Context)->RequiredEntry > 0); \
    ASSERT ((Context)->EntriesFound < (Context)->RequiredEntry); /* Must have entries to find. */ \
  } while (0)
 
#define CONTEXT_INCREASE_NESTING(Context)  do {\
    ++(Context)->Nesting; \
    if ((Context)->Nesting > MAX_NESTING) { \
      return EFI_OUT_OF_RESOURCES; \
    } \
  } while (0)
 
#define CONTEXT_DECREASE_NESTING(Context)  do {\
    ASSERT ((Context)->Nesting > 0); \
    --(Context)->Nesting; \
  } while (0)
 
#define CONTEXT_PEEK_BYTES(Context, Bytes)  do {\
    if ((UINT32) ((Context)->TableEnd - (Context)->CurrentOpcode) < (UINT32) (Bytes)) { \
      return EFI_DEVICE_ERROR; \
    } \
  } while (0)
 
#define CONTEXT_CONSUME_BYTES(Context, Bytes)  do {\
    if ((UINT32) ((Context)->TableEnd - (Context)->CurrentOpcode) < (UINT32) (Bytes)) { \
      return EFI_DEVICE_ERROR; \
    } \
    (Context)->CurrentOpcode += (Bytes); \
  } while (0)
 
#define CONTEXT_ADVANCE_OPCODE(Context)  do {\
    if ((UINT32) ((Context)->TableEnd - (Context)->CurrentOpcode) <= 1U) { \
      return EFI_DEVICE_ERROR; \
    } \
    ++(Context)->CurrentOpcode; \
  } while (0)
 
EFI_STATUS
InternalAcpiParseTerm (
  IN OUT ACPI_PARSER_CONTEXT  *Context,
  OUT UINT8                   **Result
  );
 
#endif // ACPI_PARSER_H