This web page refers to our older busTRACE 6.0 which is no longer shipping. Click here for details on our latest generation busTRACE software.

busTRACE 6.0 This WEB page comes from the busTRACE 6.0 User's Manual. (Table of Contents)

Previous Topic Next Topic
 

There are a variety of columns you can add to the I/O Capture List window. Each one of these is described in this section. Please note that not all columns are applicable for each type of I/O. When not applicable, the column will be left blank.

Bookmark

This column shows you whether the I/O has a bookmark set or not. If the I/O has a bookmark set, a bookmark icon appears in this column.

Bytes Captured

This column shows you how many bytes of data have been captured for the given I/O. If you have configured busTRACE to capture less data than what was actually transferred, this value may be less than the Bytes Transferred described below.

Bytes Requested

This column shows you how many bytes were requested to be transferred. In other words, how large the original data buffer was. This may be larger than what was actually transferred. For example, if a command is issued to a device that will return between 0 and 256 bytes (depending on what data is available), the caller may set the original buffer size to 256 bytes. This way, there is enough space to store the entire data transfer.

Bytes Transferred

This column shows you how many bytes were actually transferred along with the I/O. This may be less than (but never more than) the Bytes Requested value described above. There are some circumstances where this value is always set to the Bytes Requested value, and does not represent the true number of bytes transferred. This is usually caused by a limitation of the underlying software driver or hardware. Additional details on this limitation can be found in our Troubleshooting busTRACE section.

Command 1

This column shows you text describing the I/O command sent. For a storage device, this is usually the name of the CDB being sent to the device (e.g. Test Unit Ready, Inquiry, etc.). For a USB device, this is usually the URB Function being sent to the device (e.g. Get Descriptor, Select Interface, etc.).

Command 2

This column shows you more specific text describing the I/O command sent. For a storage device, this is usually the hex Command Descriptor Block being sent. For a USB device, this is usually additional details about the URB Function being sent.

Counter

This column indicates the order in which the I/Os were initiated.

Device

This column displays an icon for the device that the I/O was sent too. This is the same icon that appears in the Capture Devices pane. If you float the mouse over the device icon, in the I/O Capture List, busTRACE will show you the full device name in a tool tip.

Device ID

This column will show you the Port Number, Path ID, Target ID, and LUN for the device that processed the captured I/O. This field is only applicable to storage devices. If no such value is available, the field is left empty.

Device Pointer

This field shows you a unique 32-bit or 64-bit value that is used internally to represent the device that processed the I/O request. When you are capturing I/O activity, this field shows you the PDEVICE_OBJECT pointer value for the device object that received the IRP request. For busPROBE or busSCRIPT, the value is an internally used pointer. This field is not available under Windows Me.

End Time

This column displays when the I/O finished. You can customize how the I/O timing is displayed.

Error Indicator

This column indicates whether the I/O succeeded or failed. If successful, nothing appears in this column entry. If the I/O fails, an error icon will appear.

Execution Time

This column displays the time it took for the I/O to execute. You can customize how the I/O timing is displayed.

I/O Direction

This column shows you whether data is being transferred to the device (data out) or from the device (data in). If no data is transferred, nothing appears in this column.

I/O Interleave Arrows

If you have configured busTRACE to view interleaved I/O activity (one showing the I/O going down the stack, and the other going up the stack), this column shows you how the I/Os are interleaved by drawing an arrow from where the I/O starts to where the I/O finishes.

I/O Timeout

This column displays the timeout set for the given I/O.

IRP Direction

This column indicates whether the I/O is going down the I/O stack or going back up the I/O stack. This is only applicable if you have configured busTRACE to view interleaved I/O activity. If busTRACE is configured in its default state of not viewing interleaved I/O activity, then this column will simply show you a double arrow indicator.

IRP Pointer

This field shows you a unique 32-bit or 64-bit value that is used internally to represent the I/O request. When you are capturing I/O activity, this field shows you the PIRP pointer value for the IRP that was sent to generate the I/O request. For busPROBE or busSCRIPT, the value is an internally used pointer. This field is not available under Windows Me.

IRP Type

This column shows you the type of I/O Request Packet (IRP) that was captured. Details on types of I/O Request Packets are described in Microsoft's Windows Driver Development Kit. One of the following fields will be displayed here:

SRB This value indicates a standard IRP_MJ_SCSI request (i.e. SRB/CDB) was captured.
SPTI_BUFFERED This value indicates an IOCTL_SCSI_PASS_THROUGH request was captured. This request is typically sent by a ring 3 application (i.e. Windows application) to send a CDB to a storage device. This is only applicable to Windows 2000 and above.
SPTI_DIRECT This value indicates an IOCTL_SCSI_PASS_THROUGH_DIRECT request was captured. This request is typically sent by a ring 3 application (i.e. Windows application) to send a CDB to a storage device. This is only applicable to Windows 2000 and above.
IOCTL This value indicates an IOCTL was captured. This is only applicable to Windows 2000 and above.
IOP/IOR This value indicates an IOP/IOR requests was captured. This is only applicable to Windows Me.
USB/URB This value indicates a low-level USB Request Block (URB) was captured. This is only applicable to Windows 2000 and above.
IRP_MJ_POWER This value indicates a power management IRP was captured. This is only applicable to Windows 2000 and above.
IRP_MJ_PNP This value indicates a Plug and Play IRP was captured. This is only applicable to Windows 2000 and above.
LBA

If dealing with storage class devices (e.g. hard drive, CD/DVD drive), and a read, write, or verify is issued, this column shows you the I/O request's starting Logical Block Address (LBA).

Originator

If we are able to determine which driver submitted the I/O request, the name of the driver will appear here. This field is not available under Windows Me.

NOTE: If we detect that the I/O is being sent directly to the port driver, bypassing the I/O stack, we place an "[x]" indicator to the right of the originator name. We can only detect this if busTRACE's Advanced Filtering option is enabled.

Raw Data

This column will show you up to the first eight bytes of data transfer. You can click on the column header to sort on this field if you like. If there are more than eight bytes available, "..." is appended to the end of the entry.

Sector Count

If dealing with storage class devices (e.g. hard drive, CD/DVD drive), and a read, write, or verify is issued, this column shows you the number of sectors requested by the I/O.

Sense Data

If dealing with storage class devices (e.g. hard drive, CD/DVD drive, etc.), and a check condition occurs, this column will show you three hex bytes. The first is the sense key followed by the sense code followed by the sense code qualifier.

SRB Status

If the I/O captured is a SCSI_REQUEST_BLOCK, this column would show you the SrbStatus field.

Start Time

This column displays when the I/O started. You can customize how the I/O timing is displayed.

Target Status

If the I/O captured is a SCSI_REQUEST_BLOCK, this column would show you the ScsiStatus field.

Trigger Indicator

This column shows you whether the I/O hit a trigger point or not. If the I/O did hit a trigger point, a trigger icon appears in this column.

User Comment

If a user comment is attached to a given I/O, floating the mouse over the list item will display a tool tip with that user comment. You can choose to view all user comments in their own column by selecting this option.

See Also: