MATLAB Compiler

Verifying mbuild

There is C source code for an example ex1.c included in the <matlab>/extern/examples/cmath directory, where <matlab> represents the top-level directory where MATLAB is installed on your system. To verify that mbuild is properly configured on your system to create stand-alone applications, copy ex1.c to your local directory and type cd to change to that directory. Then, at the MATLAB prompt, enter

• mbuild ex1.c
  

This creates the file called ex1. Stand-alone applications created on UNIX systems do not have any extensions.

Locating Shared Libraries

Before you can run your stand-alone application, you must tell the system where the API and C shared libraries reside. This table provides the necessary UNIX commands depending on your system's architecture.

Architecture	Command
HP700/HP-UX	setenv SHLIB_PATH <matlab>/extern/lib/<arch>:$SHLIB_PATH
IBM RS/6000	setenv LIBPATH <matlab>/extern/lib/ibm_rs:$LIBPATH
All others	setenv LD_LIBRARY_PATH <matlab>/extern/lib/<arch>:$LD_LIBRARY_PATH
where:                      <matlab> is the MATLAB root directory                      <arch> is your architecture (i.e., alpha, hp700, hpux, lnx86, sgi, sgi64, or sol2)

It is convenient to place this command in a startup script such as ~/.cshrc. Then the system will be able to locate these shared libraries automatically, and you will not have to reissue the command at the start of each login session.

Note    On all UNIX platforms, the Compiler library is shipped as a shared object (.so) file or shared library (.sl). Any Compiler-generated, stand-alone application must be able to locate the C/C++ libraries along the library path environment variable (SHLIB_PATH, LIBPATH, or LD_LIBRARY_PATH) in order to be found and loaded. Consequently, to share a Compiler-generated, stand-alone application with another user, you must provide all of the required shared libraries. For more information about the required shared libraries for UNIX, see Packaging UNIX Applications.

Running Your Application

To launch your application, enter its name on the command line. For example:

• ex1
  ans =
   
       1     3     5
       2     4     6
   
   
  ans =
   
     1.0000 + 7.0000i   4.0000 +10.0000i
     2.0000 + 8.0000i   5.0000 +11.0000i
     3.0000 + 9.0000i   6.0000 +12.0000i
  

Preparing to Compile

Verifying the MATLAB Compiler