<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"> <head> <meta http-equiv="Content-Type" content="text/html; charset=Windows-1252"> <meta name="Generator" content="Microsoft Word 15 (filtered medium)"> <style></style> </head> <body lang="EN-US" link="blue" vlink="#954F72"> <div class="WordSection1"> Hi UEFI community,<o:p></o:p> <o:p> </o:p> I�d like to inform you about an update in the CdePkg branch of edk2-staging.<o:p></o:p> <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg#cdepkg">https://github.com/tianocore/edk2-staging/tree/CdePkg#cdepkg</a><o:p></o:p> <o:p> </o:p> The goal of the CdePkg is to provide an ANSI C Interface for UEFI POST drivers,<o:p></o:p> that enables BIOS engineers to (more) easily port standard C programs or libraries<o:p></o:p> (e.g. the openSSL library, already done) to POST drivers.<o:p></o:p> <o:p> </o:p> Furthermore the ANSI C Interface is disseminated widely, also it�s bugs and pitfalls are known very well<o:p></o:p> by a broad range of IT professionals and may help to be better supportable by the open source initiative<o:p></o:p> compared to the proprietary interface that is available today in Tianocore UEFI.<o:p></o:p> <o:p> </o:p> Now 21 new ANSI C functions wprintf(), swprintf(), vswprintf(), wcscpy(), wcsncpy(), <o:p></o:p> wcscat(), wcsncat(), wcscmp(), wcsncmp(),wcschr(), wcscspn(), wcspbrk(), wcsrchr(), <o:p></o:p> wcsspn(), wcsstr(), wcstok(), wcslen(), wmemcmp(), wmemcpy(), wmemmove(), wmemset()<o:p></o:p> are introduced for PEI and DXE.<o:p></o:p> <o:p> </o:p> Currently there are 7 examples implemented: <ol style="margin-top:0in" start="1" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo1">argvc: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/HOSTED_ENV/argcv/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/HOSTED_ENV/argcv/main.c#L57</a><o:p></o:p></li></ol> argc/argv handling according to <a href="https://msdn.microsoft.com/en-us/library/a1y7w461.aspx"> https://msdn.microsoft.com/en-us/library/a1y7w461.aspx</a> <ol style="margin-top:0in" start="2" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo1">systeminterfacePEI: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfacePEI/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfacePEI/main.c#L57</a><o:p></o:p></li></ol> demonstration, how PeiServices and FileHandle are passed into main()<o:p></o:p> <ol style="margin-top:0in" start="3" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo1">systeminterfaceDXE: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfaceDXE/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfaceDXE/main.c#L57</a><o:p></o:p></li></ol> demonstration, how SystemTable and ImageHandle are passed into main()<o:p></o:p> <o:p> </o:p> ANSI C LIBRARY functions:<o:p></o:p> <ol style="margin-top:0in" start="4" type="1"> <li class="MsoListParagraph" style="margin-left:0in;mso-list:l2 level1 lfo1">time.h clock(): <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/TIME_H/clock/main.c#L1">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/TIME_H/clock/main.c#L1</a><o:p></o:p></li></ol> for PEI and DXE phase. It provides TSC based, millisecond precise, exact and chipset independent clock() function. NOTE: in emulation mode the TSC nominal frequency is supposed to be 1GHz <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/clock?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/clock?view=vs-2019</a> <ol style="margin-top:0in" start="5" type="1"> <li class="MsoListParagraph" style="color:black;margin-left:0in;mso-list:l2 level1 lfo1"> time.h difftime(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/difftime-difftime32-difftime64?view=vs-2019"> https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/difftime-difftime32-difftime64?view=vs-2019</a><o:p></o:p></li></ol> time.h mktime(): <a href="%20https:/docs.microsoft.com/en-us/cpp/c-runtime-library/reference/mktime-mktime32-mktime64?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/mktime-mktime32-mktime64?view=vs-2019</a><o:p></o:p> time.h time(): <a href="%20https:/docs.microsoft.com/en-us/cpp/c-runtime-library/reference/time-time32-time64?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/time-time32-time64?view=vs-2019</a><o:p></o:p> time.h asctime(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/asctime-wasctime?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/asctime-wasctime?view=vs-2019</a><o:p></o:p> time.h ctime(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64?view=vs-2019</a><o:p></o:p> time.h gmtime(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/gmtime-gmtime32-gmtime64?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/gmtime-gmtime32-gmtime64?view=vs-2019</a><o:p></o:p> time.h localtime(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/localtime-localtime32-localtime64?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/localtime-localtime32-localtime64?view=vs-2019</a><o:p></o:p> time.h strftime(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l?view=vs-2019</a> NOTE: All TIME.H functions support UTC only.<o:p></o:p> All functions are tested in one single driver PEI/DXE: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/TIME_H/timehfunctions/main.c#L52">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/TIME_H/timehfunctions/main.c#L52</a><o:p></o:p> <ol style="margin-top:0in" start="6" type="1"> <li class="MsoListParagraph" style="color:black;margin-left:0in;mso-list:l2 level1 lfo1"> STRING.H memcpy():<a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcpy-wmemcpy?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcpy-wmemcpy?view=vs-2019</a><o:p></o:p></li></ol> STRING.H memmove():<a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memmove-wmemmove?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memmove-wmemmove?view=vs-2019</a><o:p></o:p> STRING.H strcpy(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcpy-wcscpy-mbscpy?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcpy-wcscpy-mbscpy?view=vs-2019</a><o:p></o:p> STRING.H strncpy(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncpy-strncpy-l-wcsncpy-wcsncpy-l-mbsncpy-mbsncpy-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncpy-strncpy-l-wcsncpy-wcsncpy-l-mbsncpy-mbsncpy-l?view=vs-2019</a><o:p></o:p> STRING.H strcat(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcat-wcscat-mbscat?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcat-wcscat-mbscat?view=vs-2019</a><o:p></o:p> STRING.H strncat(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncat-strncat-l-wcsncat-wcsncat-l-mbsncat-mbsncat-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncat-strncat-l-wcsncat-wcsncat-l-mbsncat-mbsncat-l?view=vs-2019</a><o:p></o:p> STRING.H memcmp(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcmp-wmemcmp?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcmp-wmemcmp?view=vs-2019</a><o:p></o:p> STRING.H strcmp(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcmp-wcscmp-mbscmp?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcmp-wcscmp-mbscmp?view=vs-2019</a><o:p></o:p> STRING.H strncmp(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncmp-wcsncmp-mbsncmp-mbsncmp-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncmp-wcsncmp-mbsncmp-mbsncmp-l?view=vs-2019</a><o:p></o:p> STRING.H memchr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memchr-wmemchr?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memchr-wmemchr?view=vs-2019</a><o:p></o:p> STRING.H strchr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strchr-wcschr-mbschr-mbschr-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strchr-wcschr-mbschr-mbschr-l?view=vs-2019</a><o:p></o:p> STRING.H strcspn(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcspn-wcscspn-mbscspn-mbscspn-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcspn-wcscspn-mbscspn-mbscspn-l?view=vs-2019</a><o:p></o:p> STRING.H strpbrk(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strpbrk-wcspbrk-mbspbrk-mbspbrk-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strpbrk-wcspbrk-mbspbrk-mbspbrk-l?view=vs-2019</a><o:p></o:p> STRING.H strrchr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l?view=vs-2019</a><o:p></o:p> STRING.H strspn(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strspn-wcsspn-mbsspn-mbsspn-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strspn-wcsspn-mbsspn-mbsspn-l?view=vs-2019</a><o:p></o:p> STRING.H strstr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l?view=vs-2019</a><o:p></o:p> STRING.H strtok(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l?view=vs-2019</a><o:p></o:p> STRING.H memset(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memset-wmemset?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memset-wmemset?view=vs-2019</a><o:p></o:p> STRING.H strerror(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strerror-strerror-wcserror-wcserror?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strerror-strerror-wcserror-wcserror?view=vs-2019</a><o:p></o:p> STRING.H strlen(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l?view=vs-2019</a><o:p></o:p> NOTE: All STRING.H functions are completely available in PEI and DXE, except strcoll() and strxftm()<o:p></o:p> All functions are tested in one single driver PEI/DXE: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/STRING_H/stringhfunctions/main.c#L52">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/STRING_H/stringhfunctions/main.c#L52</a> <ol style="margin-top:0in" start="7" type="1"> <li class="MsoListParagraph" style="color:red;margin-left:0in;mso-list:l2 level1 lfo1"> NEW: WCHAR.H wprintf(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/printf-printf-l-wprintf-wprintf-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/printf-printf-l-wprintf-wprintf-l?view=vs-2019</a><o:p></o:p></li></ol> NEW: WCHAR.H swprintf(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H vswprintf(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcscpy(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcpy-wcscpy-mbscpy?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcpy-wcscpy-mbscpy?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcsncpy(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncpy-strncpy-l-wcsncpy-wcsncpy-l-mbsncpy-mbsncpy-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncpy-strncpy-l-wcsncpy-wcsncpy-l-mbsncpy-mbsncpy-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcscat(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcat-wcscat-mbscat?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcat-wcscat-mbscat?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcsncat(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncat-strncat-l-wcsncat-wcsncat-l-mbsncat-mbsncat-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncat-strncat-l-wcsncat-wcsncat-l-mbsncat-mbsncat-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcscmp(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcmp-wcscmp-mbscmp?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcmp-wcscmp-mbscmp?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcsncmp(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncmp-wcsncmp-mbsncmp-mbsncmp-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strncmp-wcsncmp-mbsncmp-mbsncmp-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcschr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strchr-wcschr-mbschr-mbschr-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strchr-wcschr-mbschr-mbschr-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcscspn(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcspn-wcscspn-mbscspn-mbscspn-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strcspn-wcscspn-mbscspn-mbscspn-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcspbrk(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strpbrk-wcspbrk-mbspbrk-mbspbrk-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strpbrk-wcspbrk-mbspbrk-mbspbrk-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcsrchr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcsspn(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strspn-wcsspn-mbsspn-mbsspn-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strspn-wcsspn-mbsspn-mbsspn-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcsstr(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strstr-wcsstr-mbsstr-mbsstr-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strstr-wcsstr-mbsstr-mbsstr-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcstok(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wcslen(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wmemcmp(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcmp-wmemcmp?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcmp-wmemcmp?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wmemcpy(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcpy-wmemcpy?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memcpy-wmemcpy?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wmemmove(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memmove-wmemmove?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memmove-wmemmove?view=vs-2019</a><o:p></o:p> NEW: WCHAR.H wmemset(): <a href="https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memset-wmemset?view=vs-2019">https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/memset-wmemset?view=vs-2019</a> NOTE: 21 WCHAR.H functions are available in PEI and DXE. 29 functions are not yet implemented, that are file and multi byte functions<o:p></o:p> All functions are tested in one single driver PEI/DXE: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/WCHAR_H/wcharhfunctions/main.c#L52">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/WCHAR_H/wcharhfunctions/main.c</a> <o:p> </o:p> Best Regards,<o:p></o:p> Kilian<o:p></o:p> <o:p> </o:p> From: <a href="mailto:KILIAN_KEGEL@OUTLOOK.COM">Kilian Kegel</a> Sent: Wednesday, October 23, 2019 10:03 PM To: <a href="mailto:devel@edk2.groups.io">devel@edk2.groups.io</a> Cc: <a href="mailto:michael.d.kinney@intel.com">Kinney, Michael D</a>; <a href="mailto:brian.richardson@intel.com"> Richardson, Brian</a> Subject: [edk2-devel] [staging/branch]: CdePkg - C Development Environment Package<o:p></o:p> <o:p> </o:p> Hi UEFI community,<o:p></o:p> <o:p> </o:p> I�d like to introduce the CdePkg to edk2-staging.<o:p></o:p> <o:p> </o:p> Some time ago I decided to write my own ANSI C Library for UEFI Shell and POST.<o:p></o:p> <o:p> </o:p> The UEFI Shell library (�Torito C Library�) has been production-ready for more than one year.<o:p></o:p> The POST version of the library (�CdeLib�) is not yet fully tested.<o:p></o:p> <o:p> </o:p> I will be demonstrating my verification procedure in the upcoming weeks on EDK2 STAGING <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg">https://github.com/tianocore/edk2-staging/tree/CdePkg</a> <o:p> </o:p> Currently there are 3 examples implemented: <ol style="margin-top:0in" start="8" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo1">argvc: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/HOSTED_ENV/argcv/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/HOSTED_ENV/argcv/main.c#L57</a><o:p></o:p></li></ol> argc/argv handling according to <a href="https://msdn.microsoft.com/en-us/library/a1y7w461.aspx"> https://msdn.microsoft.com/en-us/library/a1y7w461.aspx</a> <ol style="margin-top:0in" start="9" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo1">systeminterfacePEI: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfacePEI/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfacePEI/main.c#L57</a><o:p></o:p></li></ol> demonstration, how PeiServices and FileHandle are passed into main()<o:p></o:p> <ol style="margin-top:0in" start="10" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo1">systeminterfaceDXE: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfaceDXE/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfaceDXE/main.c#L57</a><o:p></o:p></li></ol> demonstration, how SystemTable and ImageHandle are passed into main()<o:p></o:p> <o:p> </o:p> Upcoming next demonstration will be the clock() function end of this week<o:p></o:p> <o:p> </o:p> The idea is to bring the ANSI C Library interface into POST drivers.<o:p></o:p> This will:<o:p></o:p> <ol style="margin-top:0in" start="1" type="1"> <li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo2">ease porting tasks<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo2">allow cross development<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo2">allow developers to focus on their aims, because they aren�t forced to keep in mind a lot of additional info (e.g. RShiftU64)<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo2">provide all intrisics to allow the compiler to be a �C compiler�<o:p></o:p></li></ol> (e.g. char buffer[256] = { 1 };)<o:p></o:p> <o:p> </o:p> What is CdePkg and Torito C Library?<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">CdePkg and Torito C Library are a one man show / after work party, that is owned and written solely by myself<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">CdePkg is a reference implementation only for Microsoft C compiler<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">CdePkg is a feasibility study<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">CdePkg is the successor of Torito C, based on the same source code<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">CdePkg C Development Environment is similar to MdePkg Module Development Environment<o:p></o:p></li></ul> but guarantees that the C compiler is always fully usable (all intrinsics available) and the C90/C95 standard library is always available<o:p></o:p> <o:p> </o:p> What are the design goals?<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo3"> to rewrite the whole thing from scratch, without using any public source code from GNU, BSD, Watcom<o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo3"> completeness: full blown C90 + C95 support, as lowest common denominator<o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo3"> tailored for UEFI: small code size, for UEFI-POST-driver uses a C-Library-Driver, that contains core/worker functions for realloc() == malloc() and free(), <o:p></o:p></li></ul> entire printf()-family, entire scanf()-family.<o:p></o:p> UEFI-POST-driver just uses small wrapper functions to run the C-Library-Driver code.<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">stable, exact, chipset independent TSC based clock() with CLOCKS_PER_SEC == 1000 <o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo3">complete set of the Microsoft C-compiler intrinsic functions <o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo3"> ROM-able! Runs with stack but w/o any static storage duration in .data segment, e.g. for rand(), strtok(), tmpfile()<o:p></o:p></li></ul> This is required for early PEI before memory sizing, when PEI-images run directly out of flash<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo3"> Microsoft (bug) compatible (as far as possible)<o:p></o:p></li></ul> <ol style="margin-top:0in" start="5" type="1"> <ol style="margin-top:0in" start="1" type="a"> <li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l3 level2 lfo4"> use original Microsoft header files for UEFI Shell Apps created in VS2019 <o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l3 level2 lfo4"> allow expensive debugging tasks of ANSI C .EFI applications in Visual Studio in its Windows NT counter part<o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l3 level2 lfo4"> to save my lifetime writing a documentation <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg/implemented.md#validation-status"> https://github.com/tianocore/edk2-staging/tree/CdePkg/implemented.md#validation-status</a><o:p></o:p></li></ol> </ol> <ul style="margin-top:0in" type="disc"> <li class="MsoListParagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo3"> all the above in one single C-Library CdeLib.lib<o:p></o:p></li></ul> <o:p> </o:p> CdePkg shall be adjusted to other compilers/tool chains too, once it is feature-complete and accepted by the UEFI community.<o:p></o:p> As long as it is for Microsoft VS2019 only.<o:p></o:p> <o:p> </o:p> CdePkg README.md is here: <a href="https://github.com/MinnowWare/CdePkg#cdepkg" title="https://github.com/MinnowWare/CdePkg#cdepkg STRG + Klicken, um Verkn�pfung zu folgen"> </a> <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg#cdepkg">https://github.com/tianocore/edk2-staging/tree/CdePkg#cdepkg</a><o:p></o:p> CdePkg HOWTO is here: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/README.md#howto">https://github.com/tianocore/edk2-staging/blob/CdePkg/README.md#howto</a><o:p></o:p> CdeValidationPkg README.md is here: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md#cdevalidationpkg">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md</a><o:p></o:p> CdeValidationPkg HOWTO is here: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md#howto"> https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md</a><o:p></o:p> <o:p> </o:p> HOWTO:<o:p></o:p> <ol style="margin-top:0in" start="1" type="1"> <li class="xmsonormal" style="color:black;mso-list:l1 level1 lfo5">clone the edk2-staging repository<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l1 level1 lfo5">checkout CdePkg<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l1 level1 lfo5">run LAUNCH.BAT<o:p></o:p></li><li class="xmsonormal" style="mso-list:l1 level1 lfo5">run <code>build -p EmulatorPkg\EmulatorPkg.dsc -t VS2015x86 -a IA32</code><code><o:p></o:p></code></li><li class="xmsonormal" style="mso-list:l1 level1 lfo5"><code>run DBGEMU.BAT to start emulation (EmulatorPkg)<o:p></o:p></code></li><li class="xmsonormal" style="mso-list:l1 level1 lfo5"><code>run build -a IA32 -a X64 -n 5 -t VS2015x86 -b DEBUG -p Vlv2TbltDevicePkg\PlatformPkgX64.dsc</code><code><o:p></o:p></code></li><li class="xmsonormal" style="mso-list:l1 level1 lfo5"><code>update MinnowBoard with Build/Vlv2TbltDevicePkgX64\DEBUG_VS2015x86\FV\VLV.fd<o:p></o:p></code></li></ol> <code><o:p> </o:p></code> <code>Best regards,<o:p></o:p></code> <code>Kilian Kegel</code> <o:p> </o:p> <o:p> </o:p> <o:p> </o:p> <o:p> </o:p> <o:p> </o:p> </o:p> <o:p> </o:p> </div> </body> </html> <div width="1" style="color:white;clear:both">_._,_._,_</div> <hr> Groups.io Links: You receive all messages sent to this group. <a target="_blank" href="https://edk2.groups.io/g/devel/message/51220">View/Reply Online (#51220)</a> | | <a target="_blank" href="https://groups.io/mt/61916424/1813853">Mute This Topic</a> | <a href="https://edk2.groups.io/g/devel/post">New Topic</a> <a href="https://edk2.groups.io/g/devel/editsub/1813853">Your Subscription</a> | <a href="mailto:devel+owner@edk2.groups.io">Contact Group Owner</a> | <a href="https://edk2.groups.io/g/devel/unsub">Unsubscribe</a> [edk2-devel-archive@redhat.com] <div width="1" style="color:white;clear:both">_._,_._,_</div>