Lowercase a couple more element and attribute names.
This commit is contained in:
parent
8af463c4d2
commit
c22beb4998
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=21933
2 changed files with 24 additions and 24 deletions
|
@ -109,7 +109,7 @@
|
|||
widespread availability of binary release snapshots, and the
|
||||
tendency of our user community to keep up with -STABLE development
|
||||
with CVSup and <quote><command>make</command>
|
||||
<MakeTarget>world</MakeTarget></quote>[8] helps to keep
|
||||
<maketarget>world</maketarget></quote>[8] helps to keep
|
||||
FreeBSD-STABLE in a very reliable condition even before the
|
||||
quality assurance activities ramp up pending a major
|
||||
release.</para>
|
||||
|
|
|
@ -150,33 +150,33 @@
|
|||
|
||||
<listitem><para><function>action_func</function> - pointer to
|
||||
the driver's <function>xxx_action</function> function.
|
||||
<funcSynopsis><funcPrototype>
|
||||
<funcDef>static void
|
||||
<funcsynopsis><funcprototype>
|
||||
<funcdef>static void
|
||||
<function>xxx_action</function>
|
||||
</funcDef>
|
||||
</funcdef>
|
||||
<paramdef>
|
||||
<parameter>struct cam_sim *sim</parameter>,
|
||||
<parameter>union ccb *ccb</parameter>
|
||||
</paramdef>
|
||||
</funcPrototype></funcSynopsis>
|
||||
</funcprototype></funcsynopsis>
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para><function>poll_func</function> - pointer to
|
||||
the driver's <function>xxx_poll()</function>
|
||||
<funcSynopsis><funcPrototype>
|
||||
<funcDef>static void
|
||||
<funcsynopsis><funcprototype>
|
||||
<funcdef>static void
|
||||
<function>xxx_poll</function>
|
||||
</funcDef>
|
||||
</funcdef>
|
||||
<paramdef>
|
||||
<parameter>struct cam_sim *sim</parameter>
|
||||
</paramdef>
|
||||
</funcPrototype></funcSynopsis>
|
||||
</funcprototype></funcsynopsis>
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>driver_name - the name of the actual driver,
|
||||
such as <quote>ncr</quote> or <quote>wds</quote>.</para></listitem>
|
||||
|
||||
<listitem><para><structName>softc</structName> - pointer to the
|
||||
<listitem><para><structname>softc</structname> - pointer to the
|
||||
driver's internal descriptor for this SCSI card. This
|
||||
pointer will be used by the driver in future to get private
|
||||
data.</para></listitem>
|
||||
|
@ -215,7 +215,7 @@
|
|||
error; /* some code to handle the error */
|
||||
}</programlisting>
|
||||
|
||||
<para>If there is one <structName>devq</structName> structure per
|
||||
<para>If there is one <structname>devq</structname> structure per
|
||||
SCSI bus (i.e. we consider a card with multiple buses as
|
||||
multiple cards with one bus each) then the bus number will
|
||||
always be 0, otherwise each bus on the SCSI card should be get a
|
||||
|
@ -223,7 +223,7 @@
|
|||
cam_sim.</para>
|
||||
|
||||
<para>After that our controller is completely hooked to the CAM
|
||||
system. The value of <structName>devq</structName> can be
|
||||
system. The value of <structname>devq</structname> can be
|
||||
discarded now: sim will be passed as an argument in all further
|
||||
calls from CAM and devq can be derived from it.</para>
|
||||
|
||||
|
@ -284,7 +284,7 @@
|
|||
bus.</para>
|
||||
|
||||
<para>And we save the path pointer in the
|
||||
<structName>softc</structName> structure for future use. After
|
||||
<structname>softc</structname> structure for future use. After
|
||||
that we save the value of sim (or we can also discard it on the
|
||||
exit from <function>xxx_probe()</function> if we wish).</para>
|
||||
|
||||
|
@ -311,15 +311,15 @@
|
|||
and <function>xxx_poll()</function> driver entry points.</para>
|
||||
|
||||
<para>
|
||||
<funcSynopsis><funcPrototype>
|
||||
<funcDef>static void
|
||||
<funcsynopsis><funcprototype>
|
||||
<funcdef>static void
|
||||
<function>xxx_action</function>
|
||||
</funcDef>
|
||||
</funcdef>
|
||||
<paramdef>
|
||||
<parameter>struct cam_sim *sim</parameter>,
|
||||
<parameter>union ccb *ccb</parameter>
|
||||
</paramdef>
|
||||
</funcPrototype></funcSynopsis>
|
||||
</funcprototype></funcsynopsis>
|
||||
</para>
|
||||
|
||||
<para>Do some action on request of the CAM subsystem. Sim
|
||||
|
@ -359,7 +359,7 @@
|
|||
these functions.</para>
|
||||
|
||||
<para>The type of request is stored in
|
||||
<structField>ccb->ccb_h.func_code</structField>. So generally
|
||||
<structfield>ccb->ccb_h.func_code</structfield>. So generally
|
||||
<function>xxx_action()</function> consists of a big
|
||||
switch:</para>
|
||||
|
||||
|
@ -379,7 +379,7 @@
|
|||
|
||||
<para>As can be seen from the default case (if an unknown command
|
||||
was received) the return code of the command is set into
|
||||
<structField>ccb->ccb_h.status</structField> and the completed
|
||||
<structfield>ccb->ccb_h.status</structfield> and the completed
|
||||
CCB is returned back to CAM by calling
|
||||
<function>xpt_done(ccb)</function>. </para>
|
||||
|
||||
|
@ -1399,14 +1399,14 @@ CCB as done.</para>
|
|||
<sect1 id="scsi-polling">
|
||||
<title>Polling</title>
|
||||
|
||||
<funcSynopsis><funcPrototype>
|
||||
<funcDef>static void
|
||||
<funcsynopsis><funcprototype>
|
||||
<funcdef>static void
|
||||
<function>xxx_poll</function>
|
||||
</funcDef>
|
||||
</funcdef>
|
||||
<paramdef>
|
||||
<parameter>struct cam_sim *sim</parameter>
|
||||
</paramdef>
|
||||
</funcPrototype></funcSynopsis>
|
||||
</funcprototype></funcsynopsis>
|
||||
|
||||
<para>The poll function is used to simulate the interrupts when
|
||||
the interrupt subsystem is not functioning (for example, when
|
||||
|
@ -1420,7 +1420,7 @@ CCB as done.</para>
|
|||
<function>xxx_poll</function> routine gets the struct cam_sim
|
||||
pointer as its argument when the PCI interrupt routine by common
|
||||
convention gets pointer to the struct
|
||||
<structName>xxx_softc</structName> and the ISA interrupt routine
|
||||
<structname>xxx_softc</structname> and the ISA interrupt routine
|
||||
gets just the device unit number. So the poll routine would
|
||||
normally look as:</para>
|
||||
|
||||
|
|
Loading…
Reference in a new issue