<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=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
code
{mso-style-priority:99;
font-family:"Courier New";}
pre
{mso-style-priority:99;
mso-style-link:"HTML Preformatted Char";
margin:0in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri",sans-serif;
color:windowtext;}
span.HTMLPreformattedChar
{mso-style-name:"HTML Preformatted Char";
mso-style-priority:99;
mso-style-link:"HTML Preformatted";
font-family:"Courier New";}
.MsoChpDefault
{mso-style-type:export-only;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal">Hi Rui,<o:p></o:p></p>
<p class="MsoNormal">We meet a problem when enable the <b>execute in place</b> (XIP,
<a href="https://en.wikipedia.org/wiki/Execute_in_place">https://en.wikipedia.org/wiki/Execute_in_place</a>) for uefi firmware with lld-link. We need to set the COFF executable file SectionAlignment through the lld-link /ALIGN option, but we find the SectionAlignment
is hardcoded to 4096 which cause the /ALIGN option doesn’t work at all. Below is the hardcode in lld:<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Courier New"">lld\COFF\Writer.h<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Courier New""> static const int pageSize = 4096;<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Courier New"">lld\COFF\Writer.cpp<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Courier New""> pe->SectionAlignment = pageSize;<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The uefi firmware need to directly run in ROM device (in XIP way) before the system memory is ready. These XIP executable files are not loaded in memory and their section running alignment is just same as the alignment in file. With MSVC
link.exe, we can use the /ALIGN option to set SectionAlignment same as FileAlignment to ensure the XIP executable file has correct running alignment. But with lld-link, we cannot change the XIP file SectionAlignment value 4096 because it is hardcoded. So,
we have to change the FileAlignment to 4096 to match the SectionAlignment instead, but the big FileAlignment value (4096) cause the firmware XIP code size is +10 times larger than normal, which is not affordable for firmware.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Could we not hardcode the SectionAlignment as 4096 in COFF file and let the lld-link respect the user’s /ALIGN option value? We can set the 4096 as the default SectionAlignment value.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Below are some steps to show the hardcode issue and code size impact:<o:p></o:p></p>
<p class="MsoNormal">$ cat main.c<o:p></o:p></p>
<p class="MsoNormal">int main()<o:p></o:p></p>
<p class="MsoNormal">{<o:p></o:p></p>
<p class="MsoNormal"> return 0;<o:p></o:p></p>
<p class="MsoNormal">}<o:p></o:p></p>
<p class="MsoNormal">$ "/home/jshi19/llvm/llvm-project/releaseinstall/bin/clang" -target i686-unknown-windows -fno-builtin -c -o main.obj main.c<o:p></o:p></p>
<p class="MsoNormal">$ "/home/jshi19/llvm/llvm-project/releaseinstall/bin/lld-link" /OUT:main.dll /MACHINE:X86 /DLL /ENTRY:main /ALIGN:32 /FILEALIGN:32 main.obj<o:p></o:p></p>
<p class="MsoNormal">$ sudo apt install pev<o:p></o:p></p>
<p class="MsoNormal">$ readpe -H main.dll<o:p></o:p></p>
<p class="MsoNormal">…<o:p></o:p></p>
<p class="MsoNormal"> Alignment of sections: <span style="color:red">0x1000</span><o:p></o:p></p>
<p class="MsoNormal" style="text-indent:9.0pt">Alignment factor: 0x20<o:p></o:p></p>
<p class="MsoNormal">…<o:p></o:p></p>
<p class="MsoNormal">$ ll main.dll, see main.dll size is 544<o:p></o:p></p>
<p class="MsoNormal">-rwxrwxr-x 1 jshi19 jshi19 <span style="color:red">544 </span>
Aug 3 21:58 main.dll*<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">If have to change the FileAlignment to 4096 to match the SectionAlignment:<o:p></o:p></p>
<p class="MsoNormal">$ "/home/jshi19/llvm/llvm-project/releaseinstall/bin/lld-link" /OUT:main.dll /MACHINE:X86 /DLL /ENTRY:main /ALIGN:32 /FILEALIGN:<span style="color:red">4096
</span>main.obj<o:p></o:p></p>
<p class="MsoNormal">$ readpe -H main.dll<o:p></o:p></p>
<p class="MsoNormal">…<o:p></o:p></p>
<p class="MsoNormal"> Alignment of sections: <span style="color:red">0x1000</span><o:p></o:p></p>
<p class="MsoNormal" style="text-indent:9.0pt">Alignment factor: <span style="color:red">
0x1000</span><o:p></o:p></p>
<p class="MsoNormal">…<o:p></o:p></p>
<p class="MsoNormal">$ ll main.dll, see main.dll size is 8192 which ~15 timer larger.<o:p></o:p></p>
<p class="MsoNormal">-rwxrwxr-x 1 jshi19 jshi19 <span style="color:red">8192 </span>
Aug 3 22:05 main.dll*<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Thanks<o:p></o:p></p>
<p class="MsoNormal">Steven <o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</body>
</html>