'\" t .\" Title: KickStart .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: May 2018 .\" Manual: Message-based devices .\" Source: Kernel Hackers Manual 3.16.56 .\" Language: English .\" .TH "KICKSTART" "9" "May 2018" "Kernel Hackers Manual 3\&.16\&" "Message-based devices" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" KickStart \- Perform hard reset of MPT adapter\&. .SH "SYNOPSIS" .HP \w'int\ KickStart('u .BI "int KickStart(MPT_ADAPTER\ *\ " "ioc" ", int\ " "force" ", int\ " "sleepFlag" ");" .SH "ARGUMENTS" .PP \fIioc\fR .RS 4 Pointer to MPT_ADAPTER structure .RE .PP \fIforce\fR .RS 4 Force hard reset .RE .PP \fIsleepFlag\fR .RS 4 Specifies whether the process can sleep .RE .SH "DESCRIPTION" .PP This routine places MPT adapter in diagnostic mode via the WriteSequence register, and then performs a hard reset of adapter via the Diagnostic register\&. .SH "INPUTS" .PP sleepflag \- CAN_SLEEP (non\-interrupt thread) or NO_SLEEP (interrupt thread, use mdelay) force \- 1 if doorbell active, board fault state board operational, IOC_RECOVERY or IOC_BRINGUP and there is an alt_ioc\&. 0 else .SH "RETURNS" .PP 1 \- hard reset, READY 0 \- no reset due to History bit, READY \-1 \- no reset due to History bit but not READY OR reset but failed to come READY \-2 \- no reset, could not enter DIAG mode \-3 \- reset but bad FW bit .SH "COPYRIGHT" .br