[mirror_edk2.git] / BaseTools / Source / C / Common / CommonLib.h

/** @file\r
Common library assistance routines.\r
\r
Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#ifndef _EFI_COMMON_LIB_H\r
#define _EFI_COMMON_LIB_H\r
\r
#include <Common/UefiBaseTypes.h>\r
#include <Common/BuildVersion.h>\r
#include <assert.h>\r
#ifndef _WIN32\r
#include <limits.h>\r
#endif\r
\r
#define PRINTED_GUID_BUFFER_SIZE  37  // including null-termination\r
\r
#ifdef PATH_MAX\r
#define MAX_LONG_FILE_PATH PATH_MAX\r
#else\r
#define MAX_LONG_FILE_PATH 500\r
#endif\r
\r
#define MAX_UINT64 ((UINT64)0xFFFFFFFFFFFFFFFFULL)\r
#define MAX_UINT32 ((UINT32)0xFFFFFFFF)\r
#define MAX_UINT16  ((UINT16)0xFFFF)\r
#define MAX_UINT8   ((UINT8)0xFF)\r
#define ARRAY_SIZE(Array) (sizeof (Array) / sizeof ((Array)[0]))\r
#define ASCII_RSIZE_MAX 1000000\r
#undef RSIZE_MAX\r
#define RSIZE_MAX 1000000\r
\r
#define IS_COMMA(a)                ((a) == L',')\r
#define IS_HYPHEN(a)               ((a) == L'-')\r
#define IS_DOT(a)                  ((a) == L'.')\r
#define IS_LEFT_PARENTH(a)         ((a) == L'(')\r
#define IS_RIGHT_PARENTH(a)        ((a) == L')')\r
#define IS_SLASH(a)                ((a) == L'/')\r
#define IS_NULL(a)                 ((a) == L'\0')\r
\r
#define ASSERT(x) assert(x)\r
\r
#ifdef __cplusplus\r
extern "C" {\r
#endif\r
\r
//\r
// Function declarations\r
//\r
VOID\r
PeiZeroMem (\r
  IN VOID   *Buffer,\r
  IN UINTN  Size\r
  )\r
;\r
\r
VOID\r
PeiCopyMem (\r
  IN VOID   *Destination,\r
  IN VOID   *Source,\r
  IN UINTN  Length\r
  )\r
;\r
\r
VOID\r
ZeroMem (\r
  IN VOID   *Buffer,\r
  IN UINTN  Size\r
  )\r
;\r
\r
VOID\r
CopyMem (\r
  IN VOID   *Destination,\r
  IN VOID   *Source,\r
  IN UINTN  Length\r
  )\r
;\r
\r
INTN\r
CompareGuid (\r
  IN EFI_GUID     *Guid1,\r
  IN EFI_GUID     *Guid2\r
  )\r
;\r
\r
EFI_STATUS\r
GetFileImage (\r
  IN CHAR8    *InputFileName,\r
  OUT CHAR8   **InputFileImage,\r
  OUT UINT32  *BytesRead\r
  )\r
;\r
\r
EFI_STATUS\r
PutFileImage (\r
  IN CHAR8    *OutputFileName,\r
  IN CHAR8    *OutputFileImage,\r
  IN UINT32   BytesToWrite\r
  )\r
;\r
/*++\r
\r
Routine Description:\r
\r
  This function opens a file and writes OutputFileImage into the file.\r
\r
Arguments:\r
\r
  OutputFileName     The name of the file to write.\r
  OutputFileImage    A pointer to the memory buffer.\r
  BytesToWrite       The size of the memory buffer.\r
\r
Returns:\r
\r
  EFI_SUCCESS              The function completed successfully.\r
  EFI_INVALID_PARAMETER    One of the input parameters was invalid.\r
  EFI_ABORTED              An error occurred.\r
  EFI_OUT_OF_RESOURCES     No resource to complete operations.\r
\r
**/\r
\r
UINT8\r
CalculateChecksum8 (\r
  IN UINT8        *Buffer,\r
  IN UINTN        Size\r
  )\r
