VERSION: R11
UNIX News for MATLAB
--------------------
Notation: $MATLAB is the MATLAB root directory path
--------
File: README.news
----
0. Table of Contents
-----------------
1. MATLAB directory structure changes
2. MATLAB executable now broken into shared library components
3. MathWorks now using R<number> for release name
4. MATLAB and Simulink icon bitmaps available for X Windows (X11)
5. Standalone license manager now available
6. Automatic segmentation violation stack trace and register
dump for sol2 and lnx86
7. OpenGL support
7.1 How to use the Version 3 Mesa libraries
8. Miscellaneous
8.1 Building mex without +DAportable on hp700
8.2 Configuring .matlab5rc.sh for port@host
1. MATLAB directory structure changes
----------------------------------
MATLAB 5.2 (R10) MATLAB 5.3 (R11)
---------- ----------
$MATLAB/app-defaults $MATLAB/X11/app-defaults
$MATLAB/ghostscript $MATLAB/sys/ghostscript
$MATLAB/sys/ARCH $MATLAB/sys/os/ARCH
Version 2 of the 'Mesa' Libraries for use with OpenGL
rendering in MATLAB are still located in
$MATLAB/opengl
while Version 3 libraries are located in
$MATLAB/sys/opengl
The default libraries are Version 2. To set Version 3
libraries to be the default see Section 7.1.
2. MATLAB executable now broken into shared library components
-----------------------------------------------------------
The following shared libraries are installed with, and
required by MATLAB. The shared library layout of MATLAB for
platform, ARCH, is as follows:
bin/ARCH/libmwhardcopy.<ext>
bin/ARCH/libmwhg.<ext>
bin/ARCH/libmwmpath.<ext>
bin/ARCH/libmwsimulink.<ext>
bin/ARCH/libmwuix.<ext>
bin/ARCH/libmwcompiler.<ext>
bin/ARCH/libmatlbmx.<ext>
bin/ARCH/libmwgui.<ext>
bin/ARCH/libmwnumerics.<ext>
bin/ARCH/matlab
<ext> is the shared library extension which varies with platform.
3. MathWorks now using R<number> for release name
----------------------------------------------
Each MathWorks product will now have an associated release
name with it. This is a string that starts with an 'R' followed
by a number. This is in addition to any version number.
The release name for this release is:
R11
4. MATLAB and Simulink icon bitmaps available for X Windows (X11)
--------------------------------------------------------------
Shipped in $MATLAB/X11/icons are X Window System (X11) icon
bitmaps for MATLAB and Simulink. You have a choice of either a 32,
48, or 64 pixel color icon or a 48 pixel black and white icon.
5. Standalone license manager now available
----------------------------------------
A standalone version of the license manager can now be installed
from the CD-ROM or FTP.
CD-ROM:
Using the MATLAB product disk carry out the MATLAB
CD-ROM installation procedure as discussed in the
MATLAB manual:
'Installation Guide for UNIX'.
with the following changes.
For step 5 create an installation directory for the
license manager not MATLAB. This directory is referred
to as $LM_ROOT.
For step 7 run the following CD-ROM install script
appropriate for your platform:
/cdrom/etc/install* (Sun, DEC, IBM, SGI, and
Linux platforms)
/cdrom/ETC/INSTALL* (HP platform)
Here we have assumed the mount point for the cdrom
as /cdrom. Change it to match your local environment.
Consult the output of 'df -k' to get the correct path.
Carry out the text based installation.
You can select any set of platform ARCH versions to
install where ARCH is sol2, hp700, alpha, ibm_rs,
sgi, sgi64, or lnx86 as long as you include the ARCH
of the host you are installing on.
Then skip to step 14.
Finish up with steps 14 and 15.
FTP:
The complete standalone license manager for platform
ARCH can be found in the file:
unix/lmgr/lmgr.ARCH
where ARCH is either sol2, hp700, alpha, ibm_rs, sgi,
sgi64, or lnx86.
To install this file use the MATLAB FTP installation
procedure as discussed in the MATLAB manual:
'Installation Guide for UNIX'.
with the following changes on a host that matches
platform ARCH.
For step 3 create an installation directory for the
license manager not MATLAB. This directory is referred
to as $LM_ROOT.
For step 5 change to the unix/lmgr directory instead of
the unix directory.
For step 6 download the file, lmgr.ARCH, and extract its
contents using,
tar -xvf lmgr.ARCH
and skip to step 9. Do not download or use boot.ftp.
For step 9 execute the license manager installation script:
install_lm
It is recommended that you use port@host when you use a
standalone license manager with MATLAB. For UNIX MATLAB edit
$MATLAB/bin/.matlab5rc.sh and follow the instructions about
port@host in the comments under each ARCH section.
6. Automatic segmentation violation stack trace and register dump
--------------------------------------------------------------
for sol2 and lnx86
------------------
If a segmentation violation occurs in MATLAB on either sol2 or
lnx86 there is automatic support now to produce a stack trace
and register dump. If you report such a problem to the MathWorks
please include this additional information.
Note that to see the symbols on lnx86 requires that the loader
package ld.so installed on your host be at least 1.9.7 or higher.
To get a newer version try:
ftp://tsx-11.mit.edu/pub/linux/packages/GCC
Here is sample output on sol2:
------------------------------------------------------------------------
MATLAB segmentation violation detected !!!
------------------------------------------------------------------------
Register State:
g0 = 00000000 o0 = 00000000 l0 = 41901087 i0 = 0015c8ec
g1 = 00130000 o1 = 00000000 l1 = 00027dc0 i1 = efffe240
g2 = efffd240 o2 = f0000000 l2 = 00027dc4 i2 = f0000000
g3 = ef2572ec o3 = f025cda0 l3 = 00000000 i3 = f025cda0
g4 = 0027443c o4 = 00000000 l4 = 00000002 i4 = 00000000
g5 = 00000000 o5 = 00000000 l5 = 00000002 i5 = 00000000
g6 = 00000000 sp = efffdea0 l6 = 00000007 fp = efffdf00
g7 = 00185e50 o7 = 00027dc8 l7 = fc0a7c08 i7 = 00026854
pc = 00027dcc psr = 41901086
Stack trace:
[0] matlab:fiPvFreeHeadDataPage(1427692, 0xefffe240, 0xf0000000,
0xf025cda0) + 12 bytes
[1] matlab:fiPkFgetsL2(1776856, 1792888, 1427692, 1776856)
+ 284 bytes
[2] matlab:fiPvFgets(1776856, 1427680, 1427692, 3) + 472 bytes
[3] matlab:fiFcn(0, 1776856, 8, 2) + 108 bytes
[4] matlab:fiFullFgetsFcn(0, 0xefffe240, 2, 0xefffe468) + 28 bytes
[5] matlab:psStackOp(26, 0xefffe240, 0, 0xefffe468) + 1632 bytes
[6] matlab:psInterPcode(26, 1433600, 1, 77) + 3096 bytes
[7] matlab:psParser(1440768, 1430528, 0xef152cac, 0) + 1088 bytes
[8] matlab:main(1, 0xeffff61c, 0xeffff624, 1425408) + 852 bytes
[9] matlab:_start(0, 0, 0, 0) + 220 bytes
Please report this problem to the MathWorks and include the
preceeding stack trace along with the following information:
1. MATLAB version number
2. Platform type, Operating System and Window System versions
3. Sample commands, M-files, or MEX-files that reproduce the error
4. Any other pertinent configuration information
Either E-mail the information to:
support@mathworks.com
or FAX this information to:
508-647-7201.
Try to save your workspace and quit.
Here is sample output on lnx86:
------------------------------------------------------------------------
MATLAB segmentation violation detected !!!
------------------------------------------------------------------------
Register State:
eax = 00000000 ebx = 40c0c2b0
ecx = 40c097f0 edx = 40c0c310
esi = 0811a124 edi = 0811a124
ebp = bfffe404 esp = bfffe3fc
eip = 08072acb flg = 00010297
Stack trace:
[0] matlab:fiPvFreeHeadDataPage(0x0811a124, 0x0811a124, 0x40c097f0, 3)
+ 11 bytes
[1] matlab:fiPkFgetsL2(0x40c0c2b0, 0x40c097f0, 0x0811a124, 2)
+ 589 bytes
[2] matlab:fiPvFgets(0x40c0c2b0, 0x0811a118, 0x0811a124, 0)
+ 412 bytes
[3] matlab:fiFcn(0, 0xbfffe614, 8, 2) + 81 bytes
[4] matlab:fiFullFgetsFcn(0, 0xbfffe614, 2, 0xbfffe6dc) + 36 bytes
[5] matlab:psStackOp(26, 2, 0, 0) + 1533 bytes
[6] matlab:psInterPcode(2, 0, 0x08174e88, 0x08174e88) + 3213 bytes
[7] matlab:psParser(0, 0x40006394, 0x08068d60, 1) + 921 bytes
[8] matlab:main(1, 0xbffff5e0, 0xbffff5e8, 0) + 555 bytes
[9] matlab:_start(0, 0xbffff714, 0, 0xbffff74c) + 94 bytes
Please report this problem to the MathWorks and include the
preceeding stack trace along with the following information:
1. MATLAB version number
2. Platform type, Operating System and Window System versions
3. Sample commands, M-files, or MEX-files that reproduce the error
4. Any other pertinent configuration information
Either E-mail the information to:
support@mathworks.com
or FAX this information to:
508-647-7201.
Try to save your workspace and quit.
7. OpenGL support
--------------
7.1 How to use Version 3 Mesa libraries
-----------------------------------
To use Version 3 of the 'Mesa' Libraries instead of
Version 2 edit the .matlab5rc.sh file.
Use the file, $MATLAB/bin/.matlab5rc.sh, if you intend
to make a change for all users. Edit a copy of that file
in either $HOME or a directory that you will start MATLAB
from if you intend to make a change for your use only.
Under the architecture section for sol2, hp700, alpha, or
lnx86 change the line:
LDPATH_SUFFIX='$MATLAB/opengl/lib/$ARCH'
to
LDPATH_SUFFIX='$MATLAB/sys/opengl/lib/$ARCH'
See Section 3.4 of the UNIX News for MATLAB 5.2 to see
how to configure the .matlab5rc.sh file so that the
'Mesa' libraries are used as the default OpenGL libraries.
8. Miscellaneous
-------------
8.1 Building mex without +DAportable on hp700
-----------------------------------------
MEX files shipped with MATLAB are compiled to be portable
across PA-RISC architectures. In the MEX option files,
bin/mexopts.sh
bin/cxxopts.sh
under the hp700 architecture section you can remove the
+DAportable option from the CFLAGS and FFLAGS definitions
if you wish to optimize just for your target machine.
8.2 Configuring .matlab5rc.sh for port@host
---------------------------------------
Under each architecture section replace the line
LM_LICENSE_FILE='$MATLAB/etc/license.dat'
by
LM_LICENSE_FILE='port@host'
where port and host are replaced by the values obtained
as follows:
port = The number at the end of SERVER line (like
1705) in the license file.
host = The string after SERVER on the SERVER line
in the license file.'
---------------------------------------------------------------------------
Copyright (c) 1998 by The MathWorks, Inc.
$Revision: 1.29 $ $Date: 1998/11/20 22:33:47 $
---------------------------------------------------------------------------