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 $ ---------------------------------------------------------------------------