linux/Documentation/networking/spider_net.txt
<<
>>
Prefs
   1
   2            The Spidernet Device Driver
   3            ===========================
   4
   5Written by Linas Vepstas <linas@austin.ibm.com>
   6
   7Version of 7 June 2007
   8
   9Abstract
  10========
  11This document sketches the structure of portions of the spidernet
  12device driver in the Linux kernel tree. The spidernet is a gigabit
  13ethernet device built into the Toshiba southbridge commonly used
  14in the SONY Playstation 3 and the IBM QS20 Cell blade.
  15
  16The Structure of the RX Ring.
  17=============================
A18"class="l1ine" name="L9">   91Abstr1ct
  10  11   2 devic22ocumeder    13  14  15  16A182 class="2ine" name="L17">  17y" descriptorRiuorm">yocumentation/networking/spider_net.txt#L1  9A182 class="2ine" name="L1tion 2=
A182class="l2ine" name="L9">   92Abstr2ct
  10y. Itamayocumentation/networking/spider_net.txt#L1  9A183 class="3ine" name="L11">  11   23devic32f="Documentation/networking/spider_net.txt#L16" id="L163class="liine" name="L3">   3 ether33drivDurnetinormal operrking, onlt into nd rtup,tth
  14  15y tor_n&e Li datarnetiuocumentation/networking/spider_net.txt#L16" id="L163 class="3ine" name="L16">  16  17   93Abstr39f="Documentation/networking/spider_net.txt#L16" id="L164 class="4ine" name="L10">  10"ocumentation/networking/spider_net.txt#L3" id="L3" 4 class="4ine" name="L11">  11   24devic42driverscriptorR tshi J (GDACTDPA)rnet iGDACTDPAR tshis  ttth ierscrocumentation/networking/spider_net.txt#L3" id="L3" 4class="l4ine" name="L3">   34ether43drivcurrtwoly benetifilled. Whe ker skerscr  skfilled,a souhardwaX ocumentation/networking/spider_net.txt#L3" id="L3" 4class="liine" name="L4">   4
in th44=
  15A184 class="4ine" name="L16">  16  17   94Abstr49f="Documentation/networking/spider_net.txt#L16" id="L165 class="5ine" name="L10">  10  11,a sou ail  tshi J willob   tshinetiat ar"full"ocumentation/networking/spider_net.txt#L3" id="L3" 5class="l5ine" name="L2">   25devic52driverscrrnet iOS willoproces=ker skerscr,M QS20 Cnsmarkgit "not-in-f="",ocumentation/networking/spider_net.txt#L1  9A185class="l5ine" name="L3">   35ether53t
A185class="l5ine" name="L4">   45in th54=
A185class="liine" name="L5">   5W
  16  17A185 class="5ine" name="L1tion 2=
   95Abstr59f="Documentation/networking/spider_net.txt#L16" id="L166 class="6ine" name="L10">  10R tshi J (someweat mis-  10d) follows afi J isou ail  tshi J.ocumentation/networking/spider_net.txt#L16" id="L166 class="6ine" name="L11">  11R tshi J willob   tshinetiatocumentation/networking/spider_net.txt#L16" id="L166class="l6ine" name="L2">   26devic62drivas"not-in-f="" erscrrnet iOS willoper="ajavarious housekeepnetidutieuocumentation/networking/spider_net.txt#L16" id="L166class="l6ine" name="L3">   36ether63t
A186class="l6ine" name="L4">   46in th64=
A186class="l6ine" name="L5">   56
y tor_n&e Li datarnetus, whe ker X ocumentation/networking/spider_net.txt#L1  9A186class="liine" name="L6">   6
The S66f="Diu flowneti hrtraffic,2ev ryer etitn frontRing souom">R tshi J shouldocumentation/networking/spider_net.txt#L1  9A186 class="6ine" name="L17">  17A186 class="6ine" name="L1tion 2=
R tshi J caVec tcheup iba sou ailocumentation/networking/spider_net.txt#L1  9A186class="l6ine" name="L9">   96Abstr69f="D tshi J,iat whiche tshitth
Rerscr  socumentation/networking/spider_net.txt#L7" id="L7" c class="7ine" name="L10">  10  11   27devic72ocumedus, tn aVeidle syst
m,Mre oGDACTDPA,u ail  QS2hm">R tshi Js willocumentation/networking/spider_net.txt#L1  9A187class="l7ine" name="L3">   37ether73=
A187class="l7ine" name="L4">   47in th74=
   57
   67The S7ructure o how_rx_chain() routine willoprshitout et
   7V=====77f="DGDACTDPA,u ail  QS2hm">R tshi Js. Itawilloalso summariz
   97Abstr79SONYernet
  10  11   28devic82f="Documentation/networking/spider_net.txt#L16" id="L168class="l8ine" name="L3">   38ether83=
   48in th84=
   58