;\r
\r
UINT8\r
CalculateSum8 (\r
  IN UINT8        *Buffer,\r
  IN UINTN        Size\r
  )\r
;\r
\r
UINT16\r
CalculateChecksum16 (\r
  IN UINT16       *Buffer,\r
  IN UINTN        Size\r
  )\r
;\r
\r
UINT16\r
CalculateSum16 (\r
  IN UINT16       *Buffer,\r
  IN UINTN        Size\r
  )\r
;\r
\r
EFI_STATUS\r
PrintGuid (\r
  IN EFI_GUID                     *Guid\r
  )\r
;\r
\r
#define PRINTED_GUID_BUFFER_SIZE  37  // including null-termination\r
EFI_STATUS\r
PrintGuidToBuffer (\r
  IN EFI_GUID     *Guid,\r
  IN OUT UINT8    *Buffer,\r
  IN UINT32       BufferLen,\r
  IN BOOLEAN      Uppercase\r
  )\r
;\r
\r
CHAR8 *\r
LongFilePath (\r
 IN CHAR8 *FileName\r
);\r
\r
UINTN\r
StrLen (\r
  CONST CHAR16   *String\r
  );\r
\r
VOID *\r
AllocateCopyPool (\r
  UINTN       AllocationSize,\r
  CONST VOID  *Buffer\r
  );\r
\r
INTN\r
StrnCmp (\r
  CONST CHAR16              *FirstString,\r
  CONST CHAR16              *SecondString,\r
  UINTN                     Length\r
  );\r
\r
RETURN_STATUS\r
StrToGuid (\r
  CONST CHAR16       *String,\r
  EFI_GUID               *Guid\r
  );\r
\r
RETURN_STATUS\r
StrHexToBytes (\r
  CONST CHAR16       *String,\r
  UINTN              Length,\r
  UINT8              *Buffer,\r
  UINTN              MaxBufferSize\r
  );\r
\r
UINTN\r
InternalHexCharToUintn (\r
  CHAR16                    Char\r
  );\r
\r
VOID *\r
InternalAllocateCopyPool (\r
   UINTN            AllocationSize,\r
   CONST VOID       *Buffer\r
  );\r
\r
BOOLEAN\r
InternalIsDecimalDigitCharacter (\r
        CHAR16                    Char\r
  );\r
\r
UINT32\r
SwapBytes32 (\r
        UINT32                    Value\r
  );\r
\r
UINT16\r
SwapBytes16 (\r
        UINT16                    Value\r
  );\r
\r
EFI_GUID *\r
CopyGuid (\r
   EFI_GUID       *DestinationGuid,\r
   CONST EFI_GUID  *SourceGuid\r
  );\r
\r
UINT64\r
WriteUnaligned64 (\r
   UINT64                    *Buffer,\r
   UINT64                    Value\r
  );\r
\r
UINT64\r
ReadUnaligned64 (\r
   CONST UINT64              *Buffer\r
  );\r
\r
UINTN\r
StrSize (\r
  CONST CHAR16              *String\r
  );\r
\r
UINT64\r
StrHexToUint64 (\r
  CONST CHAR16             *String\r
  );\r
\r
UINT64\r
StrDecimalToUint64 (\r
  CONST CHAR16              *String\r
  );\r
\r
RETURN_STATUS\r
StrHexToUint64S (\r
    CONST CHAR16       *String,\r
    CHAR16             **EndPointer,\r
    UINT64             *Data\r
  );\r
\r
RETURN_STATUS\r
StrDecimalToUint64S (\r
    CONST CHAR16             *String,\r
         CHAR16             **EndPointer,  OPTIONAL\r
         UINT64             *Data\r
  );\r
\r
VOID *\r
ReallocatePool (\r
   UINTN  OldSize,\r
   UINTN  NewSize,\r
   VOID   *OldBuffer  OPTIONAL\r
  );\r
\r
VOID *\r
InternalReallocatePool (\r
   UINTN            OldSize,\r
   UINTN            NewSize,\r
   VOID             *OldBuffer  OPTIONAL\r
  );\r
\r
VOID *\r
InternalAllocateZeroPool (\r
   UINTN            AllocationSize\r
  ) ;\r
\r
VOID *\r
InternalAllocatePool (\r
   UINTN            AllocationSize\r
  );\r
\r
UINTN\r
StrnLenS (\r
   CONST CHAR16              *String,\r
   UINTN                     MaxSize\r
  );\r
\r
CHAR16\r
InternalCharToUpper (\r
        CHAR16                    Char\r
  );\r
\r
INTN\r
StrCmp (\r
  CONST CHAR16              *FirstString,\r
  CONST CHAR16              *SecondString\r
  );\r
\r
UINT64\r
SwapBytes64 (\r
  UINT64                    Value\r
  );\r
\r
UINT64\r
InternalMathSwapBytes64 (\r
  UINT64                    Operand\r
  );\r
\r
RETURN_STATUS\r
StrToIpv4Address (\r
  CONST CHAR16       *String,\r
  CHAR16             **EndPointer,\r
  EFI_IPv4_ADDRESS       *Address,\r
  UINT8              *PrefixLength\r
  );\r
\r
RETURN_STATUS\r
StrToIpv6Address (\r
  CONST CHAR16       *String,\r
  CHAR16             **EndPointer,\r
  EFI_IPv6_ADDRESS       *Address,\r
  UINT8              *PrefixLength\r
  );\r
\r
RETURN_STATUS\r
StrCpyS (\r
  CHAR16       *Destination,\r
  UINTN        DestMax,\r
  CONST CHAR16 *Source\r
  );\r
\r
RETURN_STATUS\r
UnicodeStrToAsciiStrS (\r
  CONST CHAR16              *Source,\r
  CHAR8                     *Destination,\r
  UINTN                     DestMax\r
  );\r
VOID *\r
AllocatePool (\r
  UINTN  AllocationSize\r
  );\r
\r
UINT16\r
WriteUnaligned16 (\r
  UINT16                    *Buffer,\r
  UINT16                    Value\r
  );\r
\r
UINT16\r
ReadUnaligned16 (\r
  CONST UINT16              *Buffer\r
  );\r
\r
VOID *\r
AllocateZeroPool (\r
  UINTN  AllocationSize\r
  );\r
\r
BOOLEAN\r
InternalIsHexaDecimalDigitCharacter (\r
  CHAR16                    Char\r
  );\r
\r
BOOLEAN\r
InternalSafeStringIsOverlap (\r
  IN VOID    *Base1,\r
  IN UINTN   Size1,\r
  IN VOID    *Base2,\r
  IN UINTN   Size2\r
  );\r
\r
BOOLEAN\r
InternalSafeStringNoStrOverlap (\r
  IN CHAR16  *Str1,\r
  IN UINTN   Size1,\r
  IN CHAR16  *Str2,\r
  IN UINTN   Size2\r
  );\r
\r
BOOLEAN\r
IsHexStr (\r
   CHAR16   *Str\r
  );\r
\r
UINTN\r
Strtoi (\r
   CHAR16  *Str\r
  );\r
\r
VOID\r
Strtoi64 (\r
    CHAR16  *Str,\r
   UINT64  *Data\r
  );\r
\r
VOID\r
StrToAscii (\r
       CHAR16 *Str,\r
    CHAR8  **AsciiStr\r
  );\r
\r
CHAR16 *\r
SplitStr (\r
    CHAR16 **List,\r
       CHAR16 Separator\r
  );\r
\r
/*++\r
\r
Routine Description:\r
  Convert FileName to the long file path, which can support larger than 260 length.\r
\r
Arguments:\r
  FileName         - FileName.\r
\r
Returns:\r
  LongFilePath      A pointer to the converted long file path.\r
\r
--*/\r
\r
#ifdef __cplusplus\r
}\r
#endif\r
\r
#ifdef __GNUC__\r
#include <stdio.h>\r
#include <sys/stat.h>\r
#define stricmp strcasecmp\r
#define _stricmp strcasecmp\r
#define strnicmp strncasecmp\r
#define strcmpi strcasecmp\r
size_t _filelength(int fd);\r
#ifndef __CYGWIN__\r
char *strlwr(char *s);\r
#endif\r
#endif\r
\r
//\r
// On windows, mkdir only has one parameter.\r
// On unix, it has two parameters\r
//\r
#if defined(__GNUC__)\r
#define mkdir(dir, perm) mkdir(dir, perm)\r
#else\r
#define mkdir(dir, perm) mkdir(dir)\r
#endif\r
\r
#endif\r
Commit	Line	Data
30fdf114	1	/** @file\r
97fa0ee9	2	Common library assistance routines.\r
30fdf114	3	\r
e4fb8f1d	4	Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>\r
2e351cbe	5	SPDX-License-Identifier: BSD-2-Clause-Patent\r
30fdf114	6	\r
30fdf114 LG	7	**/\r
	8	\r
	9	#ifndef _EFI_COMMON_LIB_H\r
	10	#define _EFI_COMMON_LIB_H\r
	11	\r
	12	#include <Common/UefiBaseTypes.h>\r
b36d134f	13	#include <Common/BuildVersion.h>\r
7dbc50bd	14	#include <assert.h>\r
020ec963 EZ	15	#ifndef _WIN32\r
	16	#include <limits.h>\r
	17	#endif\r
	18	\r
30fdf114	19	#define PRINTED_GUID_BUFFER_SIZE 37 // including null-termination\r
1be2ed90	20	\r
020ec963 EZ	21	#ifdef PATH_MAX\r
	22	#define MAX_LONG_FILE_PATH PATH_MAX\r
	23	#else\r
1be2ed90	24	#define MAX_LONG_FILE_PATH 500\r
020ec963	25	#endif\r
1be2ed90	26	\r
7dbc50bd	27	#define MAX_UINT64 ((UINT64)0xFFFFFFFFFFFFFFFFULL)\r
4d393eb8	28	#define MAX_UINT32 ((UINT32)0xFFFFFFFF)\r
7dbc50bd YZ	29	#define MAX_UINT16 ((UINT16)0xFFFF)\r
	30	#define MAX_UINT8 ((UINT8)0xFF)\r
	31	#define ARRAY_SIZE(Array) (sizeof (Array) / sizeof ((Array)[0]))\r
	32	#define ASCII_RSIZE_MAX 1000000\r
e4fb8f1d	33	#undef RSIZE_MAX\r
7dbc50bd	34	#define RSIZE_MAX 1000000\r
7dbc50bd YZ	35	\r
	36	#define IS_COMMA(a) ((a) == L',')\r
	37	#define IS_HYPHEN(a) ((a) == L'-')\r
	38	#define IS_DOT(a) ((a) == L'.')\r
	39	#define IS_LEFT_PARENTH(a) ((a) == L'(')\r
	40	#define IS_RIGHT_PARENTH(a) ((a) == L')')\r
	41	#define IS_SLASH(a) ((a) == L'/')\r
	42	#define IS_NULL(a) ((a) == L'\0')\r
	43	\r
	44	#define ASSERT(x) assert(x)\r
	45	\r
