MATLAB Compiler

UNIX Workstation

This section examines the system requirements, installation procedures, and configuration procedures for the MATLAB Compiler on UNIX systems.

System Requirements

You cannot install the MATLAB Compiler unless MATLAB 6.5 (Release 13) is already installed on the system. The MATLAB Compiler imposes no operating system or memory requirements beyond those that are necessary to run MATLAB. The MATLAB Compiler consumes a small amount of disk space.

Table 2-1, Requirements for Creating UNIX Applications, shows the requirements for creating UNIX applications with the MATLAB Compiler.

Table 2-1: Requirements for Creating UNIX Applications

To create...	You need...
MEX-files	ANSI C compiler MATLAB Compiler
Stand-alone C applications	ANSI C compiler MATLAB Compiler
Stand-alone C++ applications	C++ compiler MATLAB Compiler

Note    Although the MATLAB Compiler supports the creation of stand-alone C++ applications, it does not support the creation of C++ MEX-files.

Supported ANSI C and C++ UNIX Compilers

The MATLAB Compiler supports

• The GNU C compiler, gcc, (except on HP and SGI64)
• The system's native ANSI C compiler on all UNIX platforms
• The system's native C++ compiler on all UNIX platforms (except Linux)
• The GNU C++ compiler, g++, on Linux.

Note    For a list of all the compilers supported by MATLAB, see the MathWorks Technical Support Department's Technical Notes at     http://www.mathworks.com/support/tech-notes/1600/1601.shtml

Known Compiler Limitations.   There are several known restrictions regarding the use of supported compilers:

• The SGI C compiler does not handle denormalized floating-point values correctly. Denormalized floating-point numbers are numbers that are greater than 0 and less than the value of DBL_MIN in the compiler's float.h file.
• Due to a limitation of the GNU C++ compiler (g++) on Linux, try...catch...end blocks do not work.
• The -A debugline:on option does not work on the GNU C++ compiler (g++) on Linux because it uses try...catch...end.
• Some UNIX compilers produce warnings that suggest additional optimizations can be performed that might result in faster code. For example, on IBM RS/6000 systems you may see a warning message similar to

• 1500-030: (I) INFORMATION: Miofun_private_imgifinfo: Additional 
  optimization may be attained by recompiling and specifying MAXMEM 
  option with a value greater than 2048.
  

• See your vendor compiler documentation for more information on how to improve optimization. Normally, this involves changing compiler options. Use CFLAGS= in your mbuildopts file.

Note    This compiler warning is benign and will have no harmful effect on your code.

Compiler Options Files

The MathWorks provides options files for every supported C or C++ compiler. These files contain the necessary flags and settings for the compiler. This table shows the preconfigured options files that are included with MATLAB for UNIX.

Compiler	Options File
System native ANSI compiler	mexopts.sh
gcc (GNU C compiler)	gccopts.sh

Information on the options files is provided for those users who may need to modify them to suit their own needs. Many users never have to be concerned with the inner workings of the options files.

Locating Options Files

To locate your options file, the mex script searches the following:

• The current directory
• $HOME/.matlab/R13
• <matlab>/bin

mex uses the first occurrence of the options file it finds. If no options file is found, mex displays an error message.

System Configuration for MEX-Files

Installation