Ris  tt20ocumentation/networking/spider_net.txt#L16" id="L168class="l8ine" name="L6">   68The S86=
   78=====87=
   8
href=88=
   98Abstr89=
  10  11   29devic92f="Dhm">R QS20ail  r   tshinetiat 20,epucaf="2it hs@anotoye"epuCnsemptiidDocumentation/networking/spider_net.txt#L15" id="L159class="l9ine" name="L3">   39ether93=
   49in th9ef="Documentation/networking/spider_net.txt#L5" id="L5" 9class="l9ine" name="L5">   59
   69The S96=
   79=====97t
   89href=98f="Diu a   9AAbstr99f="Documentation/networking/spider_net.txt#L16" id="L1610 class="liine" name="L10">  10=====>==ucture o d tus x4...  1101===>=1t
Ris RXCOMST_ADocumentation/networking/spider_net.txt#L17" id="L17"0 class="l0ine" name="L12">  1202===>=2f="Documentation/networking/spider_net.txt#L16" id="L1610 class="l0ine" name="L13">  1303===>=3f="DIn et
  1404===>=ef="Df="D foritt s Ra 3  1505===>=ef="Documentation/networking/spider_net.txt#L16" id="L16"0 class="l0ine" name="L16">  1606===>=6===="empty" == SPIDER_NET_DESCR_CARDOWNED == 0xaocumentation/networking/spider_net.txt#L16" id="L16"0 class="l0ine" name="L17">  1707===>======"full"  == SPIDER_NET_DESCR_FRAME_END == 0x4ocumentation/networking/spider_net.txt#L16" id="L16"0 class="l0ine" name="L1tion 2=
=8===="nototn f="" == SPIDER_NET_DESCR_NOT_IN_USE == 0xfocumentation/networking/spider_net.txt#L16" id="L16"0class="l10ine" name="L9">   9109===>=9f="Documentation/networking/spider_net.txt#L16" id="L161" class="lline" name="L10">  10>====110f="Documentation/networking/spider_net.txt#L16" id="L161" class="liine" name="L11">  11T1===>document  12>devi1e driv================
  13>ethe1net deocumentation/networking/spider_net.txt#L1  9A18"" class="lline" name="L14">  14>in t1e SONYAs loetiastth
  15>
A18"" class="lline" name="L16">  16>The 1tructuth
A18"" class="lline" name="L17">  17>====1====== tshi J willoc tcheup iba souhm">,anoticeoreeanot-empty prediking,ocumentation/networking/spider_net.txt#L1  9A18"" class="lline" name="L1tion 2=
   911Abst11ct
Rnumbe   10  11  12ddevi122ocumwillob   etRtn GHIINT1STS).  Whe ker < hrram fullocohdiking occurs,ocumentation/networking/spider_net.txt#L1  9A18"c class="12ine" name="L13">  13  14  15  16  17   912Abst12ct
  10Rtoraocumentation/networking/spider_net.txt#L14" id="L14"c class="l3ine" name="L11">  11lock prediking,iastth
< ail  tshi J willob   tshinetiat er skerscr,ocumentation/networking/spider_net.txt#L14" id="L14"c class="l3ine" name="L2">   213devi132f="Dwhich, fromith
  13eethe133driver skerscr ibab  filled. Howev r,< souhardwaX Rhs@askipped er skerscr,ocumentation/networking/spider_net.txt#L14" id="L14"c class="13ine" name="L14">  14A1813 class="13ine" name="L15">  15lock, withg.

  16  17   913Abst139f="DARcallirba how_rx_chain() at er sk tshitiedic teture ona RX Ring.
  10  11   214devi142drivgabieth1: Sxt#L1i hreAMRfull, tncomnetipacket
   314ethe143=
  14iin t144=
  15Ris  tt255ocumentation/networking/spider_net.txt#L16" id="L1614 class="14ine" name="L16">  16  17   914Abst149=
  10  11   215devi152drivgabieth1: Lastt1   315ethe15et deocumentation/networking/spider_net.txt#L1  9A18"5class="l15ine" name="L4">   415in t154=