1be2ed90 HC	46	#ifdef __cplusplus\r
	47	extern "C" {\r
	48	#endif\r
97fa0ee9	49	\r
30fdf114 LG	50	//\r
	51	// Function declarations\r
	52	//\r
	53	VOID\r
	54	PeiZeroMem (\r
	55	IN VOID *Buffer,\r
	56	IN UINTN Size\r
	57	)\r
	58	;\r
	59	\r
	60	VOID\r
	61	PeiCopyMem (\r
	62	IN VOID *Destination,\r
	63	IN VOID *Source,\r
	64	IN UINTN Length\r
	65	)\r
	66	;\r
	67	\r
	68	VOID\r
	69	ZeroMem (\r
	70	IN VOID *Buffer,\r
	71	IN UINTN Size\r
	72	)\r
	73	;\r
	74	\r
	75	VOID\r
	76	CopyMem (\r
	77	IN VOID *Destination,\r
	78	IN VOID *Source,\r
	79	IN UINTN Length\r
	80	)\r
	81	;\r
	82	\r
	83	INTN\r
	84	CompareGuid (\r
	85	IN EFI_GUID *Guid1,\r
	86	IN EFI_GUID *Guid2\r
	87	)\r
	88	;\r
	89	\r
	90	EFI_STATUS\r
	91	GetFileImage (\r
	92	IN CHAR8 *InputFileName,\r
	93	OUT CHAR8 **InputFileImage,\r
	94	OUT UINT32 *BytesRead\r
	95	)\r
	96	;\r
	97	\r
	98	EFI_STATUS\r
	99	PutFileImage (\r
	100	IN CHAR8 *OutputFileName,\r
	101	IN CHAR8 *OutputFileImage,\r
	102	IN UINT32 BytesToWrite\r
	103	)\r
	104	;\r
	105	/*++\r
	106	\r
	107	Routine Description:\r
	108	\r
	109	This function opens a file and writes OutputFileImage into the file.\r
	110	\r
	111	Arguments:\r
	112	\r
	113	OutputFileName The name of the file to write.\r
114	OutputFileImage A pointer to the memory buffer.\r
115	BytesToWrite The size of the memory buffer.\r
116	\r
117	Returns:\r
118	\r
119	EFI_SUCCESS The function completed successfully.\r
120	EFI_INVALID_PARAMETER One of the input parameters was invalid.\r
121	EFI_ABORTED An error occurred.\r
122	EFI_OUT_OF_RESOURCES No resource to complete operations.\r
123	\r
124	**/\r
125	\r
126	UINT8\r
127	CalculateChecksum8 (\r
128	IN UINT8 *Buffer,\r
129	IN UINTN Size\r
130	)\r
131	;\r
132	\r
133	UINT8\r
134	CalculateSum8 (\r
135	IN UINT8 *Buffer,\r
136	IN UINTN Size\r
137	)\r
138	;\r
139	\r
140	UINT16\r
141	CalculateChecksum16 (\r
142	IN UINT16 *Buffer,\r
143	IN UINTN Size\r
144	)\r
145	;\r
146	\r
147	UINT16\r
148	CalculateSum16 (\r
149	IN UINT16 *Buffer,\r
150	IN UINTN Size\r
151	)\r
152	;\r
153	\r
154	EFI_STATUS\r
155	PrintGuid (\r
156	IN EFI_GUID *Guid\r
157	)\r
158	;\r
159	\r
160	#define PRINTED_GUID_BUFFER_SIZE 37 // including null-termination\r
161	EFI_STATUS\r
162	PrintGuidToBuffer (\r
163	IN EFI_GUID *Guid,\r
164	IN OUT UINT8 *Buffer,\r
165	IN UINT32 BufferLen,\r
166	IN BOOLEAN Uppercase\r
167	)\r
168	;\r
169	\r
1be2ed90 HC	170	CHAR8 *\r
	171	LongFilePath (\r
	172	IN CHAR8 *FileName\r
	173	);\r
7dbc50bd YZ	174	\r
	175	UINTN\r
	176	StrLen (\r
	177	CONST CHAR16 *String\r
	178	);\r
	179	\r
	180	VOID *\r
	181	AllocateCopyPool (\r
	182	UINTN AllocationSize,\r
	183	CONST VOID *Buffer\r
	184	);\r
	185	\r
	186	INTN\r
	187	StrnCmp (\r
	188	CONST CHAR16 *FirstString,\r
	189	CONST CHAR16 *SecondString,\r
	190	UINTN Length\r
	191	);\r
	192	\r
	193	RETURN_STATUS\r
	194	StrToGuid (\r
	195	CONST CHAR16 *String,\r
	196	EFI_GUID *Guid\r
	197	);\r
	198	\r
	199	RETURN_STATUS\r
	200	StrHexToBytes (\r
	201	CONST CHAR16 *String,\r
	202	UINTN Length,\r
	203	UINT8 *Buffer,\r
	204	UINTN MaxBufferSize\r
	205	);\r
	206	\r
	207	UINTN\r
	208	InternalHexCharToUintn (\r
	209	CHAR16 Char\r
	210	);\r
	211	\r
	212	VOID *\r
	213	InternalAllocateCopyPool (\r
	214	UINTN AllocationSize,\r
	215	CONST VOID *Buffer\r
	216	);\r
	217	\r
	218	BOOLEAN\r
	219	InternalIsDecimalDigitCharacter (\r
	220	CHAR16 Char\r
	221	);\r
	222	\r
	223	UINT32\r
	224	SwapBytes32 (\r
	225	UINT32 Value\r
	226	);\r
	227	\r
	228	UINT16\r
	229	SwapBytes16 (\r
	230	UINT16 Value\r
	231	);\r
	232	\r
	233	EFI_GUID *\r
	234	CopyGuid (\r
	235	EFI_GUID *DestinationGuid,\r
	236	CONST EFI_GUID *SourceGuid\r
	237	);\r
238	\r
239	UINT64\r
240	WriteUnaligned64 (\r
241	UINT64 *Buffer,\r
242	UINT64 Value\r
243	);\r
244	\r
245	UINT64\r
246	ReadUnaligned64 (\r
247	CONST UINT64 *Buffer\r
248	);\r
249	\r
250	UINTN\r
251	StrSize (\r
252	CONST CHAR16 *String\r
253	);\r
254	\r
7dbc50bd YZ	255	UINT64\r
	256	StrHexToUint64 (\r
	257	CONST CHAR16 *String\r
	258	);\r
	259	\r
	260	UINT64\r
	261	StrDecimalToUint64 (\r
	262	CONST CHAR16 *String\r
	263	);\r
	264	\r
	265	RETURN_STATUS\r
	266	StrHexToUint64S (\r
	267	CONST CHAR16 *String,\r
	268	CHAR16 **EndPointer,\r
	269	UINT64 *Data\r
	270	);\r
	271	\r
7dbc50bd YZ	272	RETURN_STATUS\r
	273	StrDecimalToUint64S (\r
	274	CONST CHAR16 *String,\r
	275	CHAR16 **EndPointer, OPTIONAL\r
	276	UINT64 *Data\r
	277	);\r
	278	\r
7dbc50bd YZ	279	VOID *\r
	280	ReallocatePool (\r
	281	UINTN OldSize,\r
	282	UINTN NewSize,\r
	283	VOID *OldBuffer OPTIONAL\r
	284	);\r
	285	\r
	286	VOID *\r
	287	InternalReallocatePool (\r
	288	UINTN OldSize,\r
	289	UINTN NewSize,\r
	290	VOID *OldBuffer OPTIONAL\r
	291	);\r
	292	\r
	293	VOID *\r
	294	InternalAllocateZeroPool (\r
	295	UINTN AllocationSize\r
	296	) ;\r
	297	\r
	298	VOID *\r
	299	InternalAllocatePool (\r
	300	UINTN AllocationSize\r
	301	);\r
	302	\r
	303	UINTN\r
	304	StrnLenS (\r
	305	CONST CHAR16 *String,\r
	306	UINTN MaxSize\r
	307	);\r
	308	\r
	309	CHAR16\r
	310	InternalCharToUpper (\r
	311	CHAR16 Char\r
	312	);\r
	313	\r
	314	INTN\r
	315	StrCmp (\r
	316	CONST CHAR16 *FirstString,\r
	317	CONST CHAR16 *SecondString\r
	318	);\r
	319	\r
	320	UINT64\r
	321	SwapBytes64 (\r
	322	UINT64 Value\r
	323	);\r
	324	\r
	325	UINT64\r
	326	InternalMathSwapBytes64 (\r
	327	UINT64 Operand\r
	328	);\r
	329	\r
	330	RETURN_STATUS\r
	331	StrToIpv4Address (\r
	332	CONST CHAR16 *String,\r
	333	CHAR16 **EndPointer,\r
	334	EFI_IPv4_ADDRESS *Address,\r
	335	UINT8 *PrefixLength\r
	336	);\r
	337	\r
	338	RETURN_STATUS\r
	339	StrToIpv6Address (\r
	340	CONST CHAR16 *String,\r
	341	CHAR16 **EndPointer,\r
	342	EFI_IPv6_ADDRESS *Address,\r
343	UINT8 *PrefixLength\r
344	);\r
345	\r
346	RETURN_STATUS\r
347	StrCpyS (\r
348	CHAR16 *Destination,\r
349	UINTN DestMax,\r
350	CONST CHAR16 *Source\r
351	);\r
352	\r
353	RETURN_STATUS\r
354	UnicodeStrToAsciiStrS (\r
355	CONST CHAR16 *Source,\r
356	CHAR8 *Destination,\r
357	UINTN DestMax\r
358	);\r
359	VOID *\r
360	AllocatePool (\r
361	UINTN AllocationSize\r
362	);\r
363	\r
364	UINT16\r
365	WriteUnaligned16 (\r
366	UINT16 *Buffer,\r
367	UINT16 Value\r
368	);\r
369	\r
370	UINT16\r
371	ReadUnaligned16 (\r
372	CONST UINT16 *Buffer\r
373	);\r
374	\r
375	VOID *\r
376	AllocateZeroPool (\r
377	UINTN AllocationSize\r
378	);\r
379	\r
380	BOOLEAN\r
381	InternalIsHexaDecimalDigitCharacter (\r
382	CHAR16 Char\r
383	);\r
384	\r
385	BOOLEAN\r
386	InternalSafeStringIsOverlap (\r
387	IN VOID *Base1,\r
388	IN UINTN Size1,\r
389	IN VOID *Base2,\r
390	IN UINTN Size2\r
391	);\r
392	\r
393	BOOLEAN\r
394	InternalSafeStringNoStrOverlap (\r
395	IN CHAR16 *Str1,\r
396	IN UINTN Size1,\r
397	IN CHAR16 *Str2,\r
398	IN UINTN Size2\r
399	);\r
400	\r
401	BOOLEAN\r
402	IsHexStr (\r
403	CHAR16 *Str\r
404	);\r
405	\r
406	UINTN\r
407	Strtoi (\r
408	CHAR16 *Str\r
409	);\r
410	\r
411	VOID\r
412	Strtoi64 (\r
413	CHAR16 *Str,\r
414	UINT64 *Data\r
415	);\r
416	\r
417	VOID\r
418	StrToAscii (\r
419	CHAR16 *Str,\r
420	CHAR8 **AsciiStr\r
421	);\r
422	\r
423	CHAR16 *\r
424	SplitStr (\r
425	CHAR16 **List,\r
426	CHAR16 Separator\r
427	);\r
428	\r
1be2ed90 HC	429	/*++\r
	430	\r
	431	Routine Description:\r
f7496d71	432	Convert FileName to the long file path, which can support larger than 260 length.\r
1be2ed90 HC	433	\r
1be2ed90 HC	434	Arguments:\r
f7496d71	435	FileName - FileName.\r
1be2ed90 HC	436	\r
	437	Returns:\r
	438	LongFilePath A pointer to the converted long file path.\r
f7496d71	439	\r
1be2ed90 HC	440	--*/\r
	441	\r
	442	#ifdef __cplusplus\r
	443	}\r
	444	#endif\r
	445	\r
30fdf114 LG	446	#ifdef __GNUC__\r
	447	#include <stdio.h>\r
	448	#include <sys/stat.h>\r
	449	#define stricmp strcasecmp\r
	450	#define _stricmp strcasecmp\r
	451	#define strnicmp strncasecmp\r
	452	#define strcmpi strcasecmp\r
	453	size_t _filelength(int fd);\r
	454	#ifndef __CYGWIN__\r
	455	char strlwr(char s);\r
	456	#endif\r
	457	#endif\r
	458	\r
	459	//\r
	460	// On windows, mkdir only has one parameter.\r
	461	// On unix, it has two parameters\r
	462	//\r
	463	#if defined(__GNUC__)\r
	464	#define mkdir(dir, perm) mkdir(dir, perm)\r
	465	#else\r
	466	#define mkdir(dir, perm) mkdir(dir)\r
	467	#endif\r
	468	\r
	469	#endif\r