%% --------------------------------------------------------------  
%% (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: Emulated isolation mode sample code

Target: Linux

Description:

	This directory contains the source code for isolation applications.
	The samples include:

	iso_simple - A simple example for the emulated SPE isolation mode
		that prints the "Hello" message.

	iso_encrypted - An encrypted application example for the emulated
		SPE isolation mode that prints a simple message using
		data encrypted as part of the application.

	iso_enccopy - A simple example that utilizes the system memory
		as a secure shared buffer. The SPE application encrypts
		a plain text in the emulated isolated environment, and
		the cipher text to the system memory. It also shows
		'decrypt_in' usage where the SPE application copies the
		cipher text on the system memory into the isolated LS,
		and decrypts it in the isolated LS.

	iso_enccopy2 - An advanced example of iso_enccopy. This example
		deals with the replay attacks to associate a nonce with
		a plain text

	iso_fileio - A simple example that creates, reads, updates, and
		deletes files using either POSIX or C99 functions
		directly from an isolated spu.

How to run:

	See respective sample READMEs

Notes:
	If using the Full System Simulator, it may take a long time to
	execute these applications, because of the computation required
	for program validation and execution of the sample code. Please
	enable PPU fast mode and SPU fast mode for significantly improved
	response for these sample applications when using the simulator.

	To enable PPU fast mode, use the simulator command 'mysim fast on'
	or click on the "Mode" button in the simulator GUI and then click
	on "Fast Mode" in the pop-up window. This will enable the simulator
	LOOSE or TURBO mode.

	To enable SPU fast mode, click on the "SPU Modes" in the simulator
	GUI, and then click on the "Fast" button on the All BE:0 line in
	the pop-up window to enable fast mode for all of the SPU units.

