diff options
author | William Cohen <wcohen@redhat.com> | 2010-03-09 19:53:52 -0500 |
---|---|---|
committer | William Cohen <wcohen@redhat.com> | 2010-03-09 20:14:19 -0500 |
commit | c24a9d9a9795fac838c4074494006e6e7e1e8835 (patch) | |
tree | ee5f4ddc417ae69ea707ad5f92550f8c91544c4e /man/tapset::scsi.3stap | |
parent | c0f562688ae877000f46058f748a8b986679863e (diff) | |
download | systemtap-steved-c24a9d9a9795fac838c4074494006e6e7e1e8835.tar.gz systemtap-steved-c24a9d9a9795fac838c4074494006e6e7e1e8835.tar.xz systemtap-steved-c24a9d9a9795fac838c4074494006e6e7e1e8835.zip |
PR 11210 move stapprobe.* man pages to tapset::*
Complete the renaming scheme with prefix of "tapset::" for the man
pages related to over all description of groups of probes.
Diffstat (limited to 'man/tapset::scsi.3stap')
-rw-r--r-- | man/tapset::scsi.3stap | 151 |
1 files changed, 151 insertions, 0 deletions
diff --git a/man/tapset::scsi.3stap b/man/tapset::scsi.3stap new file mode 100644 index 00000000..63266e93 --- /dev/null +++ b/man/tapset::scsi.3stap @@ -0,0 +1,151 @@ +.\" -*- nroff -*- +.TH TAPSET::SCSI 3stap "" "IBM" +.SH NAME +tapset::scsi \- systemtap scsi probe points + +.\" macros +.de SAMPLE +.br +.RS +.nf +.nh +.. +.de ESAMPLE +.hy +.fi +.RE +.. + +.SH DESCRIPTION + +This family of probe points is used to probe the SCSI activities. +It contains the following probe points: + +.P +.TP +.B scsi.ioentry +Fires when SCSI mid layer prepares a SCSI request + +.B Arguments: + +.I disk_major + The major number of the disk + +.I disk_minor + The minor number of the disk + +.I device_state + The current state of the device. The possible values could be: + + SDEV_CREATED = 1, /* device created but not added to sysfs + * Only internal commands allowed (for inq) */ + SDEV_RUNNING = 2, /* device properly configured + * All commands allowed */ + SDEV_CANCEL = 3, /* beginning to delete device + * Only error handler commands allowed */ + SDEV_DEL = 4, /* device deleted + * no commands allowed */ + SDEV_QUIESCE = 5, /* Device quiescent. No block commands + * will be accepted, only specials (which + * originate in the mid-layer) */ + SDEV_OFFLINE = 6, /* Device offlined (by error handling or + * user request */ + SDEV_BLOCK = 7, /* Device blocked by scsi lld. No scsi + * commands from user or midlayer should be issued + * to the scsi lld. */ + +.P +.TP +.B scsi.iodispatching +Fires when the SCSI mid layer dispatches a SCSI command to the low level driver + +.B Arguments: + +.I host_no + The host number + +.I channel + The channel number + +.I lun + The lun number + +.I dev_id + The scsi device id + +.I device_state + The current state of the device. + +.I data_direction + The data_direction specifies whether this command is from/to the device. + The possible values could be: + + DMA_BIDIRECTIONAL = 0, + DMA_TO_DEVICE = 1, + DMA_FROM_DEVICE = 2, + DMA_NONE = 3, + +.I request_buffer + The request buffer address + +.I req_bufflen + The request buffer length + +.P +.TP +.B scsi.iodone +Fires when a SCSI command is done by low level driver and enqueued into the done queue. + +.B Arguments: + +.I host_no + The host number + +.I channel + The channel number + +.I lun + The lun number + +.I dev_id + The scsi device id + +.I device_state + The current state of the device + +.I data_direction + The data_direction specifies whether this command is from/to the device. + +.P +.TP +.B scsi.iocompleted +Fires when SCSI mid layer runs the completion processing for +block device I/O requests + +.B Arguments: + +.I host_no + The host number + +.I channel + The channel number + +.I lun + The lun number + +.I dev_id + The scsi device id + +.I device_state + The current state of the device + +.I data_direction + The data_direction specifies whether this command is from/to the device. + +.I goodbytes + The bytes completed. + +.SH SEE ALSO +.IR stap (1), +.IR stapprobes (3stap) + |