Chapter 1. bufdump quickstart guide

This chapter will give you the minimum information you need to start using the bufdump program. In this chapter you will learn:

Important

The procedure below assumes that the NSCLDAQ utility programs are in the your PATH. At the NSCL this means that the PATH environment variable includes an entry for /usr/opt/utilities/current/bin

Starting bufdump

To start the bufdump program:

  1. Login to a system on which the bufdump program has been installed

  2. If necessary start a terminal window

  3. Type:

    
                 bash$  bufdump 
                

If you have successfully followed these steps, the bufdump window will appear as shown below:

Screen shot of the bufdump program's main window

Selecting a data source

This procedure will show you how to select an offline data source for detailed information about selecting data sources see the discussion of the File->Open... command in Chapter 3: The file menu.

  1. Click the File menu on the menubar at the top of the bufdump main window.

  2. Click the Open... menu entry in the File menu.

    This should result in the data source dialog box like the one shown below.

    Screen shot of the open data source dialog.

  3. Use the lower part of the dialog box to navigate to the directory that has your event files and click on the event file you want to examine.

  4. Click the Ok button. The dialog box will be removed from the screen.

Important

The procedure below assumes that you have already selected a data source.

Stepping through the event source

  1. Locate the arrow button pointing right at the lower left of the bufdump main window

  2. Click the right arrow button. The bufdump program will read the next buffer from the event source, decode the buffer and display the decoded buffer in the middle part of the bufdump main window.

  3. Repeatedly clicking the right arrow button will tell bufdump to read subseqeunt buffers from the data source, decode and display them. Bufdump will hold several buffers in memory. As needed, the middle window will grow scroll bars to allow you to scroll back and forth through the data that has been decoded and displayed.

Tip

The bufdump program is quite powerful. If you want to learn more about what bufdump can do, and how to use it like an expert, read the remainder of this manual.