Software Product Description PRODUCT NAME: DEC FUSE Version 4.0 for Digital UNIX SPD 44.71.07 June 1997 Digital Equipment Corporation Maynard, Massachusetts 1 DESCRIPTION DEC FUSE V4.0 for Digital UNIX Systems This Software Product Description (SPD) describes the following products: o DEC FUSE V4.0 for Digital UNIX Systems[1] o DEC FUSE C++ Support V4.0 for Digital UNIX Systems DEC FUSE V4.0 runs on Digital UNIX V4.0[2] Systems. 1.1 DEC FUSE for Digital UNIX Systems DEC FUSE is an integrated set of tools that provides a seamless visual environment for developing applications on Digital UNIX Alpha platforms. It helps programmers browse, edit, build, debug, and tune applications. For programmers new to UNIX, point-and-click features of DEC FUSE speed work by letting you quickly take advantage of UNIX software development utilities. For experienced UNIX program- mers, DEC FUSE integrates traditional and familiar UNIX software development tools with a Motif[R]-based graphical user inter- face (GUI) across the complete DEC FUSE environment. The overall result is improved productivity for all DEC FUSE users. Application development with DEC FUSE requires no conversion, filtering, or any other special preparation of Digital UNIX applications. DEC FUSE is an excellent tool for both new sys- tem development and system maintenance. The dynamic, mouse- sensitive, graphical environment greatly speeds the gather- ing of information about application source code, simplifies the gathering of application performance characteristics, and streamlines problem identification and program navigation. DEC FUSE provides full language support for DEC C++, DEC C, and Digital Fortran (includes both F77 and Fortran 90 features). DEC FUSE V4.0 provides general language support for DEC Ada, DEC COBOL, and DEC Pascal. DEC FUSE 4.0 is a prerequisite for the following optional product: o DEC FUSE C++ Support V4.0 for Digital UNIX Systems Note that DEC FUSE Ada Support is included in the DEC FUSE V4.0 base kit (previously an optional product) and does not need a separate license. DEC FUSE fully supports the American English locale. It also supports the Japanese locale when run with Digital UNIX V4.0A and later. ___________________ [1] Throughout this SPD, DEC FUSE denotes DEC FUSE V4.0 for Digi- tal UNIX Systems. [2] Digital UNIX Version 4.0 is an X/Open 95 branded product. 1 For additional information, please refer to the Software Re- quirements, Optional Software and Ordering Information sections of this SPD. 1.2 Components of the DEC FUSE Environment DEC FUSE V4.0 offers an integrated suite of tools that feature the following capabilities: CDE Integration: DEC FUSE is integrated with the Common Desktop Environment (CDE). Users can launch tools from the CDE Appli- cation Manager, 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 DEC FUSE tools and controlling a DEC FUSE session. The Control Panel also saves and recalls information about a project (which contains a group of tools) to maintain a work context. DEC FUSE also allows users to invoke DEC FUSE tools from the shell command line. Editors: The FUSE Editor has a Motif-based interface and is tightly integrated into the DEC 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 DEC FUSE environment. 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 graphically displays the module dependencies, showing which mod- ules 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 DEC FUSE V4.0 Builder supports the enhanced XPG4/POSIX compliant 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 computationally intensive codes. (See SPD 45.72.07 for KAP Fortran Optimizers for Digital UNIX and SPD 45.73.06 for KAP for C.) To assist in resolving linker warnings, the Builder lets you search for functions in system libraries. 2 Debugger: The Debugger provides a Motif-based interface to the ladebug Debugger. For detailed information on ladebug, see the Developers' Toolkit for Digital UNIX V4.0, SPD 44.36.xx. The Debugger displays source code, the call stack, local vari- ables, monitored expressions, registers, and instructions. Data views can be expanded to show their contents or to follow point- ers, and an I/O window is provided for application terminal I/O. Users can customize the interface by creating additional but- tons 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. Code Manager: The Code Manager provides source code control to support programming work groups with a Motif-based interface to either SCCS (Source Code Control System) or RCS (Revision Control System). Integration with the DEC FUSE Editor lets you check-in and check-out files from the editor. Version Controller: The Version Controller lets you use many commercially available and in-house code library managers by providing dialog box interfaces to common commands (for example, check-in/out). Users can tailor these commands to suit their needs. Through the Version Controller, the functions of the code library managers become available in the DEC FUSE Editor and CDE. Compare and Merge: The Compare tool provides a graphical user interface to the UNIX diff utility. Through integration with the Code Manager, 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 display window while stepping through changes. Search: The Search tool provides a graphical user interface to the standard UNIX utilities grep, fgrep, and egrep. The Search tool searches files or directories of files for a regular ex- pression or string. The integration between Search and supported DEC 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 re- source use information. This information is displayed in text format or as a histogram. 3 The Profiler adds support for ATOM-based profiling tools pixie and hiprof and helps the user select a base profiling tool and the estimate-time, and the resources required. The Profiler also adds support for a display of data by function that allows for stepping up and down the call tree. 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 format. Program Visualizer: The Program Visualizer provides the ability to display large amounts of data in a condensed format. The Pro- gram Visualization main window uses file pictographs (vertical, rectangular graphics) 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 DEC FUSE Editor or Emacs, you can select a system function in the source code and display the reference page for that function in the Man Page Browser. Users can click on links to other reference pages, and search for reference pages by name or topic to get to the information they need quickly. Call Graph Browser: The Call Graph Browser allows you to visu- alize 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 exam- ple, assignments, declarations, 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 graph- ical tool designed to reduce the time and cost of porting appli- cations to Digital 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]. The Porting Assistant guides you through the porting process by suggesting 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 Digital UNIX. Then, through extensive, graphical 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 replace capability. 4 In analyzing software code the Porting Assistant locates: o Conditional code that might also need a Digital UNIX branch o Include files that do not exist or exist in a different location o Calls to library functions that do not match Digital UNIX definitions or library functions with semantics from Digital 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 hyper- linked information in the following areas: o Detailed information on many individual diagnostics o The relevance of the semantic differences in functions on different platforms o Access to relevant reference pages while stepping though the process o Porting tips that complement Digital's extensive porting guides o Complete context-sensitive HyperHelp on individual diagnos- tics and cross-platform descriptions of makefile options and arguments DEC FUSE EnCASE: DEC FUSE EnCASE allows new or existing tools to be integrated into the DEC FUSE environment. Once tools are integrated within DEC FUSE, users can install them in the DEC FUSE environment, start them from the DEC FUSE Control Panel, and configure the tools to send and receive messages from other DEC FUSE tools. The net effect is to achieve a customized and seamlessly extended and integrated development environment. Detailed information and examples for integrating tools can be found in the DEC FUSE EnCASE Manual. 1.3 DEC FUSE C++ Support for Digital UNIX Systems DEC FUSE C++ Support is an optional product that provides a graphical C++ Class Browser and special features for analyzing applications written in DEC C++ for Digital UNIX Systems. The DEC FUSE C++ Support product option does not include a license for the DEC C++ language. You must purchase a DEC C++ license separately. 5 For more information on DEC C++ for Digital UNIX Systems, refer to the Software Product Description (SPD 41.91.xx). 2 HARDWARE REQUIREMENTS DEC FUSE for Digital UNIX Systems Processors Supported Any Alpha system running Digital UNIX V4.0. A Minimum recommendation of 64 MB of memory is required for DEC FUSE alone, or in combination with the optional DEC FUSE C++ Support for Digital UNIX Systems. 2.1 Disk Space Requirements (Block Cluster Size = 1): 196 MB of swapspace is recommended when running DEC FUSE alone or with the optional DEC FUSE C++ Support for Digital UNIX Systems. More swapspace may be required for larger applications. NOTE The installation procedure installs all DEC FUSE products referred to in this document. The user must purchase a license and install a License Product Authorization Key (PAK) for any optional DEC 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[TM], Windows 95[TM], or Windows NT[TM] 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 DEC FUSE tools actually used in the current activity. Inactive DEC FUSE tools should be terminated in such instances. 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 6 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 SOFTWARE REQUIREMENTS Digital UNIX V4.0[3] Operating System (see SPD 41.61.xx) and Developers' Toolkit for Digital UNIX V4.0 (see SPD 44.36.xx) 4 OPTIONAL SOFTWARE DEC FUSE C++ Support V4.0 for Digital UNIX V4.0 Systems NOTE DEC FUSE for Digital UNIX Systems is a prerequisite for DEC FUSE C++ Support V4.0 for Digital UNIX V4.0 Systems. NOTE The DEC FUSE Ada Support (formerly an optional product) and license are included in the DEC FUSE V4.0 for Digital UNIX base kit. DEC FUSE Language Support o DEC C++ for Digital UNIX Systems (see SPD 41.91.xx) o Digital Fortran for Digital UNIX Systems (see SPD 37.54.xx) o DEC Ada for Digital UNIX Systems (see SPD 45.89.xx) o DEC COBOL for Digital UNIX Systems (see SPD 52.16.xx) o DEC Pascal for Digital UNIX Systems (see SPD 42.46.xx) NOTE DEC C for Digital UNIX is included in the Developers' Toolkit for Digital V4.0. ___________________ [3] Digital UNIX V4.0A is needed for full use of DEC FUSE in the Japanese locale. 7 5 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future ver- sion of DEC FUSE may be different from the requirements for the current versions. 6 DISTRIBUTION MEDIA Media and documentation for DEC FUSE are available on the Dig- ital CD-ROM Software Library for Digital UNIX Layered Products QA-054AA-H8. You can order printed documentation separately. 7 ORDERING INFORMATION 7.1 DEC FUSE V4.0 for Digital UNIX Systems Software License: QL-092AM-3B Software Media/Documentation: QA-054AA-H8 Software Documentation: QA-092AA-GZ Software Product Services: QT-092A[*]-[*][*] 7.2 DEC FUSE C++ Support V4.0 for Digital UNIX V4.0 Systems Software License: QL-094AM-3B Software Documentation: N/A Provided with DEC FUSE documentation Software Product Services: QT-094A[*]-[*][*] 8 SOFTWARE LICENSING This software is furnished only under a license. For more in- formation about Digital's licensing terms and policies, contact your local Digital office. License Management Facility Support: This layered product supports the Digital UNIX License Manage- ment Facility. This layered product offers a Concurrent Use license. Each Concurrent Use license allows any one individual at a time to use the layered product. ___________________ [*] Denotes variant fields. For additional information on avail- able licenses, services, and media, refer to the appropriate price book. 8 9 SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more information, contact your local Digital office. 10 SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the purchase 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. Please contact your local Digital office for the most up-to-date information. [R] Motif is a registered trademark of Open Software Founda- tion, Inc. [R] MS-DOS and MS are registered trademarks of Microsoft Corpo- ration. [TM] Windows, Windows 95, and Windows NT are trademarks of Microsoft Corporation. [TM] KAP is a trademark of Kuck Associates, Inc. [TM] SUNOS and Solaris are trademarks of Sun Microsystems, Inc. [R] HP-UX is a registered trademark of Hewlett-Packard Company. [R] AIX is a registered trademark of International Business Machines Corporation. [R] UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Com- pany Ltd. [TM] DEC C++, DIGITAL, Digital UNIX, OpenVMS, and the Digital logo are trademarks of Digital Equipment Corporation. © 1997 Digital Equipment Corporation. All rights reserved. 9