Software Product Description PRODUCT NAME: Compaq FUSE Version 4.2 for Tru64 UNIX SPD 44.71.09 December 1999 DESCRIPTION Compaq FUSE Version 4.2 for Tru64 UNIX Systems This Software Product Description (SPD) describes the following prod- ucts: o Compaq FUSE Version 4.2 for Tru64 UNIX Systems[1] o Compaq FUSE C++ Support Version 4.2 for Tru64 UNIX Systems Compaq FUSE Version 4.2 runs on Compaq Tru64 UNIX[2] Version 4.0D or higher systems. Compaq FUSE for Tru64 UNIX Systems Compaq FUSE is an integrated set of tools that provides a seamless vi- sual environment for developing applications on Tru64 UNIX Alpha plat- forms. It helps programmers browse, edit, build, debug, and tune ap- plications. For programmers new to UNIX, point-and-click features of Compaq FUSE speed work by letting you quickly take advantage of UNIX software de- velopment utilities. For experienced UNIX programmers, Compaq FUSE in- tegrates traditional and familiar UNIX software development tools with a Motif[R]-based graphical user interface (GUI) across the complete Compaq FUSE environment. The overall result is improved productivity for all Compaq FUSE users. Application development with Compaq FUSE requires no conversion, fil- tering, or any other special preparation of Tru64 UNIX applications. Compaq FUSE is an excellent tool for both new system development and system maintenance. The dynamic, mouse-sensitive, graphical environ- ment greatly speeds the gathering of information about application source code, simplifies the gathering of application performance character- istics, and streamlines problem identification and program navigation. ____________________ Throughout this SPD, Compaq FUSE denotes Compaq FUSE Version 4.2 for Tru64 UNIX Systems. Compaq Tru64 UNIX is an X/Open 95 branded product. 1-December-1999 Compaq FUSE provides full language support for Compaq's C++, C, and Fortran compilers (includes both F77 and Fortran 90 features). Com- paq FUSE Version 4.2 provides general language support for Compaq Ada, Compaq COBOL, and Compaq Pascal. Compaq FUSE V4.2 is a prerequisite for the following optional product: o Compaq FUSE C++ Support Version 4.2 for Tru64 UNIX Systems Compaq FUSE fully supports the American English and Japanese locales. For additional information, refer to the Software Requirements, Op- tional Software and Ordering Information sections of this SPD. Components of the Compaq FUSE Environment Compaq FUSE V4.2 offers an integrated suite of tools that feature the following capabilities: CDE Integration: Compaq FUSE is integrated with the Common Desktop En- vironment (CDE). Users can launch tools from the CDE Application Man- ager, adjust colors and fonts from the CDE Style Manager, and build, compile, edit, check-in, check-out, and cancel-lock from the CDE File Manager. Control Panel: The Control Panel is a central point for starting or stopping Compaq FUSE tools and controlling a Compaq FUSE session. The Control Panel also saves and recalls information about a project (which contains a group of tools) to maintain a work context. Compaq FUSE also allows users to invoke Compaq FUSE tools from the shell command line. Editors: The FUSE Editor has a Motif-based interface and is tightly integrated into the Compaq FUSE environment. This tight integration allows other tools to invoke the editor within context. For example, clicking on a function name or error message in the Builder or Call Graph Browser brings up the corresponding source lines in the editor display. The Emacs and vi editors are integrated in a similar way within the Compaq FUSE environment. 2 Builder: The Builder provides a Motif-based interface to the UNIX make and gnumake utilities, which allows programmers to start and control program builds and includes the ability to distribute a build across a local area network (LAN). The Builder can use existing makefiles or create new ones. It graph- ically displays the module dependencies, showing which modules are out of date through color coding. Integration between the editors and the Builder speeds error correction. In addition to make(1u) (a SYSTEM V make derivative), and GNU make, the Compaq FUSE V4.2 Builder supports the enhanced XPG4/POSIX compli- ant make(1p) version of make, plus the ability to specify other build commands. The Builder can also generate simple makefiles for programs that use KAP for Fortran or KAP for C. KAP is an automatic code restructuring tool for optimization and automatic parallel decomposition of compu- tationally intensive codes. (See SPD 45.72.xx for KAP Fortran Opti- mizers for Compaq Tru64 UNIX and SPD 45.73.xx for KAP for C.) To assist in resolving linker warnings, the Builder lets you search for functions in system libraries. Debugger: The Debugger provides a Motif-based interface to the lade- bug Debugger. For detailed information on ladebug, see the Develop- ers' Toolkit for Compaq Tru64 UNIX V4.0D or higher, SPD 44.36.xx. The Debugger displays source code, the call stack, local variables, monitored expressions, registers, and instructions. Data views can be expanded to show their contents or to follow pointers, and an I/O win- dow is provided for application terminal I/O. Users can customize the interface by creating additional buttons for commands they use frequently. Commands can be invoked by choosing menu items, clicking on a button, or by entering commands in the command window. The Debugger controls multiple processes and multiple threads from a single user interface. 3 Code Manager: The Code Manager provides source code control to sup- port programming work groups with a Motif-based interface to either SCCS (Source Code Control System) or RCS (Revision Control System). Integration with the Compaq FUSE Editor lets you check-in and check- out files from the editor. Version Controller: The Version Controller lets you use many commer- cially available and in-house code library managers by providing di- alog box interfaces to common commands (for example, check-in/out). Users can tailor these commands to suit their needs. Through the Ver- sion Controller, the functions of the code library managers become avail- able in the Compaq FUSE Editor and CDE. Compare and Merge: The Compare tool provides a graphical user inter- face to the UNIX diff utility. Through integration with the Code Man- ager, differences between SCCS or RCS revisions as well as files are displayed graphically and in context. The Compare tool also lets you interactively merge two sets of changes made to the same file. It can be invoked from the Code Manager to merge revisions. You can make edits to the merge result in the output dis- play window while stepping through changes. Search: The Search tool provides a graphical user interface to the stan- dard UNIX utilities grep, fgrep, and egrep. The Search tool searches files or directories of files for a regular expression or string. The integration between Search and supported Compaq FUSE editors allows users to perform a search and then load a file containing matches. The Search tool also lets you replace text across multiple files. Profiler: The Profiler provides a Motif-based interface for pixie, prof, and gprof. The Profiler gathers and analyzes run-time statistics on your program, such as performance and resource use information. This information is displayed in text format or as a histogram. The Profiler adds support for ATOM-based profiling tools pixie and hiprof and helps the user select a base profiling tool, the estimate-time, and the resources required. The Profiler also adds support for a dis- play of data by function that allows for stepping up and down the call tree. 4 Heap Analyzer: The Heap Analyzer finds and displays memory errors and memory leaks in a program. The Heap Analyzer provides a graphical user interface for generating the data and viewing it in graph or text for- mat. Program Visualizer: The Program Visualizer provides the ability to dis- play large amounts of data in a condensed format. The Program Visu- alization main window uses file pictographs (vertical, rectangular graph- ics) to give a visual representation of the size and content of source files. The tool also displays data from the Profiler, Heap Analyzer, and Search tools. Man Page Browser: The Man Page Browser displays a reference page in a scrollable hypertext window. When using the Compaq FUSE Editor or Emacs, you can select a system function in the source code and dis- play the reference page for that function in the Man Page Browser. Users can click on links to other reference pages and search for ref- erence pages by name or topic to get to the information they need quickly. Call Graph Browser: The Call Graph Browser allows you to visualize your software; analyze the call relationships; and review information on individual calls, routines, and source files. Cross-Referencer: The Cross-Referencer locates references to program identifiers in your source code. It provides a variety of mechanisms for specifying references of interest; for example, assignments, dec- larations, routine definitions, and routine calls. Results of a query are displayed in the Cross-Referencer and corresponding source lines are displayed in the editor. Porting Assistant: The Porting Assistant is an integrated graphical tool designed to reduce the time and cost of porting applications to Tru64 UNIX. The Porting Assistant helps port applications written in C, C++ and Fortran from other UNIX-based platforms such as SUNOS[TM], Solaris [TM], HP-UX [R], IBM/AIX [R], ULTRIX[TM], and from non-UNIX platforms such as OpenVMS[TM]. 5 The Porting Assistant guides you through the porting process by sug- gesting a systematic, iterative porting approach. First, the Porting Assistant analyzes source files and locates changes that may be needed for the application to run on Tru64 UNIX. Then, through extensive, graph- ical hyperlinked information, it helps you understand what changes are needed and why you need to make them. Finally, it aids in making each change either by using the integrated editor or through a global re- place capability. In analyzing software code the Porting Assistant locates: o Conditional code that might also need a Tru64 UNIX branch o Include files that do not exist or exist in a different location o Calls to library functions that do not match Tru64 UNIX definitions or library functions with semantics different from Tru64 UNIX o Platform-specific handling o 32-bit dependencies o Fortran parallelizing directives o Function definitions and calls for Fortran 77 and C that might cause difficulty in porting o Command options and arguments in the makefile that differ between platforms The Porting Assistant provides extensive help through hyperlinked in- formation in the following areas: o Detailed information on many individual diagnostics o The relevance of the semantic differences in functions on differ- ent platforms o Access to relevant reference pages while stepping though the pro- cess o Porting tips that complement Compaq's extensive porting guides 6 o Complete context-sensitive HyperHelp on individual diagnostics and cross-platform descriptions of makefile options and arguments Compaq FUSE EnCASE: Compaq FUSE EnCASE allows new or existing tools to be integrated into the Compaq FUSE environment. Once tools are in- tegrated within Compaq FUSE, users can install them in the Compaq FUSE environment, start them from the Compaq FUSE Control Panel, and con- figure the tools to send and receive messages from other Compaq FUSE tools. The net effect is to achieve a customized and seamlessly ex- tended and integrated development environment. Detailed information and examples for integrating tools can be found in the FUSE EnCASE Man- ual on the Consolidated Distribution CD-ROM. Compaq FUSE C++ Support for Tru64 UNIX Systems Compaq FUSE C++ Support is an optional product that provides a graph- ical C++ Class Browser and special features for analyzing applications written in C++ for Compaq Tru64 UNIX Systems. The Compaq FUSE C++ Support product option does not include a license for the Compaq C++ language. You must purchase a Compaq C++ license separately. For more information on Compaq C++ for Compaq Tru64 UNIX Systems, re- fer to the Software Product Description (SPD 41.91.xx). HARDWARE REQUIREMENTS Compaq FUSE for Tru64 UNIX Systems Processors Supported Any Alpha system running Compaq Tru64 UNIX V4.0D or higher. A minimum recommendation of 64 MB of memory is required for Compaq FUSE alone, or in combination with the optional Compaq FUSE C++ Support for Tru64 UNIX Systems. 7 Disk Space Requirements (Block Cluster Size = 1): 196 MB of swapspace is recommended when running Compaq FUSE alone or with the optional Compaq FUSE C++ Support for Tru64 UNIX Systems. More swapspace may be required for larger applications. Note: The installation procedure installs all Compaq FUSE products re- ferred to in this document. The user must purchase a license and in- stall a License Product Authorization Key (PAK) for any optional Com- paq FUSE components. Certain limitations of an X server may prevent the full suite of FUSE tools from being run concurrently when the display is set to an MS- DOS[R], MS[R] Windows[R], Windows 95[TM], or Windows NT[R] based X server. The presence of any such limits depends on the particular X server used. In some cases, limits might be due to the amount of physical X server memory, the amount of virtual X server memory, or the maximum size of certain MS Windows structures or tables. Such X server limits can generally be overcome by limiting the non- FUSE applications running on or displaying to the server machine, and by invoking only those Compaq FUSE tools actually used in the current activity. Inactive Compaq FUSE tools should be terminated in such in- stances. Disk space required for installation and use (permanent): Root file system: /0 KB Other file /usr 52,400 KB systems: /usr/var 0 KB Total: 52,400 KB 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. 8 SOFTWARE REQUIREMENTS Compaq Tru64 UNIX Version 4.0D or higher Operating System (see SPD 41.61.xx) and Developers' Toolkit for Tru64 UNIX Version 4.0D or higher (see SPD 44.36.xx) OPTIONAL SOFTWARE Compaq FUSE C++ Support V4.2 for Tru64 UNIX Systems Note: Compaq FUSE for Tru64 UNIX Systems is a prerequisite for Compaq FUSE C++ Support V4.2 for Tru64 UNIX Systems. Compaq FUSE Language Support o Compaq C++ for Tru64 UNIX Systems (see SPD 41.91.xx) o Compaq Fortran for Tru64 UNIX Systems (see SPD 37.54.xx) o Compaq Ada for Tru64 UNIX Systems (see SPD 45.89.xx) o Compaq COBOL for Tru64 UNIX Systems (see SPD 52.16.xx) o Compaq Pascal for Tru64 UNIX Systems (see SPD 42.46.xx) Note: Compaq C for Tru64 UNIX is included in the Developers' Toolkit for Tru64 UNIX. GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of Compaq FUSE may be different from the requirements for the current ver- sions. 9 DISTRIBUTION MEDIA Media and documentation for Compaq FUSE are available on the CD-ROM Software Library for Compaq Tru64 UNIX Layered Products QA-054AA-H8. You can order printed documentation separately. ORDERING INFORMATION Compaq FUSE V4.2 for Tru64 UNIX Systems Software License: QL-092AM-3B Software Media/Documentation: QA-054AA-H8 Software Documentation: QA-092AA-GZ Software Product Services: QT-092A[*]-[*][*] Compaq FUSE C++ Support V4.2 for Tru64 UNIX Systems Software License: QL-094AM-3B Software Documentation: N/A Provided with Compaq FUSE documentation Software Product Services: QT-094A[*]-[*][*] SOFTWARE LICENSING This software is furnished only under a license. For more information about Compaq's licensing terms and policies, contact your local Com- paq office. License Management Facility Support: This layered product supports the Compaq Tru64 UNIX License Manage- ment Facility. ____________________ Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. 10 This layered product offers a Concurrent Use license. Each Concurrent Use license allows any one individual at a time to use the layered prod- uct. SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more in- formation, contact your local Compaq office. SOFTWARE WARRANTY Warranty for this software product is provided by Compaq with the pur- chase of a license for the product as defined in the Software Warranty Addendum of this SPD. The information in this SPD is valid at time of release. Contact your local Compaq office for the most up-to-date in- formation. YEAR 2000 READY This product is Year 2000 Ready. Year 2000 Ready is defined: "Year 2000 Ready" products are defined by Compaq as products capable of accurately processing, providing, and/or receiving date data from, into, and between the twentieth and the twenty- first centuries, and the years 1999 and 2000, including leap year cal- culations, when used in accordance with the associated product doc- umentation and provided that all hardware, firmware, and software used in combination with such products properly exchange accurate date data with the products. For additional information visit the DIGITAL Brand area on Compaq's Year 2000 Ready web site located at http://www.compaq.com/year2000/. 11 TRADEMARK INFORMATION [R] COMPAQ, the Compaq logo, and the Digital logo are registered in the U.S. Patent and Trademark Office. [TM] Tru64, OpenVMS, and Compaq C++ are trademarks of Compaq Com- puter Corporation. [R] Motif is a registered trademark of Open Software Foundation, Inc. [R] MS-DOS, MS, Windows, and Windows NT are registered trademarks of Microsoft Corporation. [TM] Windows 95 is a trademark of Microsoft Corporation. [TM] KAP is a trademark of Kuck Associates, Inc. [R] Solaris is a registered trademark of Sun Microsystems, Inc. [TM] SunOS is a trademark of Sun Microsystems, Inc. [R] HP-UX is a registered trademark of Hewlett-Packard Company. [R] AIX is a registered trademark of International Business Ma- chines Corporation. [R] UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. © 1999 Compaq Computer Corporation. All rights reserved. 12