R tshi Js  r   tshinetiat descr 255,Mwhiche socumentation/networking/spider_net.txt#L1  9A18"5 class="1iine" name="L5">   51W
A1815 class="15ine" name="L16">  16  17   915Abst159f="Db come non-empty,gwhich, tn et s case,awillonev ruhappegDocumentation/networking/spider_net.txt#L15" id="L1516 class="16ine" name="L10">  10  11   216devi162drivSinccaiis  lrm">y full, 0 CuhardwaX  caVedo notr etimore,M QS20 us hasocumentation/networking/spider_net.txt#L1  9A18"6class="l16ine" name="L3">   316ethe163t
A18"6class="l16ine" name="L4">   416in t164=
A18"6class="l16ine" name="L5">   516
locked,ocumentation/networking/spider_net.txt#L14" id="L14"6 class="liine" name="L16">  16TThe 166t
  17   916Abst169=

 ync_hm">_ptr()ocumentation/networking/spider_net.txt#L9" id="L9" 1c class="17ine" name="L10">  10A1817 class="17ine" name="L11">  11   217devi172ocum souhardwaX Rhs@askipped ardescr orRtwo (someti13s dozens uQS ruheavyocumentation/networking/spider_net.txt#L1  9A1817class="l17ine" name="L3">   317ethe173=

 ync_hm">_ptr()tnRbroutine willocumentation/networking/spider_net.txt#L1  9A1817class="l17ine" name="L4">   417in t174=
   517
A1817class="l17ine" name="L6">   617The 176f="Diu also ais a gi" id >
 ync_ ail_ptr()treat willo kip oLinusu
	 oolesDocumentation/networking/spider_net.txt#L17" id="L17"  class="liine" name="L17">  17=====177f="Documentation/networking/spider_net.txt#L17" id="L17"  class="17ine" name="L1tion 2=

 ync()tntrategyk eemsirbader_iv ryocumentation/networking/spider_net.txt#L17" id="L17" class="l17ine" name="L9">   917Abst179SONYwell,oev VeuQS ruheavy spider_iloadsDocumentation/networking/spider_net.txt#L17" id="L17"8 class="18ine" name="L10">  10  11   218devi182ocumederThrrnetocumentation/networking/spider_net.txt#L2" id="L2" 18class="l18ine" name="L3">   318ethe183=
   418in t184ocumederThrrnet f="s   518
   618The 18ef="Documentation/networking/spider_net.txt#L7" id="L7" 18class="l18ine" name="L7">   718====187=
   918Abst189=
  10A18"9 class="19ine" name="L11">  11   219devi192f="Dsoiiis notoappropriateirbadaitRforitt upolloroutine tor_nfill, sinccocumentation/networking/spider_net.txt#L14" id="L14"9class="l19ine" name="L3">   319ethe193f="D0 Cupolloroutine rupide hreonccaper jiffy.rnet Dlow-watermarkgmephanismocumentation/networking/spider_net.txt#L14" id="L14"9class="l19ine" name="L4">   419in t194=

  ging.
   519
   619The 196=
   719====197=
   819href198SONYern Pi Jrupts, abodde1K/sec. ForR malleripackets, re skwillodrop torzeroocumentation/networking/spider_net.txt#L14" id="L14"9class="l1iine" name="L9">   91AAbst1
   91AAbst1
  11   91A2===>==uct2re o d tus x4...   91A2= 2ef="Doctor"empty". re2oacou20et.txt#L2" id="L2" cclass="liine" name="L2">   2 devi===>=2f="2ocumentation/networking/2pider2net.txt#L16" id="L1610 class="l0ine" name="L13">  1302===>=3f="2In et
A18" class="l18ine" name="L4">   4182===>=ef="2f="D foritt s Ra 3   59
=ef="2ocumentation/networking/2pider2net.tx
">
on/norigmpty LXR.txftL14" entatio#L5" id="http:// aX ococuge.5">LXR.spidunityt.txnetworkexsmoi9claslet.trkingent#L5" id="mailto:lx>@lhref.no">lx>@lhref.not.tx.
ts">">
lx>.lhref.no amed outostcument#L5" id="http://www.redpris-lhrpro.no">Redprisa hrpro ASt.txneprovt="eplerLhref=cnamelon/netnd "v
<"ontationsst
m iu