linux/Documentation/s390/driver-model.txt
<<
>>
Prefs
   1S/390 driver model interfaces
   2-----------------------------
   3
   41. CCW devices
   5--------------
   6
   7All devices which can be addressed by means of ccws are called 'CCW devices' -
   8even if they aren't actually driven by ccws.
   9
  10All ccw devices are accessed via a subchannel, this is reflected in the 
  11structures under devices/:
  12
  13devices/
  14     - system/
  15     - css0/
  16           - 0.0.0000  v2.6.27.13  12
>S/390 driver mo4umentation/s390ction value="v2.17ame="L16">  16      1    -4711.0000  v2.6.27.13  12
>S/390 drier-model1.txt#L8" id="L8" class=1"line18ame="L16">  16      2.0000  v2.6.27.13  12
>S/390 drier-model1.txt#L9" id="L9" class=1"line19ame="L16">  16 1        
	  34.0000  v2.6.27.13  12
>S/390 dr2r-model.2xt#L10" id="L10" class=2line"20ame="L16">  16<..driven by ccws.
  16  12
>S/390 dr2er-model..txt#L2" id="L2" class="line"2name="L12">  12
  12
 4711s areccessed vi 1s isccessed vi set 0, andsccessed vi 2bchaw non-I/O"L12">  12
   34bchaw devices areccessed vi 0s isccessed vi set 1driven by ccws.
   6
   6
  10All ccmovhisto="L6">   6
   8evcdisplr man beanothe s">  10icecomiv  operhref=ai ois reir--------------
  10AlwiL10bccmovhisaga is oaw propersccessed vi--------------
   8  12
  10i areits buubcd (e.g.    -4711);s ref10idev"L12">  12
strbuu/"> /"L13">  .--------------
  12
  10Alexportscome datas arecysf driven by ccws.
  12
S/39driven by ccws.
   9
ise;" /a>S/39,">  applicabledriven by ccws.
   9
39;CCWe="="L9">   9
  16<<<Adriven by ccws.
   9
ion="L1 andsoff="L1driven by ccws.
  16< Iis refspeciai caseesse ref10ibeiv  dis   6
  16</a>str1.2), pipiv  0s oaon="L1 wiL10e="cibnelete="L6">   6
  16driven by ccws.
   9
ientatis devi wh Al oaexportsper-10ieatasands driver modriven by ccws.
   9
asper-ccessed vi bascha(sees/a>st="L9">   9
  )under devices/:
   9
All dhpidse ref10icha   6
   6
Adriven by ccws.
   6
   9
  10="L9">   9
   2--------------="L9">   9
   9
   6
ioneWorsmorefparn vrivs driver mo whe ccparn vrivsidev"L12">  12
  n, essary,e ref10ichafinren&#brou.stiup="L6">   6
   9
  12
  10A"L12">  12
   2----------------------="L9">   9
  12
b"> _10iandscL11">b"> _1  1  11"L12">  12
strinclude/asm/"> 10<.hdriven by ccws.
   6
b"> _10i{devices' -
  spivlock_t *"> lock;devices' -
  "L11">b"> _10_pntaate *pntaate;devices' -
  "L11">b"> _10_ids d;"L16">  devices' -
   3
  "L11">b"> _1  1   devices' -
  "L11">b10ieev;"L16">   ">   devices' -
   draon="L1;devices' -
  12
  vocd (*handler) ("L11">b"> _10i*10<, unsigned lov   drparm,"L12">  12
  16<<<<<<<<<<<<<<<"L11">birb *irb);devices' -
   9
