riscv
/
coriolis
mirror of https://gitlab.lip6.fr/vlsi-eda/coriolis.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
coriolis/lefdef/doc/lefapiWN/NewFeatures.html

482 lines
24 KiB
HTML
Raw Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN" "http://www.w3.org/MarkUp/Wilbur/HTML32.dtd">
<html xmlns="http://www.w3.org/MarkUp/Wilbur/HTML32.dtd">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<title>What's New in LEF 5.8 C/C++ Programming Interface -- 1</title>
<META NAME="Approver" CONTENT="Technical Publications">
<META NAME="Author" CONTENT="Technical Publications">
<META NAME="CreateDate" CONTENT="2017-04-12">
<META NAME="CreateTime" CONTENT="1491979922">
<META NAME="DataType" CONTENT="Release information">
<META NAME="Description" CONTENT="Describes new, changed, and removed features for the LEF API in version 5.8.">
<META NAME="DocTitle" CONTENT="What's New in LEF 5.8 C/C++ Programming Interface">
<META NAME="DocType" CONTENT="Release Note">
<META NAME="EdmsRelease" CONTENT="FM-Wiki-1.0_P005">
<META NAME="FileTitle" CONTENT="1">
<META NAME="FileType" CONTENT="Chapter">
<META NAME="Keyword" CONTENT="lefapiWN">
<META NAME="Language" CONTENT="English">
<META NAME="ModifiedDate" CONTENT="2017-04-12">
<META NAME="ModifiedTime" CONTENT="1491979922">
<META NAME="NextFile" CONTENT="ChangedFeatures.html">
<META NAME="PageCount" CONTENT="4">
<META NAME="Platform" CONTENT="ALL">
<META NAME="PrevFile" CONTENT="preface.html">
<META NAME="Product" CONTENT="Languages">
<META NAME="ProductFamily" CONTENT="Cadence Shared Tools">
<META NAME="ProductVersion" CONTENT="5.8">
<META NAME="RightsManagement" CONTENT="Copyright 2017 Cadence Design Systems Inc.">
<META NAME="Title" CONTENT="What's New in LEF 5.8 C/C++ Programming Interface -- 1">
<META NAME="TopicTags" CONTENT="FALSE">
<META NAME="Version" CONTENT="5.8">
</head>
<body style="margin-left: 5%;">
<a name="pagetop"></a>
<a name="firstpage"></a>
<!-- Begin Buttons -->
<table width="650" cellpadding="0" cellspacing="0" border="0">
<tr>
<td height="36" width="650" colspan="10">
<img src="images/header_doc.gif" width="650" height="34">
</td>
</tr>
<tr>
<td height="20" width="59">
<a href="javascript:openLibrary()"><img src="../support/nav2_library.gif" border="0" alt="View Library" height="20" width="59"></a>
</td>
<td height="20" width="73">
<a href="lefapiWNTOC.html"><img src="../support/nav2_toc.gif" alt="Table of Contents" border="0"></a>
</td>
<td height="20" width="46">
<img src="../support/nav2_index_b.gif" border="0">
</td>
<td>
<a href="preface.html"><img src="images/nav2_previous.gif" alt="Previous" border="0"></a>
</td>
<td>
<a href="ChangedFeatures.html"><img src="images/nav_next.gif" alt="Next" border="0"></a>
</td>
<td height="20">
<a>
<a href="lefapiWN.pdf"><img src="../support/nav2_print.gif" border="0" alt="Open PDF to print book" height="20" width="114"></a>
</a>
</td>
<td height="20" width="61">
<img src="../support/nav2_black.gif" border="0" height="20" width="76">
</td>
<td height="20" width="76">
<a href="/feedback.htm"><img src="../support/nav2_feedback.gif" border="0" alt="Email Comments" height="20" width="76"></a>
</td>
<td height="20" width="43">
<a href="../cdsuser/help.html"><img src="../support/nav2_help.gif" border="0" alt="Help Using Documentation" height="20" width="43"></a>
</td>
<td height="20" width="37">
<a href="/exitsearch.htm"><img src="../support/nav2_exit.gif" border="0" alt="Shut Down Cadence Documentation Server" height="20" width="37"></a>
</td>
</tr>
</table>
<!-- End Buttons -->
<p>
<hr>
<p>
<h3>
<center>
<font >
<div>What's New in LEF 5.8 C&#47;C++ Programming Interface </div>
<font >
<div></div>
</font>
</font>
</center>
</h3>
<br>
</p>
<div>
<h1>1<a name="1032955">&nbsp;</a></h1>
<h1><a name="1033512">New Features</a></h1>
<p><a name="1034303">This chapter describes the new features that were added in this release of the LEF application programming interface.</a></p>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a href="#1035522" title="1" name="1035495"><font color="Blue"><u>General LEF Reader Changes</u></font></a><a href="#1035522" title="1"> </a></td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a href="#1035571" title="1" name="1035614"><font color="Blue"><u>LEF Reader Setup and Control Routines</u></font></a><a href="#1035571" title="1"> </a></td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a href="#1035503" title="1" name="1035600"><font color="Blue"><u>LEF Reader Callback Routines</u></font></a><a href="#1035503" title="1"> </a></td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a href="#1036101" title="1" name="1036086"><font color="Blue"><u>LEF Reader Classes</u></font></a><a href="#1036101" title="1"> </a></td>
</tr>
</table>
</div>
<h2><a name="1035522">General LEF Reader Changes</a></h2>
<p><a name="1035523">The following changes were made in the latest version of the parser:</a></p>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a name="1035860"><strong>Elimination of static data</strong></a>: In the latest version, the parser architecture has changed from C style&#45;based to C++ style&#45;based. In the previous version of the parser, most of the parser data were stored in static variables and the data lifecycle was based on initializers and cleaners. The new architecture places data in data singletons and uses C++ constructors and destructors. The switch to the C++ architecture has improved the parser re&#45;enterability, made the data flow more robust, and helped clean multiple memory leaks in the parser code.</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a name="1035861"><strong>Introduction of parsing sesions</strong></a>: In the previous version, data were stored in static variables and, therefore, were retained across all parsing cycles. This meant that if a property was defined once, it continued to be defined in the next LEF file reads. In some applications, this feature was actively used. In others, it disturbed expected application behavior. To address this issue, the latest version of the parser introduces two modes of files processing &#45; compatibility mode and session&#45;based mode.</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.872">
<div>&nbsp;</div>
</td>
<td width="32.128319999999995">
<div>
<nobr>
<font color="#000000"><img src="images/bs_bullet_sub.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a name="1035528">Compatibility mode (session&#45;less mode) &#45; This mode is compatible with the old parser behavior. You can call the parser initialization once with </a><font size="2" face="'Courier New'" color="#000000">lefrInit()</font>, adjust parsing settings and initialize the parser callbacks any time. The properties in <font size="2" face="'Courier New'" color="#000000">PROPERTYDEFINITIONS</font> sections will be active in all subsequent file reads. </td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.872">
<div>&nbsp;</div>
</td>
<td width="32.128319999999995">
<div>
<nobr>
<font color="#000000"><img src="images/bs_bullet_sub.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a name="1035529">Session&#45;based mode &#45; This mode introduces the concept of a parsing session - the parser configuration settings will be active during the session time and will be cleaned on its end.The parsing session also controls </a><font size="2" face="'Courier New'" color="#000000">PROPERTYDEFINITIONS</font> data. Property definitions remain active throughout the parsing session time and are cleaned at the end of the session. The session&#45;based mode does not require calling callbacks and configuration unset functions &#45; all callbacks and properties will be set to defaults by <font size="2" face="'Courier New'" color="#000000">lefrClear()</font> or the next session <font size="2" face="'Courier New'" color="#000000">lefrInitSession()</font> call.</td>
</tr>
</table>
</div>
<blockquote><a name="1035530">By default, the LEF parser works in the compatibility mode. To activate the session&#45;based mode, you must use </a><font size="2" face="'Courier New'" color="#000000">lefrInitSession()</font> instead of <font size="2" face="'Courier New'" color="#000000">lefrInit()</font>. </blockquote>
<blockquote><font color="#000000"><strong>Note: </strong></font><a name="1035531">Currently, the compatibility mode is used for all old applications for which code has not been adjusted. The </a><font size="2" face="'Courier New'" color="#000000">lef2oa</font> and <font size="2" face="'Courier New'" color="#000000">def2oa</font> translators have adjusted to use the session&#45;based parsing mode.</blockquote>
<blockquote><a name="1035533">For more information, see </a><a href="../lefapi/ch1Intro.html#WorkingModes" target="external_window"><font color="#0000ff"><u>"LEF Reader Working Modes"</u></font></a> in the <font color="#000000"><em>LEF 5.8 C&#47;C++ Programming Interface (Open Licensing Program)</em></font>.</blockquote>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font>
</nobr>
</div>
</td>
<td><a name="1035569"><strong>Long DEF Files Support</strong></a>: In this version, the LEF line counter switched to 64&#45;bit integer type, making it possible to process files with more than two billion lines. </td>
</tr>
</table>
</div>
<h2><a name="1035571">LEF Reader Setup and Control Routines</a></h2>
<p><a name="1035572">The following reader setup and class routines were added in this release:</a></p>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch2LEFsetup.html#lefrInitSession" target="external_window" name="1035539"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrInitSession</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch2LEFsetup.html#lefrClear" target="external_window" name="1035541"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrClear</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch2LEFsetup.html#lefrRegisterLef58Type" target="external_window" name="1036056"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrRegisterLef58Type</u></font></a></u>
</td>
</tr>
</table>
</div>
<p><a name="1035545">For more information, see </a><a href="../lefapi/ch2LEFsetup.html" target="external_window"><font color="#0000ff"><u>"LEF Reader Setup and Control Routines"</u></font></a> in the <font color="#000000"><em>LEF 5.8 C&#47;C++ Programming Interface (Open Licensing Program)</em></font>.</p>
<h2><a name="1035503">LEF Reader Callback Routines</a></h2>
<p><a name="1035927">The following reader callback routines were added in this release:</a></p>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch3LEFcallback.html#lefrIntegerCbkFnType" target="external_window" name="1035929"><font color="#0000ff"><u>lefrFixedMaskCbk</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch3LEFcallback.html#lefrIntegerCbkFnType" target="external_window" name="1035931"><font color="#0000ff"><u>lefrMacroFixedMaskCbk</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch3LEFcallback.html#lefrMacroForeignCbkFnType" target="external_window" name="1035936"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrSetMacroForeignCbk</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch3LEFcallback.html#lefrMacroSiteCbkFnType" target="external_window" name="1035955"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrSetMacroSiteCbk</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch3LEFcallback.html#lefrMacroForeignCbkFnType" target="external_window" name="1035983"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrUnsetMacroForeignCbk</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch3LEFcallback.html#lefrMacroSiteCbkFnType" target="external_window" name="1036002"><font size="2" face="'Courier New'" color="#0000ff"><u>lefrUnsetMacroSiteCbk</u></font></a></u>
</td>
</tr>
</table>
</div>
<p><a name="1034776">For more information on reader callback routines, see </a><a href="../lefapi/ch3LEFcallback.html" target="external_window"><font color="#0000ff"><u>"LEF Reader Callback Routines"</u></font></a> in the <font color="#000000"><em>LEF 5.8 C&#47;C++ Programming Interface (Open Licensing Program)</em></font>.</p>
<h2><a name="1036101">LEF Reader Classes</a></h2>
<p><a name="1036114">The following LEF Reader classes were added in this release:</a></p>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch4LEFclasses.html#lefiMacroSite" target="external_window" name="1036155"><font size="2" face="'Courier New'" color="#0000ff"><u>lefiMacroSite</u></font></a></u>
</td>
</tr>
</table>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="3" summary="">
<tr valign="baseline">
<td width="31.999679999999998">
<div>
<nobr>
<u><font color="#000000"><img src="images/b_bullet.gif" alt="ParagraphBullet" border="0"></font></u>
</nobr>
</div>
</td>
<td>
<u><a href="../lefapi/ch4LEFclasses.html#lefiMacroForeign" target="external_window" name="1036121"><font size="2" face="'Courier New'" color="#0000ff"><u>lefiMacroForeign</u></font></a></u>
</td>
</tr>
</table>
</div>
<p><a name="1036093">For more information on reader classes, see </a><a href="../lefapi/ch4LEFclasses.html" target="external_window"><font color="#0000ff"><u>"LEF Reader Classes"</u></font></a> in the <font color="#000000"><em>LEF 5.8 C&#47;C++ Programming Interface (Open Licensing Program)</em></font>.</p>
</div>
<br>
<a href="#pagetop">Return to top of page</a>
<hr>
<hr align="left">
<div style="text-align: left;">
<!-- Begin Buttons -->
<table width="650" cellpadding="0" cellspacing="0" border="0">
<tr>
<td height="20" width="59">
<a href="javascript:openLibrary()"><img src="../support/nav2_library.gif" border="0" alt="View Library" height="20" width="59"></a>
</td>
<td height="20" width="73">
<a href="lefapiWNTOC.html"><img src="../support/nav2_toc.gif" alt="Table of Contents" border="0"></a>
</td>
<td height="20" width="46">
<img src="../support/nav2_index_b.gif" border="0">
</td>
<td>
<a href="preface.html"><img src="images/nav2_previous.gif" alt="Previous" border="0"></a>
</td>
<td>
<a href="ChangedFeatures.html"><img src="images/nav_next.gif" alt="Next" border="0"></a>
</td>
<td>
<a>
<a href="lefapiWN.pdf"><img src="../support/nav2_print.gif" border="0" alt="Open PDF to print book" height="20" width="114"></a>
</a>
</td>
<td height="20" width="61">
<img src="../support/nav2_black.gif" border="0" height="20" width="76">
</td>
<td height="20" width="76">
<a href="/feedback.htm"><img src="../support/nav2_feedback.gif" border="0" alt="Email Comments" height="20" width="76"></a>
</td>
<td height="20" width="43">
<a href="../cdsuser/help.html"><img src="../support/nav2_help.gif" border="0" alt="Help Using Documentation" height="20" width="43"></a>
</td>
<td height="20" width="37">
<a href="/exitsearch.htm"><img src="../support/nav2_exit.gif" border="0" alt="Shut Down Cadence Documentation Server" height="20" width="37"></a>
</td>
</tr>
</table>
<!-- End Buttons -->
</div>
<br>
<font size="-1" >
For support, see <a href="http://support.cadence.com" target="_blank">Cadence Online Support</a> service.</font>
<br>
<br>
<font size="-1" >
<font size="-1"><i>Copyright &#169; 2016, <a href ="http://www.cadence.com">Cadence Design Systems, Inc.</a></i></font>
</font>
<br>
<font size="-1" >
All rights reserved.</font>
<br>
<br>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink