miti
/
linux-sgx-trts-modified


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203
							<!-- HTML header for doxygen 1.8.10-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.11"/>
<title>Intel&reg; Enhanced Privacy ID SDK: What&#39;s Included in the SDK</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
  $(window).load(resizeHeight);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="epidstyle.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname"><a 
                            onclick="storeLink('index.html')"
                            id="projectlink" 
                            class="index.html" 
                            href="index.html">Intel&reg; Enhanced Privacy ID SDK</a>
&#160;<span id="projectnumber">3.0.0</span>
</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('SdkOverview.html','');});
</script>
<div id="doc-content">
<div class="header">
  <div class="headertitle">
<div class="title">What's Included in the SDK </div>  </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#SdkOverview_Components">SDK Components</a></li>
<li class="level1"><a href="#SdkOverview_Files">Filesystem Layout</a><ul><li class="level2"><a href="#SdkOverview_Files_SourceLayout">Source Layout</a></li>
<li class="level2"><a href="#SdkOverview_Files_InstallLayout">Install Layout</a></li>
</ul>
</li>
</ul>
</div>
<div class="textblock"><h1><a class="anchor" id="SdkOverview_Components"></a>
SDK Components</h1>
<p>The SDK is divided into logical components to separate responsibilities and create interfaces that you can re-implement using custom tools such as hardware accelerators.</p>
<div class="image">
<img src="sdk_block_diagram.png" alt="sdk_block_diagram.png"/>
</div>
<p><br />
 The Intel&reg; EPID SDK is divided into the following components:</p>
<p>Components in the SDK Core implement the features of Intel&reg; EPID.</p>
<table class="doxtable">
<tr>
<th>Component </th><th>Description  </th></tr>
<tr>
<td>member </td><td>Library containing APIs needed to implement a member </td></tr>
<tr>
<td>verifier </td><td>Library containing APIs needed to implement a verifier </td></tr>
<tr>
<td>common </td><td>Library containing common types and functions </td></tr>
<tr>
<td>math </td><td>Math primitives used by member and verifier </td></tr>
<tr>
<td>IPP </td><td>A C-only non-optimized subset of Intel&reg; IPP </td></tr>
</table>
<p><a class="el" href="Examples.html">Examples</a> show how to use the SDK APIs in working code.</p>
<table class="doxtable">
<tr>
<th>Component </th><th>Description  </th></tr>
<tr>
<td>signmsg </td><td>A sample program showing how to sign messages </td></tr>
<tr>
<td>verfifysig </td><td>A sample program showing how to verify signatures </td></tr>
<tr>
<td>util </td><td>Common utilities used by samples </td></tr>
<tr>
<td>Sample Issuer Material </td><td>Sample keys and revocation lists </td></tr>
</table>
<p>Tools implement utility code to interact with Intel&reg; EPID related services such as <a class="el" href="ChoosingiKGF.html">the Intel&reg; Key Generation</a>Facility (iKGF)".</p>
<table class="doxtable">
<tr>
<th>Component </th><th>Description  </th></tr>
<tr>
<td>extractgrps </td><td>A tool to extract groups from a bulk group file </td></tr>
<tr>
<td>extractkeys </td><td>A tool to extract member keys from a bulk key file </td></tr>
<tr>
<td>revokegrp </td><td>A tool to create a revocation request for a group </td></tr>
<tr>
<td>revokekey </td><td>A tool to create a revocation request for a member key </td></tr>
<tr>
<td>revokesig </td><td>A tool to create a revocation request from a signature </td></tr>
</table>
<p>The SDK comes with a number of other components that support building and validating the code.</p>
<table class="doxtable">
<tr>
<th>Component </th><th>Description  </th></tr>
<tr>
<td>gtest </td><td>gtest unit test framework </td></tr>
<tr>
<td>Build Scripts </td><td>Scripts to configure and build the SDK </td></tr>
</table>
<p>Math primitives are implemented in the <em>math</em> sub-component of <em>common</em>. The reference math primitive implementation is based on a non-optimized Vanilla C subset of the Intel&reg; Performance Primitives. <em>Math</em> is designed so that you can replace its implementation to call custom hardware IP blocks or optimized libraries.</p>
<h2>Intel&reg; EPID 1.1 Compatibility</h2>
<p>In addition to the default Intel&reg; EPID 2.0 APIs, the <em>verifier</em> component also includes APIs that allow verification of Intel&reg; EPID 1.1 signatures.</p>
<p>Billions of existing devices, including most Intel platforms manufactured since 2008, create signatures that need Intel&reg; EPID 1.1 verification.</p>
<p>For details on verifying Intel&reg; EPID 1.1 signatures see <a href="group___epid11_verifier_module.html#details"><b>EPID 1.1 support</b></a> in the API Reference.</p>
<h1><a class="anchor" id="SdkOverview_Files"></a>
Filesystem Layout</h1>
<p>The Intel&reg; EPID SDK has two filesystem layouts: the Source Layout and the Install Layout.</p>
<p>The Source Layout is what you find when you download the SDK and extract it to disk. This layout contains all of the files that you need to build the libraries, samples, tests, and data generated by the SDK.</p>
<p>The Install Layout is the layout of files under the <code>_install</code> folder after you build the SDK.</p>
<h2><a class="anchor" id="SdkOverview_Files_SourceLayout"></a>
Source Layout</h2>
<p>The Source Layout is used by the build scripts in the Intel&reg; EPID SDK to find components and files needed to create libraries and executables. </p><pre class="fragment">epid-sdk/
|__ LICENSE.txt             Distribution license
|__ NOTICE.txt              Legal notices
|__ README.md               Readme
|__ CHANGELOG.md            Change log
|__ SConstruct              Main build configuration
|
|__ doc/
|   |__ html/               HTML format documentation
|   |__ index.html          Entry point for HTML format documentation
|
|__ epid/
|   |__ common/             Source for Common
|   |__ common-testhelper/  Source for unit test helper common helpers
|   |__ member/             Source for Member
|   |__ verifier/           Source for Verifier
|
|__ example/
|   |__ data/               Binary data used for testing and tutorials
|   |__ compressed_data/    Compressed Member Key Binary data used for testing and tutorials
|   |__ signmsg/            Source for message signing example
|   |__ util/               Common utilities for examples
|   |__ verifysig/          Source for signature validation signing example
|
|__ ext/
|   |__ gtest/             Third party gtest library
|   |__ ipp/               IPP library
|
|__ parts-site/            Parts platform config scripts
|
|__ tools/
    |__ extractgrps/       Tool to extract groups
    |__ extractkeys/       Tool to extract keys
    |__ revokegrp/         Tool to create group revocation request
    |__ revokekey/         Tool to create a member key revocation request
    |__ revokesig/         Tool to create a signature based revocation
                           request
</pre><h2><a class="anchor" id="SdkOverview_Files_InstallLayout"></a>
Install Layout</h2>
<p>The Install Layout contains the data developers need to develop and build their applications using the Intel&reg; EPID SDK. Once built, the Install Layout has no dependency on the Source Layout, allowing developers to build the SDK once and reuse the built files in other locations or on other computers. </p><pre class="fragment">_install/
|__ epid-sdk/
    |__ include/            C include header files for the SDK
    |__ lib/
    |   |__ &lt;platform&gt;      Target specific static libraries for the SDK
    |
    |__example/             Sample applications and data
    |__test/                Unit test executables (if unit tests built)
    |__tools/               Tools</pre> </div></div><!-- contents -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.8.10-->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="footer">
      &copy; 2016 Intel Corporation
    </li>
  </ul>
</div>
</body>
</html>