Software Product Description ___________________________________________________________________ PRODUCT NAME: DECmigrate Version 1.2 for DEC OSF/1 AXP Systems SPD 39.45.02 DESCRIPTION DECmigrate for DEC OSF/1[R] AXP Systems is a program that moves ex- isting ULTRIX RISC applications to DEC OSF/1 AXP systems by translat- ing ULTRIX RISC executables to DEC OSF/1 AXP executables, subject to limitations defined in Section 2. DECmigrate for DEC OSF/1 AXP Systems operates much like a compiler, except that the input file is an ULTRIX RISC binary executable file, and the output file is a DEC OSF/1 AXP binary executable file. The out- put file from DECmigrate contains optimized Alpha AXP code, not in- terpreted or emulated code. Translation is completed in a single pass, without requiring the user to understand the internals of the executable or interact with DECmi- grate during the translation process. A translated executable on a DEC OSF/1 AXP system usually performs much better than the original ex- ecutable. If the user enables the automatic feedback capability, DECmigrate can detect more opportunities for optimization at run time. If such op- portunities are detected, then performance of the translated executable can be improved by successive translations. Successive translations are always optional. DECmigrate for DEC OSF/1 AXP Systems provides a run-time environment that supports the execution of translated executables that use 32-bit pointers and 32-bit-long integers. DIGITAL March 1994 DECmigrate Version 1.2 for DEC OSF/1 AXP Systems SPD 39.45.02 Run-time support for translated executables is bundled with the DEC OSF/1 AXP system, making it possible for software developers to dis- tribute translated versions of their software products to customers who have DEC OSF/1 AXP systems, whether or not those customers have purchased DECmigrate. CRITERIA DECmigrate cannot generate a working executable when the original ex- ecutable: o Does not run correctly on an ULTRIX RISC system o Uses privileged opcodes or SYSCALLs (simple SYSCALLs that only need root privileges are allowed) o Uses some SYSCALLs that are unsupported on DEC OSF/1 (this is al- most never a problem) o Reads /dev/mem or /dev/kmem o Relies on the ULTRIX file system hierarchy o Relies on the ULTRIX system file formats o Contains MIPS[TM] R4000 or R6000 extended instructions o Relies on the value of the program counter or the presence of spe- cific MIPS instructions o Was compiled on any system other than a DECsystem or DECstation run- ning ULTRIX Version 4.0 or later DECmigrate for DEC OSF/1 AXP does not support: o Multiprocessor safe code o Interoperability with DEC OSF/1 AXP system shared libraries o Certain cases of precise exception behavior A complete list of exceptions is provided in the Release Notes for this version of the product. 2 DECmigrate Version 1.2 for DEC OSF/1 AXP Systems SPD 39.45.02 CONFORMANCE TO STANDARDS For this product, there is no business need for standards conformance. HARDWARE REQUIREMENTS Processors Supported Alpha AXP: DEC 3000 Model 300 AXP Workstation, DEC 3000 Model 300 AXP Server DEC 3000 Model 400 AXP Workstation DEC 3000 Model 400 AXP Server DEC 3000 Model 500 AXP Workstation DEC 3000 Model 500 AXP Server DEC 3000 Model 600 AXP Workstation DEC 3000 Model 600 AXP Server DEC 3000 Model 800 AXP Workstation DEC 3000 Model 800 AXP Server DEC 4000 Model 610 AXP System DEC 7000 Model 610 AXP System DEC 10000 Model 610 AXP System Disk Space Requirements: Disk space required for installation: 4.6 Mb Disk space required for use (permanent): 4.6 Mb Note: These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. 3 DECmigrate Version 1.2 for DEC OSF/1 AXP Systems SPD 39.45.02 In addition to the space required to install DECmigrate, you will need free disk space to perform translations. The mx translator (installation subset DMGOSF120) uses a considerable amount of virtual memory during translation. To translate an executable of size n, mx uses up to 20n bytes of virtual memory. Users should con- figure swap space on their system to handle this virtual memory re- quirement. While sufficient swap space is necessary for translating large exe- cutables, the time taken to translate also depends on the system phys- ical memory and system load. In addition to the memory requirements for the run-time environment on AXP systems (installation subset DMGMXR120), the memory require- ments for translated executables vary with the executable being run. Running a translated executable requires an amount of virtual memory equal to the virtual memory used by the original executable, plus mem- ory for the translated code and mxr. As a rule, the required virtual memory for the translated executable is calculated as the virtual mem- ory requirements for the original executable plus 1.4 times the size of the original executable's text section to the virtual memory. SOFTWARE REQUIREMENTS DEC OSF/1[R] AXP Operating System, Version 2.0 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. 4 DECmigrate Version 1.2 for DEC OSF/1 AXP Systems SPD 39.45.02 DISTRIBUTION MEDIA CD-ROM This product is available as part of the DEC OSF/1[R] Consolidated Soft- ware Distribution on CD-ROM. It is also sold separately. The software documentation for this product is available as part of the DEC OSF/1[R] Online Documentation Library on CD-ROM. It is also sold separately. ORDERING INFORMATION Software Licenses: QL-MWNA*-** Software Media/Documentation: QA-054AA-H8 Software Documentation: QA-MWNA*-GZ Software Product Services: QT-MWNA*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. SOFTWARE LICENSING This software is furnished only under a license. For more information about Digital's licensing terms and policies, contact your local Dig- ital office. License Management Facility Support: This layered product supports the License Management Facility. License units for this product are allocated on an Unlimited System Use basis. For more information on the License Management Facility, refer to the DEC OSF/1[R] AXP Operating System Software Product Description (SPD 41.87.xx) or the DEC OSF/1[R] AXP Operating System documentation. 5 DECmigrate Version 1.2 for DEC OSF/1 AXP Systems SPD 39.45.02 SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more in- formation, contact your local Digital office. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the pur- chase of a license for the product. The above information is valid at time of release. Please contact your local Digital office for the most up-to-date information. © 1994 Digital Equipment Corporation. All rights reserved. [R] OSF/1 is a registered trademark of Open Software Foundation, Inc. [TM]MIPS is a trademark of MIPS Computer Systems, Inc. [TM]The DIGITAL Logo, Alpha AXP, AXP, CI, DEC, DECstation, DEC- system, DECwindows, and Digital are trademarks of Digital Equipment Corporation. All other trademarks and registered trademarks are the property of their respective owners. 6