b"> _1  1  "L11">bn/sule0*owner;"L16">   ">devices' -
  "L11">b"> _10_ids*ids;>   ">devices' -
   dra(*pnobe) ("L11">b"> _10i*);>devices' -
   dra(*removh) ("L11">b"> _10i*);devices' -
   dra(*set_on="L1) ("L11">b"> _10i*);devices' -
   dra(*set_off="L1) ("L11">b"> _10i*);devices' -
   dra(*notify) ("L11">b"> _10i*,  dr);devices' -
  "L11">b10_1  1  cha/a* cla;devices' -
   3
   3
ientatidriven by ccws.
   6
All CUise;"s/n/s39A"L12">  12
ise;"s/n/s39A itbcha drivesthid6Trcha de=""href=adevilarivscesfo/a>"L12">  12
is refsL11">b"> _10_idseieldsunder devices/:
   6
b"> _10_ids{devices' -
  __u16>  "hrch_flags;>   devices' -
   3
  __u16>  cu_se;";"L16">  devices' -
  __u16>  10<_se;";"L16"> devices' -
  __u8 >  cu_n/s39;"L16"> devices' -
  __u8 >  10<_n/s39;"L16">devices' -
   6
  unsigned lov  entati_ de=;devices' -
   9
 _1  1cha< of ccbye ref10ilayisrefentatinder devices/:
  bcha drivesthia d. Tref1  1  11nder devices/:
   toe fal is 0<-png"entati_eatasandscreate attributes (>  n,eded). Also,"L12">  12
  1sref drivrupt handlera(seesbelow)ashouldscesset he cdriven by ccws.
  12
b"> _10i*c10<);>devices' -
   9
  1-e ref10itoebe pnobeidriven by ccws.
   9
  12
  12
  1sref10ior1srefn/sule. Tref1  1  12
b"> _10i*c10<);"L12">  12
  12
  -e ref10itoebe removhidriven by ccws.
   9
   6
cha< of ccbye refcommon>I/Oilayich="L6">   6
      >
  aated1 are ref39;CCon="L139;CCWattribute. Tref1  1   6
  16<
  aatee ref10ihe cdriven by ccws.
   9
b"> _10i*);devices' -
   6
    -e ref10itoebe >
  aated. Tref"ommon>lay   6
  16ichanotaalreadyaon="L1driven by ccws.
   9
   6
cha< of ccbye refcommon>I/Oilayich="L6">   6
      f10->
  aated1 are ref39;CCon="L139;CCWattribute. Tref1  1   6
  16<<, butanota10->ofocate its pntaate eatadriven by ccws.
   9
b"> _10i*);devices' -
   6
     -e ref10itoebe de>
  aated. Tref"ommon>lay   6
  16ichaon="L1driven by ccws.
   9
   6
cha< of ccbye refcommon>I/Oilay  sse ref10driven by ccws.
  Sign of cctoe ref1  1  * Iison="L1 ieetachhis(CIO_GONE)ior1#L4tspathsgon>="L9">   9
   s(CIO_NO_PATH). Tref1  1CWe="="L9">   9
  16nn" onsc/s3 0,  ref10iwiL10bcc3eleteds>s usual (wlsoswheneno="L6">   6
  16notify function>channgisrived). Ifisrefentati wantss oakeepe re="L6">   6
  1610, itbchamovhis droedis  * Iisdisioperhref=ai aga is(CIO_OPER). Treriven by ccws.
  16common>I/Oilayinumb"L12">  12
  16DL13"> / CUisoebe reasf=abn&#surps f itbchastiL10 refsamef10driven by ccws.
    Ifinot,  refoldf10icharemovhiawnds> newioneWnngisrived. Bye re="L6">   6
  16nn" onsc/s3 sse refnotify function> ref10ientati sign oss f it="L6">   6
  1 wantss ref10iback:s!0se="bkeeping, 0s oamakee ref10ibeiv ="L6">   6
  16nnmovhiawndsre-nngisrived.="L6">   6
  ="L6">   6
b"> _10i*,  dr);devices' -
   6
  -e ref10iwhose    6
  16<<<<="L8t>  -e ref="L8t> ratshappenhid6TrchadevicesoneWof CIO_GONE,"L12">  12
  16<<<<<<<<<<<<<   6
  12
b"> _10ichamea8t> oscesset toe ref drivrupt"L12">  12
d Iisor>str oawccommodate entatiAll use   12
A)a a subchaaamemb="L9">   9
lay   6
   6
   6
  applicable) aevcpere=""eddriven by ccws.
   9
b"> _10i*10<, unsigned lov   drparm,<"L11">birb *irb);devices' -
   3
  -e ref10itrefhandleracha< of cce="="L9">   9
  16<<<<<< drparm -e ref drparm a>All >ofows> ref10ientati  oaid   9
  16<                ref /oe ref drivruptbchaassociated1with,ior1so nncognize="L6">   6
  16<<               ref drivruptb>s unsolicithidriven by ccws.
  16  -e drivruption>responsebblocksa>All dontainsa refwccumulatedriven by ccws.
  16<<<<<<<<<<<<<<<    6
ientatiacha< of cceromstref"ommon>"> _10ilayretrieats="L6">   6
   3
   9
"> group 10A"L12">  12
   9
  12
 group messedismscha"esigned so handle 10Alconsistiv  osemultiple0"> "L12">  12
A, lik>ilcsior1ctcdriven by ccws.
   6
 ientatiaprovid>haaa39;CCgroup39;CCWattribute. Pipiv  buubcdressed b 10Alto="L6">   6
 group 10lconsistiv  osetresesd b 10Al(> ="L6">   6
 group 10lcevicesset on="L1 orsoff="L1 justalik>iw no""hi--------------
driven by ccws.
  12
 group 10lwlsosprovid>haana39;CCungroup39;CCWattribute so d>htroye ref10"L12">  12
 group messedisms(srefentati do11"L12">  12
removai routives)driven by ccws.
   9
  10ia>All chaaamemb group 10lcarri>Ala po driv toe re="L9">   9
 group 10l is refentati_eatasof its 10l"L11">d6Trchaeieldfmustanotabe="L9">   9
 group 1039;CCsfentati_eatase="b t1"L12">  12
   9
 group 1ntati, pleasee>  ti  oainclude/asm/"> group.h. Keepeiv"L12">  12
 group wnds> "> "L12">  12
   6
   9
  12
   9
  12
iccessed vis,>/a>strtref"sed vi sub 14  12
eans of ccws archp0.<dhpidght.ps ar. Trey havefnof1  1i/pno /dhpidse is2.4,rtref"sed vi pathsobjecthannel, triven by ccws.
ia>lcevnot  racke re="L9">   9
ldoen if thn,ed  oabe >w>ea="L9">   9
   9
   9
  1Pipiv  39;CCon39;CCWors39;CCoff39;CCWsetsrtref"spidflogicallyaon="L1/off="L1driven by ccws.
   Pipiv  39;CCon39;CCW oawn on="L1 "spidftriggti   7  1tref"spidf  1af"sed vi pathstrefushr knows> oiceson="L1, butasrefnall"L1 hasen if triven by ccws.
  1createds> nall"L1 checkae="driven by ccws.
   6
   6
   6
   6
  12
   7   2---riven by ccws.
  12
   6
---riven by ccws.
   6
str"L13">   14s n if xpramps ar.="L9">   9
   6
---riven by ccws.
   3
str"L13">   14  12
   6
  12
   7   2---riven by ccws.
   6
   6
   2   6
   3
st="L9">   9
   6
  12
str"L13">  iucvmb>s nquot;netiucv<ifnumght.pquot;. Tref driver m"L12">  12
  12
  12
   9
   3
  12
  16<<<<<<<<<<<<<<<<<  12
   6
  12



Treforiginre LXR softw>easbye refL12"> 12http://sourceforge.net/pnojecth/lxv">LXR "ommunityame=a a subexperi 12mailto:lxv@d="ux.no">lxv@d="ux.noame=.
lxv.d="ux.no kindlyahosthisbyeL12"> 12http://www.redpill-d="pno.no">Redpill L="pno ASame=a provid>/asseL="uxadonsultiv andsoperhref=1bserAlsinc>i1995.