This web page refers to our older busTRACE 7.0 which is no longer shipping. Click here for details on our latest generation busTRACE software.
This WEB page comes from the busTRACE 7.0 User's Manual. (Table of Contents)
busTRACE 7.0 has the ability to filter captured I/O activity. This allows you to view only the types of I/O requests you are interested in analyzing.
busTRACE provides you two methods for filtering requests. The first is our Kernel Mode CDB Filter. This filter lets the busTRACE device driver know which Command Descriptor Blocks should be captured and which should be skipped. The I/Os are not captured nor do they take up memory. This feature is discussed in detail in our Kernel Mode CDB Filter section.
The second method is busTRACE's ability to filter captured I/O activity from view. These I/O requests are still stored in memory, just filtered from the I/O Capture List. The filtered I/Os are still in memory and you can readjust the filter to view them again.
Context Based Filtering
The simplest and fastest way to filter I/O activity is to right click on an I/O in the I/O Capture List. Two filter menu options will appear. The first option allows you to filter out the selected I/O based on one of four criteria:
The second menu option allows you to Remove I/O Filters. This setting will turn off all filtered settings and show you all of the captured I/O activity.
You can also filter I/O activity by viewing our Filtered Commands dialog box. Simly right click on any captured I/O, in the I/O Capture List, and choose the Filter I/O Activity option. You will see a dialog box come up with four different options to choose from: General, Command/Status, Originator, and Devices.
The filtering options only filter I/O activity from view. They still remain in memory and can be viewed again by adjusting your filter settings.
General Filter Options
You can filter out General I/O activity that applies to all devices.
Command/Status Filter Options
A particularly powerful filtering option is busTRACE's ability to filter out specific commands or specific status. By default, all commands captured and all status seen have a checkmark next to them indicating that they are currently being viewed in the I/O Capture List window.
By removing a checkmark, you are instructing busTRACE to no longer show any I/O with that command sent, or any I/O with the return status, in the I/O Capture List window.
Originator Filter Options
busTRACE has the ability to detect which driver originated the I/O activity. The Originator tab allows you to configure busTRACE to filter out any I/O activity that was sent from a specific driver.
By default, busTRACE places a checkmark on all I/O originators indicating that you want no I/O activity filtered. Simply remove the checkmark from I/Os generated by the given Originator to filter out its I/O activity.
Devices Filter Options
In most configurations, you are capturing I/O activity for only one device (the device you are interested in analyzing). What if all devices had their I/O activity captured but you were only interested in one specific device? This may occur if someone else captures I/O activity and sends you the capture file for analysis.
There are multiple ways for you to get to the device I/O you are interested in. One of the simplest is to use the Devices filtering option.
In its default configuration, a checkmark appears next to all devices. This tells busTRACE to show the I/O activity that was captured for all devices. If you are interested in viewing I/O activity for only one device, simply remove the checkmark from all other devices.
Once you have configured busTRACE to filter out I/O activity, you may want to save those settings to our Filtered Commands cache. This allows you to quickly reuse the same filter settings at a later time.
To get to this feature, you need to click on the drop down arrow on the right part of the Filter toolbar button. When you do, a drop-down menu with the available options will appear.
The first entry is to "Load/Save Cached Filters..." If you select this option, a dialog box will appear letting you Load, Remove, or Save the current filter settings. If you have previously saved any filter settings, the most recently used list will appear below the "Load/Save Cached Filters..." menu item. You can simply select the item to immediately apply the previously cached filter settings.
Selecting the "Load/Save Cached Filters..." menu item will bring you to our Cached Filtered Commands options:
If you have previously saved any filtered settings, they will appear in the "Previously saved filtered commands" window. The following options are available: