.\" This manpage has been automatically generated by docbook2man .\" from a DocBook document. This tool can be found at: .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . .TH "DO_PROBE" "" "06 October 2005" "" "" .SH NAME do_probe \- probe an IDE device .SH SYNOPSIS "SYNOPSIS" .sp \fB .sp int do_probe (ide_drive_t * \fIdrive\fB, u8 \fIcmd\fB); \fR .SH "ARGUMENTS" .TP \fB\fIdrive\fB\fR drive to probe .TP \fB\fIcmd\fB\fR command to use .SH "DESCRIPTION" .PP \fBdo_probe\fR has the difficult job of finding a drive if it exists, without getting hung up if it doesn't exist, without trampling on ethernet cards, and without leaving any IRQs dangling to haunt us later. .PP If a drive is ``known'' to exist (from CMOS or kernel parameters), but does not respond right away, the probe will ``hang in there'' for the maximum wait time (about 30 seconds), otherwise it will exit much more quickly. .SH "RETURNS" .PP 0 device was identified 1 device timed-out (no response to identify request) 2 device aborted the command (refused to identify itself) 3 bad status from device (possible for ATAPI drives) 4 probe was not attempted because failure was obvious