📄 readme.htm
字号:
<HTML><HEAD><TITLE>Intel® Integrated Performance Primitives Sample Readme</TITLE>
<META http-equiv=Content-Type content="text/html; charset=iso-8859-1">
<META content="Microsoft FrontPage 6.0" name=GENERATOR>
<style>
<!--
DIV.Section1 {
page: Section1
}
-->
</style>
</HEAD>
<BODY text=#000000 bgColor=#ffffff>
<CENTER>
<H1><B><I><span lang="en-us">Intel<sup>®</sup> </span>Integrated Performance Primitives<BR>
Crypt File
Sample for Linux*</I></B></H1></CENTER>
<H5><A
href="#Disclaimer">Disclaimer</A><BR><A
href="#License_Definitions">License
Definitions</A><BR><A
href="#Overview">Overview</A><BR><A
href="#System_Requirements">System
Requirements</A><BR><A
href="#Package_Contents">Package
Contents</A> <BR><A
href="#Installation">Installation</A>
<BR><A
href="#How_to_Build_Source_Code">How
to Build Source Code</A><BR><A
href="#Running_the_Software">Running
the Software</A><BR><A
href="#Known_Limitations">Known
Limitations</A><BR><A
href="#Support">Technical Support
and Feedback</A><BR> </H5>
<H2><A name=Disclaimer></A>Disclaimer</H2>
<P class=MsoNormal style="mso-layout-grid-align: none"><SPAN
style="FONT-SIZE: 10pt; COLOR: windowtext; mso-bidi-font-size: 7.5pt">INFORMATION
IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL<sup>®</sup> PRODUCTS. NO
LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL
PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS
AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER,
AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE
OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A
PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR
OTHER INTELLECTUAL PROPERTY RIGHT. </SPAN></P>
<P>Intel products are not intended for use in medical, life saving, life
sustaining, critical control or safety systems, or in nuclear facility
applications. Intel may make changes to specifications and product descriptions
at anytime, without notice.</P>
<H2><A name=License_Definitions></A>License Definitions</H2>
<P>By downloading and installing this sample, you hereby agree that the
accompanying Materials are being provided to you under the terms and conditions
of the End User License Agreement for the Intel<sup>®</sup> Integrated
Performance Primitives product previously accepted by you. Please refer to the
file <b>ipplic.htm</b> for more information.</P>
<H2><A name=Overview></A>Overview</H2>
<p>This sample demonstrates how to use the Intel<sup>®</sup> Integrated Performance
Primitives (Intel<sup>®</sup> IPP)
and OCF to encode/decode any file. The sample contains implementation of
encode/decode operations for arbitrary length data stream of different
block ciphers. </p>
<P>Additional information on this software as well as other Intel<sup>®</sup>
Software Development Products is available at <A
href="http://developer.intel.com/software/products/">http://developer.intel.com/software/products/</A>.
<H2><A name=System_Requirements></A>System Requirements</H2><FONT
size=-1><B>Recommended hardware:</B> </FONT>
<UL>
<LI>A system based on the Intel<sup>®</sup> IXP425 Network Processor
<LI>A system based on the Intel<sup>®</sup> IXP465 Network Processor
</UL>
<p><FONT size=-1><B>Software requirements: </B></FONT>
</p>
<UL>
<LI>Intel<sup>®</sup> IPP 5.0 for IXP Linux*, or later
<LI>MontaVista* Linux* 3.1 Pro BE, kernel 2.4.20
<LI>Intel<sup>®</sup> IXP400 Software is available at <a href="http://www.intel.com/design/network/products/npfamily/download_ixp400.htm"> http://www.intel.com/design/network/products/npfamily/download_ixp400.htm</a>
</UL>
<H2><A name=Package_Contents></A>Package Contents</H2>This <b> Sample</b>
package contains the following:<table id="AutoNumber1" style="BORDER-COLLAPSE: collapse" borderColor="#111111" height="219" cellSpacing="0" cellPadding="0" width="100%" border="1">
<tr>
<td width="100%" bgColor="#cccccc" colSpan="2" height="19"><b>./ipp_sample/crypto/</b></td>
</tr>
<tr>
<td width="50%" height="19"> readme.htm </td>
<td width="50%" height="19"> This file </td>
</tr>
<tr>
<td width="50%" height="19"> Makefile, buildixp_be.sh, linux_kernel.sh </td>
<td width="50%" height="19"> Make files and build configuration files </td>
</tr>
<tr>
<td width="50%" height="19"> ipplic.htm </td>
<td width="50%" height="19"> End User License Agreement </td>
</tr>
<tr>
<td width="50%" height="19"> support.txt </td>
<td width="50%" height="19"> Contains information for technical support </td>
</tr>
<tr>
<td width="100%" bgColor="#cccccc" colSpan="2" height="19"><b>./ipp_sample/crypto/src/</b></td>
</tr>
<tr>
<td width="50%" height="19">cipherdefs.h, cipherdefs.c,<br>
ocfcp.h, ocfcp.c,<br>
cipher.h, cipher.cpp, ipp_cipher_des.h, ipp_cipher_des.cpp,
ipp_cipher_arc4.h, ipp_cipher_arc4.cpp, ipp_cipher_blf.h, ipp_cipher_blf.cpp,
ipp_cipher_rij.h, ipp_cipher_rij.cpp, ipp_cipher_twf.h, ipp_cipher_twf.cpp,
ocf_cipher.h, ocf_cipher.cpp,<br>
crypt_file.cpp</td>
<td width="50%" height="19">Source files</td>
</tr>
</table>
<H2><A name=Installation></A>Installation</H2>
<p>Extract all files in l_ipp-sample-crypto_*.tgz to a desired folder. Please make
sure to preserve the directory structure. The files for this sample will be
found in the ./ipp_sample/crypto folder.</p>
<H2><A name=How_to_Build_Source_Code></A>How to Build Source Code</H2>
<p>Before building, please check if your IPPROOT environment variable exists and
points to correct IPP v5.0 installation folder or IPP installed in default path,
like /opt/intel/ipp/5.0/. Make sure that environment variable, named
linuxbe_KERNEL_DIR, exist and points to the path contained /crypto/ocf/cryptodev.h
header.
To build this sample you need invoke script:</p>
<ul>
<li>buildixp_be.sh to build sample for IXP4xx BE architecture</li>
</ul>
<H2><A name=Running_the_Software></A>Running the Software</H2>
<P>To crypt or decrypt file content use the following command line:<P>crypt_file
[options] input_filename<P>where <b>options</b> are following:<ul>
<li>-d{<i>ENCRYPT|DECRYPT</i>} desired operation ENCRYPT
or DECRYPT</li>
<li>-c{<i>DES|TDES|AES|RIJ128|RIJ192|RIJ256|BLF|TWF</i>}
desired symmetric cipher: DES, tripple DES, variant of Rijndael, Blowfish or
Twofish cipher</li>
<li>-m{<i>ECB|CBC|CFB|CTR</i>} desired mode of cipher:
Electronic Code Book (ECB), Cipher Block Chain (CBC), Cipher Feedback (CFB)
or Counter (CTR)</li>
<li>-k<i>SECRET_KEY_STRING</i> secret key; the octet<i>
SECRET_KEY_STRING</i> string specifies key to be applied for cipher
operation; the size of <i>
SECRET_KEY_STRING</i> is limited by 32 octets</li>
<li>-iv<i>INIT_VECTOR_STRING</i> optional initialization
vector; the octet <i>INIT_VECTOR_STRING</i> specifies vector to be used for cipher
operation; the size of <i>INIT_VECTOR_STRING</i> is limited by 32 octets</li>
<li>-p<i>N</i> optional numeric parameter <i>N</i> using
for CFB and CTR modes.</li>
<li>-sw specifies software (IPP) implementation of the
cipher</li>
<li>-hw specifies hardware (OCF) implementation of the
cipher, if possible</li>
<li>-o<i>filename</i> output file name</li>
</ul>
<H2><A name=Known_Limitations></A>Known Limitations</H2>
<p> </p>
<H2><A name=Support></A>Technical Support and Feedback</H2>
<p>Your feedback on the Intel IPP samples is very important to us and your input
will be considered for future releases. The Intel IPP sample code is intended
only as an example of how to use the APIs to implement algorithms in different
development environments. Please submit problems with installation, compiling,
linking, runtime errors or incorrect output to
<a href="https://premier.intel.com/">Intel<sup>®</sup> Premier Support</a>. </p>
<p>You can also share and discuss the experience of IPP sample usage with other
developers at <a href="http://softwareforums.intel.com/ids">Intel Software
Developer Forum</a>.
<FONT
size=-2>
</p>
<p>Intel, the Intel logo, Intel SpeedStep, Intel NetBurst, Intel NetStructure,
MMX, i386, i486, Intel386, Intel486, Intel740, IntelDX2, IntelDX4,
IntelSX2,Celeron, Intel Centrino, Intel Xeon, Intel XScale, Itanium, Pentium,
Pentium II Xeon, Pentium III Xeon, Pentium M, and VTune are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United
States and other countries. </p>
<p>* Other names and brands may be claimed as the property of others. <br>
<br>
Copyright ⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -