TotalView User Guide : Part II: Debugging Tools and Tasks : Visualizing Programs and Data : Array Visualizer : Launching the Visualizer from the Command Line
Launching the Visualizer from the Command Line
To start the Visualizer from the shell, use the following syntax:
visualize [ -file filename | -persist ]
where:
-file filename
Reads data from filename instead of reading from standard input. For information on creating this file, see Setting the Visualizer Launch Command”.
-persist
Continues to run after encountering an EOF (End-of-File) on standard input. If you don’t use this option, the Visualizer exits as soon as it reads all the data.
By default, the Visualizer reads its datasets from standard input and exits when it reads an EOF. When started by TotalView, the Visualizer reads its data from a pipe, ensuring that the Visualizer exits when TotalView does. If you want the Visualizer to continue to run after it exhausts all input, invoke it by using the -persist option.
If you want to read data from a file, invoke the Visualizer with the -file option:
visualize -file my_data_set_file
The Visualizer reads all the datasets in the file. This means that the images you see represent the last versions of the datasets in the file.
The Visualizer supports the generic X toolkit command-line options. For example, you can start the Visualizer with the Directory Window minimized by using the -iconic option. Your system manual page for the X server or the X Window System User’s Guide by O’Reilly & Associates lists the gen­eric X command-line options in detail.
You can also customize the Visualizer by setting X resources in your resource files or on the command line with the -xrm resource_setting option.