[mirror_edk2.git] / StdLib / ISSUES.txt

What follows is a list of currently known issues with the StdLib package.\r
Please see the separate file "Fixes.txt" for a list of issues that have been fixed.\r
\r
  Status Key:\r
    Open          Problem is unresolved and final disposition unknown.\r
    Verified      Problem has been reproduced.\r
    Understood    Root cause of problem is understood.\r
    Document      Problem is to be fixed through improved documentation.\r
    Fixed         Problem has been resolved and changes committed.\r
\r
SocketLib\r
=============\r
ID      Category                           TOOLs       Reported       Status\r
----  ------------------------            --------  --------------  -----------\r
 13:  EFIAPI usage                                      2013-01-15   Understood\r
      Mismatch between functions declared EFIAPI but not defined EFIAPI.\r
\r
 14:  EFIAPI usage                                      2013-01-15   Understood\r
      Function pointer type PFN_NET_CONFIGURE is NOT defined as EFIAPI but is\r
      used to point to EFIAPI functions.  This causes conflicts and results in\r
      improper operation.\r
\r
 15:  Build Error                                       2013-09-20   Open\r
      Predicates in ns_addr.c and res_mkupdate.c need to also include explicit\r
      comparisons if an assignment side-effect is used.  Otherwise a warning\r
      will be generated which is promoted to a fatal error.\r
\r
StdLib Issues\r
=============\r
ID      Category                           TOOLs       Reported       Status\r
----  ------------------------            --------  --------------  -----------\r
  3:  Usage Clarification                                     2012   Document\r
      Clarify that the current StdLib may not be used for developing drivers.\r
\r
  5:  Error message Quality during execution                  2012   Verified\r
      Performing filesystem operations when a filesystem driver has not been\r
      linked into the application results in hangs or error messages that are\r
      misleading or unclear as to the cause.\r
\r
  6:  Application error return                                2012   Verified\r
      On error, applications will sometimes return large positive numbers.\r
\r
  9:  chdir/cwd not in EFI Shell                              2012   Understood\r
      The chdir and getcwd functions only work if one is using the UEFI Shell.\r
\r
 10:  No current volume/directory at app. startup.            2012   Understood\r
      If the Shell does not have a current volume or directory, file operations\r
      may hang or fail.\r
\r
 12:  Differentiate between binary and text streams.     Aug. 2013   Understood\r
      Implement differentiated text streams as specified by section 7.19.2 Streams,\r
      of the C standard.\r
\r
 16:  Build Error                                       2013-08-12   Understood\r
      LibC/Stdio/vsnprintf_ss.c:145: (error) Uninitialized variable: n\r
      _DIAGASSERT expressions not appropriate for the UEFI environment.\r
\r
\r
PosixLib\r
=============\r
ID      Category                           TOOLs       Reported       Status\r
----  ------------------------            --------  --------------  -----------\r
Commit	Line	Data
	1	What follows is a list of currently known issues with the StdLib package.\r
	2	Please see the separate file "Fixes.txt" for a list of issues that have been fixed.\r
	3	\r
	4	Status Key:\r
	5	Open Problem is unresolved and final disposition unknown.\r
	6	Verified Problem has been reproduced.\r
	7	Understood Root cause of problem is understood.\r
	8	Document Problem is to be fixed through improved documentation.\r
	9	Fixed Problem has been resolved and changes committed.\r
	10	\r
	11	SocketLib\r
	12	=============\r
	13	ID Category TOOLs Reported Status\r
	14	---- ------------------------ -------- -------------- -----------\r
	15	13: EFIAPI usage 2013-01-15 Understood\r
	16	Mismatch between functions declared EFIAPI but not defined EFIAPI.\r
	17	\r
	18	14: EFIAPI usage 2013-01-15 Understood\r
	19	Function pointer type PFN_NET_CONFIGURE is NOT defined as EFIAPI but is\r
	20	used to point to EFIAPI functions. This causes conflicts and results in\r
	21	improper operation.\r
	22	\r
	23	15: Build Error 2013-09-20 Open\r
	24	Predicates in ns_addr.c and res_mkupdate.c need to also include explicit\r
	25	comparisons if an assignment side-effect is used. Otherwise a warning\r
	26	will be generated which is promoted to a fatal error.\r
	27	\r
	28	StdLib Issues\r
	29	=============\r
	30	ID Category TOOLs Reported Status\r
	31	---- ------------------------ -------- -------------- -----------\r
	32	3: Usage Clarification 2012 Document\r
	33	Clarify that the current StdLib may not be used for developing drivers.\r
	34	\r
	35	5: Error message Quality during execution 2012 Verified\r
	36	Performing filesystem operations when a filesystem driver has not been\r
	37	linked into the application results in hangs or error messages that are\r
	38	misleading or unclear as to the cause.\r
	39	\r
	40	6: Application error return 2012 Verified\r
	41	On error, applications will sometimes return large positive numbers.\r
	42	\r
	43	9: chdir/cwd not in EFI Shell 2012 Understood\r
	44	The chdir and getcwd functions only work if one is using the UEFI Shell.\r
	45	\r
	46	10: No current volume/directory at app. startup. 2012 Understood\r
	47	If the Shell does not have a current volume or directory, file operations\r
	48	may hang or fail.\r
	49	\r
	50	12: Differentiate between binary and text streams. Aug. 2013 Understood\r
	51	Implement differentiated text streams as specified by section 7.19.2 Streams,\r
	52	of the C standard.\r
	53	\r
	54	16: Build Error 2013-08-12 Understood\r
	55	LibC/Stdio/vsnprintf_ss.c:145: (error) Uninitialized variable: n\r
	56	_DIAGASSERT expressions not appropriate for the UEFI environment.\r
	57	\r
	58	\r
	59	PosixLib\r
	60	=============\r
	61	ID Category TOOLs Reported Status\r
	62	---- ------------------------ -------- -------------- -----------\r