%% --------------------------------------------------------------  
%% (C)Copyright 2006,2007,                                         
%% International Business Machines Corporation                     
%% All Rights Reserved.                                            
%%                                                                 
%% Redistribution and use in source and binary forms, with or      
%% without modification, are permitted provided that the           
%% following conditions are met:                                   
%%                                                                 
%% - Redistributions of source code must retain the above copyright
%%   notice, this list of conditions and the following disclaimer. 
%%                                                                 
%% - Redistributions in binary form must reproduce the above       
%%   copyright notice, this list of conditions and the following   
%%   disclaimer in the documentation and/or other materials        
%%   provided with the distribution.                               
%%                                                                 
%% - Neither the name of IBM Corporation nor the names of its      
%%   contributors may be used to endorse or promote products       
%%   derived from this software without specific prior written     
%%   permission.                                                   
%%                                                                 
%% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND          
%% CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,     
%% INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF        
%% MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE        
%% DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR            
%% CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,    
%% SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT    
%% NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;    
%% LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)        
%% HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN       
%% CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR    
%% OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,  
%% EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.              
%% --------------------------------------------------------------  
%% PROLOG END TAG zYx                                              

Summary: Tutorial example - encrypted isolation-mode application

Target: Linux

Description:

	This simple isolation-mode example creates one SPE thread that
	prints a message, which included a constant from the data section
	of the program. The SPE thread program (spu/encrypted_spu.c)
	is encrypted (including the data section) using an encryption key
	generated by the spu-isolated-app tool. The spu-isolated-app tool
	then signs the encrypted SPE program with an application signing
	key, a private RSA key, provided by the user
	(../keystore/user_sign_key.pem) and attaches the signed digital
	certificate for the signing key (../keystore/user_signed_cert.pem)
	to the signed encrypted SPE program. The SPE program is embedded 
	into a PPE executable.

How to run:

	Invoke the PPE executable at the Linux command prompt:

	       iso_encrypted

Notes:
	This application takes approximately 30 seconds on a 3.0GHz Xeon
	processor when executing on the Full System Simulator with both
	PPU and SPU fast modes enabled.

