Lahey/Fujitsu Linux64 Fortran Express -- LF64 -- 3May06 Copyright (c) 2006, Lahey Computer Systems, Inc. Copyright (c) 2006, FUJITSU, LTD. Lahey/Fujitsu Linux64 Fortran Express Package --------------------------------------------- 1. Installing LF64 2. Product Activation 3. Minimum System Requirements 4. Using LF64 5. Verifying the installation 6. Documentation 7. Uninstalling LF64 8. Release Notes 9. New Features 10. Known Technical Issues 11. Year 2000 Issues ---------------------------------------------------------- 1. Installing LF64 The following steps will guide you through the installation process. 1) Download lf6480x.tar from the Lahey Computer Systems, Inc. web site. 2) Login to your Linux system as root. 3) Restore files from the archive lf6480x.tar. E.G. tar -xpf lf6480x.tar 4) Run ./install to install LF64. The default installation directory is /usr/local/lf6480, however, you can change it to a directory of your choice during the installation. 2. Product Activation Before using LF64, it must be activated. The activation process determines a unique hardware I.D. for the system and creates a text file, keyreq.txt, which must be delivered to Lahey Computer Systems, Inc. Along with activation instructions, keyreq.txt contains the MAC address of the systems network interface card, user name, company and serial number in a 64-digit encrypted key. The activation process can be completed during installation or can be started manually by running the activate script in /bin. cd /bin ./activate If the system is not connected to the Internet, answer no to the request to attempt an online activation. This will create the file keyreq.txt in /bin. The user will need to copy the 64-digit license key from keyreq.txt and paste it into the license key field at www.lahey.com/actlf64.asp. This process will be completed automatically on a system connected to the Internet if the user agrees to an online activation. Lahey will return the license file lflic.dat to the email address entered during the activation process. Save lflic.dat to /bin. The license file will limit operation of LF64 to the system on which keyreq.txt was created. Only the hardware ID and user information entered during the activation process will be delivered to Lahey Computer Systems, Inc. Registered users receive free technical support via fax and e-mail. If the user agrees, registration information will also be collected during the activation process. Registration can be completed at another time by running the register script in /bin. cd /bin ./register 3. Minimum System Requirements Operating System We support LF64 on the following Linux distributions: Distribution Kernel libc ------------------------------------------------- Red Hat Enterprise Linux AS v.4 2.6.9 2.3.4 Red Hat Enterprise Linux ES v.4 2.6.9 2.3.4 Fedora Core 4 (*) 2.6.14 2.3.5 SUSE Linux 10.0 2.6.13 2.3.5 ------------------------------------------------- (*) The latest patches should be applied. Please see our web site, www.lahey.com, for a complete list of tested and supported operating systems. Required Software and files: The LF64 installation assumes that "as" (the GNU assembler), and "ld" (the GNU linker), and crt1.o are available on the system. - /usr/bin/as - /usr/bin/ld - /lib64/ld-linux-x86-64.so.2 - /usr/lib64/crt1.o - /usr/lib64/crti.o - crtbegin.o - crtend.o ex: - Red Hat Enterprise Linux V4 /usr/lib/gcc/x86_64-redhat-linux/3.4.3/crtbegin.o - Fedora Core 4 /usr/lib/gcc/x86_64-redhat-linux/4.0.0/crtbegin.o - SUSE Linux 10.0 /usr/lib64/gcc/x86_64-suse-linux/4.0.2/crtbegin.o - /usr/lib64/crtn.o - libc - libm - libpthread - librt - libgcc_s, libgcc, libgcc_eh - libelf(*) If the f95 command outputs the error message "cannot find -lelf", install the libelf rpm package, such as elfutils-libelf-devel-0.97-5, from Linux installation CD. CPU Intel(R) EM64T, or AMD(R) AMD64 Hardware PC/AT compatible Disk 40MB Express Memory 32MB RAM X-Windows to view online PDF documentation 4. Using LF64 Environment variables The following environment variables must contain the information described for correct operation of LF64: PATH - (INSTALL DIRECTORY)/bin LD_LIBRARY_PATH - (INSTALL DIRECTORY)/lib An alternative to setting LD_LIBRARY_PATH is to add (INSTALL DIRECTORY)/lib to /etc/ld.so.conf and run /sbin/ldconfig. MANPATH - (INSTALL DIRECTORY)/manuals/man/lf64/ WISK - (INSTALL DIRECTORY)/ (PRO Edition only) Shell environment setup via bash_setup and/or csh_setup To use the LF64 products and view man pages, the shell environment variables must be updated with LF64 information. To accomplish this, two scripts have been created in LF64 installation directory. The script bash_setup is used to update the bash environment and the csh_setup script is used to update the csh environment. One of these scripts can be executed via the source command to set up the respective bash or csh environment. For example, the following command will update the environment variables of the csh shell: "source (INSTALL DIRECTORY)/csh_setup" Note, depending on your system you may need to execute bash_setup via the "." command for the settings to take effect. To update a shell environment automatically, this command can be added to the system login script(s). Note: The LF64 driver program (lfc) makes calls to the LF64 file f95 included in the bin directory of the LF64 installation. If another file with this name is available via the PATH environment variable before the LF64 version, the system will call it instead with unknown results. Lahey/Fujitsu Linux64 Fortran Compiler, LF64 To use LF64, type the following at the command prompt: lfc sourcefile (where sourcefile is the name of the file to compile) A symbolic link named lf95 has been created so that makefiles used with Lahey/Fujitsu LF95 can be used. Fujitsu Debugger, FDB To use the debugger type the following at the command prompt: fdb executable (where executable is the -g compiled program to debug) 5. Verifying the installation To verify that LF64 has been installed correctly, compile and run an example program. During the installation the example program, demo.f90, is installed in the (INSTALL DIRECTORY)/examples/fortran directory. From the command prompt, build the demo program by changing to the directory where demo.f90 is installed, and entering: lfc demo.f90 This causes the compiler to read and compile the source file demo.f90 and generates modules utilities_module.mod and constants_module.mod. The modules are then combined with the demo object file and the runtime libraries via the linker ld to form the executable file a.out. Run the demo program executable by typing its name at the command prompt preceded by ./ to reference the current directory: ./a.out The demo program will begin with the following header and menu: Lahey/Fujitsu Linux64 Fortran Compiler -------------------------------------- installation test and demonstration program Copyright(c) 2006 Lahey Computer Systems, Inc. ----------------- Test/Action List: ----------------- 1 - factorials 2 - Fahrenheit to Celsius conversion 3 - Carmichael numbers 4 - Ramanujan's series 5 - Stirling numbers of the 2nd kind 6 - chi-square quantiles 7 - Pythagorean triplets 8 - date_and_time, and other system calls 0 - Please select an option by entering the associated number followed by . By completing these steps you have verified the installation of LF64 and have successfully built and run the example program. 6. Documentation A PDF version of the LF64 User's Guide is installed as (INSTALL DIRECTORY)/manuals/usr_man.pdf. A man page for LF64 is also available. A PDF version of the LF64 Language Reference is installed as (INSTALL DIRECTORY)/manuals/langref.pdf. Man pages for many Fortran intrinsic functions are also available. PRO Edition only Automake An Automake man page is available as "am" and a resource compiler man page is available as "rc". Information is also included in the LF64 User's Guide. Wisk documentation is installed as (INSTALL DIRECTORY)/manuals/wisk_man.pdf. Additional help files are supplied in HTML format in (INSTALL DIRECTORY)/help/, accessible via the main index.htm file. To access the on-line help files from within WiSK's visual tools the WISK environment variable needs to be set to (INSTALL DIRECTORY)/. 7. Uninstalling LF64 To uninstall LF64, Login to your Linux system as root and run (INSTALL DIRECTORY)/uninstall. During the uninstall, you will be prompted to undo changes made by the installation to /etc/profile.local, /etc/bash.bashrc.local, /etc/csh.cshrc/local, or /etc/csh.login.local. Note, if user files have been added to the installation directories, they will not be removed by the uninstall program. The directories that contain these files will also not be removed and the uninstall program will state this. 8. Release Notes See BUGFIX for bug fix descriptions. 9. New Features New Features in LF64 v8.0 ========================= 10. Known Technical Issues The runtime is unable to trap numeric exceptions on the AMD(R) AMD64 processor. This means that --trap will have no effect. We hope to fix this in a future patch of the runtime. 11. Year 2000 Issues Lahey compilers include a 2-digit date subroutine called DATE() that returns the last two digits of the current system date. Changing the output of this subroutine to 4 digits would cause problems in existing code so this subroutine will not be revised (however, the compiler will issue a warning that DATE does not return 4-digit year value). If you have code that calls the DATE subroutine, and that code assumes that the century is 1900, you may be subject to "Year 2000" problems. LF64 includes the Fortran 95 Standard DATE_AND_TIME subroutine. DATE_AND_TIME returns a 4-digit date. We recommend changing all code that uses DATE to use DATE_AND_TIME instead.