TotalView 3.9 Installation and DEMO Instructions Welcome to the world of easy debugging with the TotalView Multiprocess Debugger. TotalView lets you see all aspects of your single- or multiprocess application. Its intuitive and easy-to-use GUI lets you see exactly what's going on. Highly flexible and full-featured, TotalView is unique because it lets you debug multiple processes simultaneously. Don't waste time, find out about TotalView today! ------------------------------------------------------------------------ Contents Installing TotalView Compiling Your Program Starting Up TotalView If You Hate to Read Documentation ------------------------------------------------------------------------ Installing TotalView Install TotalView using the Install script as shown below. A complete, fully functioning TotalView will be installed. Installation Notes a. We recommend that you become the "root" user to complete the installation, to prevent users from modifying the software after it is installed. However, you do not have to become the "root" user to install the software. b. The Install program prompts you to identify an installation directory where it creates two subdirectories named: totalview./ flexlm-5.0 (which is license management software and documentation) When you are prompted for an installation directory name, you can do one of the following: i. Use the default installation directory. Depending on your UNIX system, this is either the /opt/toolworks directory or the /usr/toolworks directory. ii. Use the name of any directory you can create. The Install program also accepts the current directory symbol ".". If the directory you specify does not exist, the Install program creates it. These instructions refer to the absolute pathname of the installation directory that you create as "". c. The Install program asks you if you want to create a symbolic link (named "totalview") in the /opt or /usr directory. This symbolic link will point to the directory within your installation known as "TVROOT": /totalview./ If you do not install as "root", the Install program cannot create the link. As non-"root", you should answer "n" (no) to this prompt. If for any reason the creation of the symbolic link fails, you can safely ignore messages about this problem and continue the installation by pressing Enter. To Start the Installation 1. (Optional) On the system where you are installing the TotalView Multiprocess Debugger, type: % su root Password: 2. From the scratch directory where you unbundled the release, start the Install program. Type: # ./Install Reply to queries and prompts until the Install program ends. 3. You no longer need to be the "root" user. Type: # exit 4. For convenience, save the location of your TVROOT directory in the environment variable "TVROOT": a. If you created the symbolic link when you ran Install, type the command which uses the link for your system: % setenv TVROOT /opt/totalview % setenv TVROOT /usr/totalview b. If you did not create the symbolic link, type a command which uses the full path to your TVROOT directory: % setenv TVROOT /totalview./ 5. Test the installation by attempting to start the TotalView program. Type: % $TVROOT/bin/totalview The TotalView program prints its banner including its version number, and a message that it is unable to check out a license. To Install a Temporary DEMO License When you have completed a TotalView DEMO License Request and sent it in for a TotalView DEMO license, create a text file (license.dat) that contains the license text that you received back from Etnus. 1. Become the "root" user if you installed the TotalView software as "root". 2. Using any plain-ASCII text editor, open a new license.dat file in the flexlm-5.0 subdirectory of your installation directory: /flexlm-5.0/license.dat 3. Copy the TotalView license text to the new file, and save it. For example (N.B. The following is not a working DEMO license.): ## BEGIN LICENSE INCREMENT TV/Base toolworks 3.900 15-sep-1999 0 \ BC8A515092B3FEDED3D1 \ HOSTID=DEMO ISSUED=02-Jul-1999 ck=66 INCREMENT TV/AnyChip-AnyOS toolworks 3.900 15-sep-1999 0 \ 2CBD550D56D4C44EA448 \ HOSTID=DEMO ISSUED=02-Jul-1999 ck=39 INCREMENT TV/AnyChip-AnyOS/MP/Big toolworks 3.900 15-sep-1999 0 \ 6CCA511C177274D9B25F \ HOSTID=DEMO ISSUED=02-Jul-1999 ck=22 INCREMENT TV/AnyChip-AnyOS/PE toolworks 3.900 15-sep-1999 0 \ FC581156B7938CCE0AE0 \ HOSTID=DEMO ISSUED=02-Jul-1999 ck=41 INCREMENT TV/AnyChip-AnyOS/PGIHPF toolworks 3.900 15-sep-1999 0 \ 0CA85135BF22D3F8EBF1 \ HOSTID=DEMO ISSUED=02-Jul-1999 ck=20 ## END LICENSE 4. You no longer need to be the "root" user. Type: # exit To Test the DEMO License Installation 1. When operating the TotalView program, we recommend that you set your window manager focus policy to Focus Follows Mouse. 2. Run the TotalView program. Type: % $TVROOT/bin/totalview This time, the TotalView program prints its banner and opens its Root window. 3. Exit the TotalView program: a. Move the mouse pointer to the TotalView window. b. Type "q" and click Yes. To Set Up Your Environment 1. Place TotalView in your "path" environment variables: a. Add $TVROOT/bin to PATH. b. Add $TVROOT/man to MANPATH. 2. On Digital UNIX, IRIX and Solaris, confirm that the /proc directory is mounted: % ls /proc The ls command should print a list of numbers. If it does not, ask your system administrator to mount the /proc directory. Refer to Appendix B of the TotalView User's Guide for more information. Compiling Your Program Compile the program you want to debug with the appropriate switches and libraries. For all platforms: a. Include the -g switch on the compiler command line. b. *Do not* include the -O switch on the compiler command line. c. The TotalView Multiprocess Debugger can automatically attach a process created by calls to fork() and execve() if you link with the dbfork library. To use this facility, include the -ldbfork switch on the compiler command line when you link your program. Precede this switch with the -L$TVROOT/lib switch. For IBM only: i. Also use -bkeepfile:$TVROOT/lib/libdbfork.a when linking with -ldbfork. For SGI only: i. Include either the -n32 or -64 switch on the compiler command line. TotalView does *not* support compiling with -32 (-o32), which is the default for some compilers. ii. The -ldbfork switch is specific to the executable format. Include either -ldbfork_n32.a or -ldbfork_n64.a when you link your program. For PGI HPF only: i. Include the -Mtv switch on the pghpf command line. Note: pghpf produces -64 executables on SGI. Refer to the TotalView User's Guide and TotalView Release Notes for complete information for your platform. Starting Up TotalView To start TotalView, type the totalview command followed by the name of an executable file, for example: % totalview my_program The command syntax is: totalview [ []] [] where is the executable file to be debugged. See the TotalView User's Guide for a complete list of X resources and command-line options. If You Hate to Read Documentation To use TotalView, all you need to know is how to use the mouse: 1. The left button "selects" objects, i.e., selecting a line number next to a source line will put a breakpoint there, and selecting the value displayed for a variable will allow you to change the value. 2. The middle button "pops up" a menu of possible commands. Keyboard accelerators for common actions (g=go, h=halt, s=step, etc.) are listed in the pop-up menus. Menus vary by type of window. 3. The right button "dives" into many objects on the screen. For example, diving into a variable name brings up the value of the variable. Diving into a pointer to a structure breaks out the structure into its components. Diving into a subroutine name brings up the source for the subroutine. To "undive", click on the "^" icon in the upper, right-hand corner of the window. If you want to know more: a. Play with the selections in the pop-up menus b. Type "Control-?" in any TotalView window and read the menu description c. Type "man totalview" and "man tvdsvr" and read the TotalView man pages d. Finally, if that isn't enough, read the Installation Guide, User's Guide and Release Notes. Thank You! Thank you for your interest in a demo copy of Etnus' TotalView Multiprocess Debugger software. After the trial period, if you decide that you want to purchase TotalView, all you need to do is call, fax or send us your purchase order and we'll issue you a permanent TotalView license. Have a fun test drive, and let us know how you like it! ------------------------------------------------------------------------ For more information, please contact your local distributor or: Marguerite Sinnett Etnus Inc. 111 Speen Street Framingham, MA 01701-2090 info@etnus.com 1-800-856-3766 in the United States (+1) 508-875-3030 worldwide Fax: (+1) 508-875-1517 http://www.etnus.com ------------------------------------------------------------------------ Last modified: June 8, 1999 Etnus Inc. / info@etnus.com