MPEG4IP ISMACRYP READMESeptember, 2005This library, ismacryp, implementsthe ISMA encryption and authentication protocol defined in "ISMA 1.0 Encryptionand Authentication, Version 1.0" specification which is published on the ISMAweb site. This specification is referred to as Ismacryp in the remainder ofthis README.Certain portions of the protocol are not implemented: selectiveencryption which allows for the encryption of selected streaming packets andalternating keys.The ismacryp lib utilizes a separate library, srtplib, forAES Integer Counter Mode encryption functions. The srtplib is not included inthe mpeg4ip distribution. However, the ismacryp library implemented here willstill operate correctly in the absence of the srtplib. All new mp4 atoms andheaders in the case of streamed files are included in an Ismacryp file but thedata will not be encrypted. The player will properly decode and play Ismacrypfiles or streams that are created without the encryption functions provided bysrtplib.To build and install mpeg4ip without srtplib, pass --disable-srtp toconfigure or bootstrap.To build and install mpeg4ip with srtplib, perform thefollowing steps.   1. Obtain the libsrtp package version 1.3.22 or later fromthe Sourceforge site (not available as of 2005/9/9).   2. Configure libsrtpwith the generic option to remove srtp-specific limitations by changing the AESICM functions. Then build and install the srtplib libraries.      % configure--enable-generic      % make      % make install By default libsrtp willinstall its libraries and header files in /usr/local/lib and/usr/local/include/srtp respectively. mpeg4ip will look for both insystem-defined library and include paths. If it finds them it willautomatically include them in the build unless --disable-srtp is passed toconfigure.Prior to using Ismacryp functions, it necessary to provide a keyfile. The key file must be named .kms_data and a sample is included in thisdirectory. This file must be placed in the home directory of the user runningthe mpeg4ip application.Using Ismacryp functions (see the other projectREADME files for more detailed information):   1. To create an Ismacryp mp4file: mp4creator -encrypt <filename>. A new file named <enc-filename> will becreated.   2. To play an Ismacryp file locally: use mp4player or gmp4player inthe usual way.   3. To stream an Ismacryp file: create hint tracks and usemp4creator in the usual way.Functions provided by ismacryplib are describedin ismacryp.halexv@cisco.comwill_clark@cisco.com