sd.c 76 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889
  1. /*
  2. * sd.c Copyright (C) 1992 Drew Eckhardt
  3. * Copyright (C) 1993, 1994, 1995, 1999 Eric Youngdale
  4. *
  5. * Linux scsi disk driver
  6. * Initial versions: Drew Eckhardt
  7. * Subsequent revisions: Eric Youngdale
  8. * Modification history:
  9. * - Drew Eckhardt <drew@colorado.edu> original
  10. * - Eric Youngdale <eric@andante.org> add scatter-gather, multiple
  11. * outstanding request, and other enhancements.
  12. * Support loadable low-level scsi drivers.
  13. * - Jirka Hanika <geo@ff.cuni.cz> support more scsi disks using
  14. * eight major numbers.
  15. * - Richard Gooch <rgooch@atnf.csiro.au> support devfs.
  16. * - Torben Mathiasen <tmm@image.dk> Resource allocation fixes in
  17. * sd_init and cleanups.
  18. * - Alex Davis <letmein@erols.com> Fix problem where partition info
  19. * not being read in sd_open. Fix problem where removable media
  20. * could be ejected after sd_open.
  21. * - Douglas Gilbert <dgilbert@interlog.com> cleanup for lk 2.5.x
  22. * - Badari Pulavarty <pbadari@us.ibm.com>, Matthew Wilcox
  23. * <willy@debian.org>, Kurt Garloff <garloff@suse.de>:
  24. * Support 32k/1M disks.
  25. *
  26. * Logging policy (needs CONFIG_SCSI_LOGGING defined):
  27. * - setting up transfer: SCSI_LOG_HLQUEUE levels 1 and 2
  28. * - end of transfer (bh + scsi_lib): SCSI_LOG_HLCOMPLETE level 1
  29. * - entering sd_ioctl: SCSI_LOG_IOCTL level 1
  30. * - entering other commands: SCSI_LOG_HLQUEUE level 3
  31. * Note: when the logging level is set by the user, it must be greater
  32. * than the level indicated above to trigger output.
  33. */
  34. #include <linux/module.h>
  35. #include <linux/fs.h>
  36. #include <linux/kernel.h>
  37. #include <linux/mm.h>
  38. #include <linux/bio.h>
  39. #include <linux/genhd.h>
  40. #include <linux/hdreg.h>
  41. #include <linux/errno.h>
  42. #include <linux/idr.h>
  43. #include <linux/interrupt.h>
  44. #include <linux/init.h>
  45. #include <linux/blkdev.h>
  46. #include <linux/blkpg.h>
  47. #include <linux/delay.h>
  48. #include <linux/mutex.h>
  49. #include <linux/string_helpers.h>
  50. #include <linux/async.h>
  51. #include <linux/slab.h>
  52. #include <asm/uaccess.h>
  53. #include <asm/unaligned.h>
  54. #include <scsi/scsi.h>
  55. #include <scsi/scsi_cmnd.h>
  56. #include <scsi/scsi_dbg.h>
  57. #include <scsi/scsi_device.h>
  58. #include <scsi/scsi_driver.h>
  59. #include <scsi/scsi_eh.h>
  60. #include <scsi/scsi_host.h>
  61. #include <scsi/scsi_ioctl.h>
  62. #include <scsi/scsicam.h>
  63. #include "sd.h"
  64. #include "scsi_logging.h"
  65. MODULE_AUTHOR("Eric Youngdale");
  66. MODULE_DESCRIPTION("SCSI disk (sd) driver");
  67. MODULE_LICENSE("GPL");
  68. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK0_MAJOR);
  69. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK1_MAJOR);
  70. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK2_MAJOR);
  71. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK3_MAJOR);
  72. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK4_MAJOR);
  73. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK5_MAJOR);
  74. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK6_MAJOR);
  75. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK7_MAJOR);
  76. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK8_MAJOR);
  77. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK9_MAJOR);
  78. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK10_MAJOR);
  79. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK11_MAJOR);
  80. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK12_MAJOR);
  81. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK13_MAJOR);
  82. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK14_MAJOR);
  83. MODULE_ALIAS_BLOCKDEV_MAJOR(SCSI_DISK15_MAJOR);
  84. MODULE_ALIAS_SCSI_DEVICE(TYPE_DISK);
  85. MODULE_ALIAS_SCSI_DEVICE(TYPE_MOD);
  86. MODULE_ALIAS_SCSI_DEVICE(TYPE_RBC);
  87. #if !defined(CONFIG_DEBUG_BLOCK_EXT_DEVT)
  88. #define SD_MINORS 16
  89. #else
  90. #define SD_MINORS 0
  91. #endif
  92. static void sd_config_discard(struct scsi_disk *, unsigned int);
  93. static int sd_revalidate_disk(struct gendisk *);
  94. static void sd_unlock_native_capacity(struct gendisk *disk);
  95. static int sd_probe(struct device *);
  96. static int sd_remove(struct device *);
  97. static void sd_shutdown(struct device *);
  98. static int sd_suspend(struct device *, pm_message_t state);
  99. static int sd_resume(struct device *);
  100. static void sd_rescan(struct device *);
  101. static int sd_done(struct scsi_cmnd *);
  102. static void sd_read_capacity(struct scsi_disk *sdkp, unsigned char *buffer);
  103. static void scsi_disk_release(struct device *cdev);
  104. static void sd_print_sense_hdr(struct scsi_disk *, struct scsi_sense_hdr *);
  105. static void sd_print_result(struct scsi_disk *, int);
  106. static DEFINE_SPINLOCK(sd_index_lock);
  107. static DEFINE_IDA(sd_index_ida);
  108. /* This semaphore is used to mediate the 0->1 reference get in the
  109. * face of object destruction (i.e. we can't allow a get on an
  110. * object after last put) */
  111. static DEFINE_MUTEX(sd_ref_mutex);
  112. static struct kmem_cache *sd_cdb_cache;
  113. static mempool_t *sd_cdb_pool;
  114. static const char *sd_cache_types[] = {
  115. "write through", "none", "write back",
  116. "write back, no read (daft)"
  117. };
  118. static ssize_t
  119. sd_store_cache_type(struct device *dev, struct device_attribute *attr,
  120. const char *buf, size_t count)
  121. {
  122. int i, ct = -1, rcd, wce, sp;
  123. struct scsi_disk *sdkp = to_scsi_disk(dev);
  124. struct scsi_device *sdp = sdkp->device;
  125. char buffer[64];
  126. char *buffer_data;
  127. struct scsi_mode_data data;
  128. struct scsi_sense_hdr sshdr;
  129. int len;
  130. if (sdp->type != TYPE_DISK)
  131. /* no cache control on RBC devices; theoretically they
  132. * can do it, but there's probably so many exceptions
  133. * it's not worth the risk */
  134. return -EINVAL;
  135. for (i = 0; i < ARRAY_SIZE(sd_cache_types); i++) {
  136. len = strlen(sd_cache_types[i]);
  137. if (strncmp(sd_cache_types[i], buf, len) == 0 &&
  138. buf[len] == '\n') {
  139. ct = i;
  140. break;
  141. }
  142. }
  143. if (ct < 0)
  144. return -EINVAL;
  145. rcd = ct & 0x01 ? 1 : 0;
  146. wce = ct & 0x02 ? 1 : 0;
  147. if (scsi_mode_sense(sdp, 0x08, 8, buffer, sizeof(buffer), SD_TIMEOUT,
  148. SD_MAX_RETRIES, &data, NULL))
  149. return -EINVAL;
  150. len = min_t(size_t, sizeof(buffer), data.length - data.header_length -
  151. data.block_descriptor_length);
  152. buffer_data = buffer + data.header_length +
  153. data.block_descriptor_length;
  154. buffer_data[2] &= ~0x05;
  155. buffer_data[2] |= wce << 2 | rcd;
  156. sp = buffer_data[0] & 0x80 ? 1 : 0;
  157. if (scsi_mode_select(sdp, 1, sp, 8, buffer_data, len, SD_TIMEOUT,
  158. SD_MAX_RETRIES, &data, &sshdr)) {
  159. if (scsi_sense_valid(&sshdr))
  160. sd_print_sense_hdr(sdkp, &sshdr);
  161. return -EINVAL;
  162. }
  163. revalidate_disk(sdkp->disk);
  164. return count;
  165. }
  166. static ssize_t
  167. sd_store_manage_start_stop(struct device *dev, struct device_attribute *attr,
  168. const char *buf, size_t count)
  169. {
  170. struct scsi_disk *sdkp = to_scsi_disk(dev);
  171. struct scsi_device *sdp = sdkp->device;
  172. if (!capable(CAP_SYS_ADMIN))
  173. return -EACCES;
  174. sdp->manage_start_stop = simple_strtoul(buf, NULL, 10);
  175. return count;
  176. }
  177. static ssize_t
  178. sd_store_allow_restart(struct device *dev, struct device_attribute *attr,
  179. const char *buf, size_t count)
  180. {
  181. struct scsi_disk *sdkp = to_scsi_disk(dev);
  182. struct scsi_device *sdp = sdkp->device;
  183. if (!capable(CAP_SYS_ADMIN))
  184. return -EACCES;
  185. if (sdp->type != TYPE_DISK)
  186. return -EINVAL;
  187. sdp->allow_restart = simple_strtoul(buf, NULL, 10);
  188. return count;
  189. }
  190. static ssize_t
  191. sd_show_cache_type(struct device *dev, struct device_attribute *attr,
  192. char *buf)
  193. {
  194. struct scsi_disk *sdkp = to_scsi_disk(dev);
  195. int ct = sdkp->RCD + 2*sdkp->WCE;
  196. return snprintf(buf, 40, "%s\n", sd_cache_types[ct]);
  197. }
  198. static ssize_t
  199. sd_show_fua(struct device *dev, struct device_attribute *attr, char *buf)
  200. {
  201. struct scsi_disk *sdkp = to_scsi_disk(dev);
  202. return snprintf(buf, 20, "%u\n", sdkp->DPOFUA);
  203. }
  204. static ssize_t
  205. sd_show_manage_start_stop(struct device *dev, struct device_attribute *attr,
  206. char *buf)
  207. {
  208. struct scsi_disk *sdkp = to_scsi_disk(dev);
  209. struct scsi_device *sdp = sdkp->device;
  210. return snprintf(buf, 20, "%u\n", sdp->manage_start_stop);
  211. }
  212. static ssize_t
  213. sd_show_allow_restart(struct device *dev, struct device_attribute *attr,
  214. char *buf)
  215. {
  216. struct scsi_disk *sdkp = to_scsi_disk(dev);
  217. return snprintf(buf, 40, "%d\n", sdkp->device->allow_restart);
  218. }
  219. static ssize_t
  220. sd_show_protection_type(struct device *dev, struct device_attribute *attr,
  221. char *buf)
  222. {
  223. struct scsi_disk *sdkp = to_scsi_disk(dev);
  224. return snprintf(buf, 20, "%u\n", sdkp->protection_type);
  225. }
  226. static ssize_t
  227. sd_show_protection_mode(struct device *dev, struct device_attribute *attr,
  228. char *buf)
  229. {
  230. struct scsi_disk *sdkp = to_scsi_disk(dev);
  231. struct scsi_device *sdp = sdkp->device;
  232. unsigned int dif, dix;
  233. dif = scsi_host_dif_capable(sdp->host, sdkp->protection_type);
  234. dix = scsi_host_dix_capable(sdp->host, sdkp->protection_type);
  235. if (!dix && scsi_host_dix_capable(sdp->host, SD_DIF_TYPE0_PROTECTION)) {
  236. dif = 0;
  237. dix = 1;
  238. }
  239. if (!dif && !dix)
  240. return snprintf(buf, 20, "none\n");
  241. return snprintf(buf, 20, "%s%u\n", dix ? "dix" : "dif", dif);
  242. }
  243. static ssize_t
  244. sd_show_app_tag_own(struct device *dev, struct device_attribute *attr,
  245. char *buf)
  246. {
  247. struct scsi_disk *sdkp = to_scsi_disk(dev);
  248. return snprintf(buf, 20, "%u\n", sdkp->ATO);
  249. }
  250. static ssize_t
  251. sd_show_thin_provisioning(struct device *dev, struct device_attribute *attr,
  252. char *buf)
  253. {
  254. struct scsi_disk *sdkp = to_scsi_disk(dev);
  255. return snprintf(buf, 20, "%u\n", sdkp->lbpme);
  256. }
  257. static const char *lbp_mode[] = {
  258. [SD_LBP_FULL] = "full",
  259. [SD_LBP_UNMAP] = "unmap",
  260. [SD_LBP_WS16] = "writesame_16",
  261. [SD_LBP_WS10] = "writesame_10",
  262. [SD_LBP_ZERO] = "writesame_zero",
  263. [SD_LBP_DISABLE] = "disabled",
  264. };
  265. static ssize_t
  266. sd_show_provisioning_mode(struct device *dev, struct device_attribute *attr,
  267. char *buf)
  268. {
  269. struct scsi_disk *sdkp = to_scsi_disk(dev);
  270. return snprintf(buf, 20, "%s\n", lbp_mode[sdkp->provisioning_mode]);
  271. }
  272. static ssize_t
  273. sd_store_provisioning_mode(struct device *dev, struct device_attribute *attr,
  274. const char *buf, size_t count)
  275. {
  276. struct scsi_disk *sdkp = to_scsi_disk(dev);
  277. struct scsi_device *sdp = sdkp->device;
  278. if (!capable(CAP_SYS_ADMIN))
  279. return -EACCES;
  280. if (sdp->type != TYPE_DISK)
  281. return -EINVAL;
  282. if (!strncmp(buf, lbp_mode[SD_LBP_UNMAP], 20))
  283. sd_config_discard(sdkp, SD_LBP_UNMAP);
  284. else if (!strncmp(buf, lbp_mode[SD_LBP_WS16], 20))
  285. sd_config_discard(sdkp, SD_LBP_WS16);
  286. else if (!strncmp(buf, lbp_mode[SD_LBP_WS10], 20))
  287. sd_config_discard(sdkp, SD_LBP_WS10);
  288. else if (!strncmp(buf, lbp_mode[SD_LBP_ZERO], 20))
  289. sd_config_discard(sdkp, SD_LBP_ZERO);
  290. else if (!strncmp(buf, lbp_mode[SD_LBP_DISABLE], 20))
  291. sd_config_discard(sdkp, SD_LBP_DISABLE);
  292. else
  293. return -EINVAL;
  294. return count;
  295. }
  296. static struct device_attribute sd_disk_attrs[] = {
  297. __ATTR(cache_type, S_IRUGO|S_IWUSR, sd_show_cache_type,
  298. sd_store_cache_type),
  299. __ATTR(FUA, S_IRUGO, sd_show_fua, NULL),
  300. __ATTR(allow_restart, S_IRUGO|S_IWUSR, sd_show_allow_restart,
  301. sd_store_allow_restart),
  302. __ATTR(manage_start_stop, S_IRUGO|S_IWUSR, sd_show_manage_start_stop,
  303. sd_store_manage_start_stop),
  304. __ATTR(protection_type, S_IRUGO, sd_show_protection_type, NULL),
  305. __ATTR(protection_mode, S_IRUGO, sd_show_protection_mode, NULL),
  306. __ATTR(app_tag_own, S_IRUGO, sd_show_app_tag_own, NULL),
  307. __ATTR(thin_provisioning, S_IRUGO, sd_show_thin_provisioning, NULL),
  308. __ATTR(provisioning_mode, S_IRUGO|S_IWUSR, sd_show_provisioning_mode,
  309. sd_store_provisioning_mode),
  310. __ATTR_NULL,
  311. };
  312. static struct class sd_disk_class = {
  313. .name = "scsi_disk",
  314. .owner = THIS_MODULE,
  315. .dev_release = scsi_disk_release,
  316. .dev_attrs = sd_disk_attrs,
  317. };
  318. static struct scsi_driver sd_template = {
  319. .owner = THIS_MODULE,
  320. .gendrv = {
  321. .name = "sd",
  322. .probe = sd_probe,
  323. .remove = sd_remove,
  324. .suspend = sd_suspend,
  325. .resume = sd_resume,
  326. .shutdown = sd_shutdown,
  327. },
  328. .rescan = sd_rescan,
  329. .done = sd_done,
  330. };
  331. /*
  332. * Device no to disk mapping:
  333. *
  334. * major disc2 disc p1
  335. * |............|.............|....|....| <- dev_t
  336. * 31 20 19 8 7 4 3 0
  337. *
  338. * Inside a major, we have 16k disks, however mapped non-
  339. * contiguously. The first 16 disks are for major0, the next
  340. * ones with major1, ... Disk 256 is for major0 again, disk 272
  341. * for major1, ...
  342. * As we stay compatible with our numbering scheme, we can reuse
  343. * the well-know SCSI majors 8, 65--71, 136--143.
  344. */
  345. static int sd_major(int major_idx)
  346. {
  347. switch (major_idx) {
  348. case 0:
  349. return SCSI_DISK0_MAJOR;
  350. case 1 ... 7:
  351. return SCSI_DISK1_MAJOR + major_idx - 1;
  352. case 8 ... 15:
  353. return SCSI_DISK8_MAJOR + major_idx - 8;
  354. default:
  355. BUG();
  356. return 0; /* shut up gcc */
  357. }
  358. }
  359. static struct scsi_disk *__scsi_disk_get(struct gendisk *disk)
  360. {
  361. struct scsi_disk *sdkp = NULL;
  362. if (disk->private_data) {
  363. sdkp = scsi_disk(disk);
  364. if (scsi_device_get(sdkp->device) == 0)
  365. get_device(&sdkp->dev);
  366. else
  367. sdkp = NULL;
  368. }
  369. return sdkp;
  370. }
  371. static struct scsi_disk *scsi_disk_get(struct gendisk *disk)
  372. {
  373. struct scsi_disk *sdkp;
  374. mutex_lock(&sd_ref_mutex);
  375. sdkp = __scsi_disk_get(disk);
  376. mutex_unlock(&sd_ref_mutex);
  377. return sdkp;
  378. }
  379. static struct scsi_disk *scsi_disk_get_from_dev(struct device *dev)
  380. {
  381. struct scsi_disk *sdkp;
  382. mutex_lock(&sd_ref_mutex);
  383. sdkp = dev_get_drvdata(dev);
  384. if (sdkp)
  385. sdkp = __scsi_disk_get(sdkp->disk);
  386. mutex_unlock(&sd_ref_mutex);
  387. return sdkp;
  388. }
  389. static void scsi_disk_put(struct scsi_disk *sdkp)
  390. {
  391. struct scsi_device *sdev = sdkp->device;
  392. mutex_lock(&sd_ref_mutex);
  393. put_device(&sdkp->dev);
  394. scsi_device_put(sdev);
  395. mutex_unlock(&sd_ref_mutex);
  396. }
  397. static void sd_prot_op(struct scsi_cmnd *scmd, unsigned int dif)
  398. {
  399. unsigned int prot_op = SCSI_PROT_NORMAL;
  400. unsigned int dix = scsi_prot_sg_count(scmd);
  401. if (scmd->sc_data_direction == DMA_FROM_DEVICE) {
  402. if (dif && dix)
  403. prot_op = SCSI_PROT_READ_PASS;
  404. else if (dif && !dix)
  405. prot_op = SCSI_PROT_READ_STRIP;
  406. else if (!dif && dix)
  407. prot_op = SCSI_PROT_READ_INSERT;
  408. } else {
  409. if (dif && dix)
  410. prot_op = SCSI_PROT_WRITE_PASS;
  411. else if (dif && !dix)
  412. prot_op = SCSI_PROT_WRITE_INSERT;
  413. else if (!dif && dix)
  414. prot_op = SCSI_PROT_WRITE_STRIP;
  415. }
  416. scsi_set_prot_op(scmd, prot_op);
  417. scsi_set_prot_type(scmd, dif);
  418. }
  419. static void sd_config_discard(struct scsi_disk *sdkp, unsigned int mode)
  420. {
  421. struct request_queue *q = sdkp->disk->queue;
  422. unsigned int logical_block_size = sdkp->device->sector_size;
  423. unsigned int max_blocks = 0;
  424. q->limits.discard_zeroes_data = sdkp->lbprz;
  425. q->limits.discard_alignment = sdkp->unmap_alignment *
  426. logical_block_size;
  427. q->limits.discard_granularity =
  428. max(sdkp->physical_block_size,
  429. sdkp->unmap_granularity * logical_block_size);
  430. switch (mode) {
  431. case SD_LBP_DISABLE:
  432. q->limits.max_discard_sectors = 0;
  433. queue_flag_clear_unlocked(QUEUE_FLAG_DISCARD, q);
  434. return;
  435. case SD_LBP_UNMAP:
  436. max_blocks = min_not_zero(sdkp->max_unmap_blocks, 0xffffffff);
  437. break;
  438. case SD_LBP_WS16:
  439. max_blocks = min_not_zero(sdkp->max_ws_blocks, 0xffffffff);
  440. break;
  441. case SD_LBP_WS10:
  442. max_blocks = min_not_zero(sdkp->max_ws_blocks, (u32)0xffff);
  443. break;
  444. case SD_LBP_ZERO:
  445. max_blocks = min_not_zero(sdkp->max_ws_blocks, (u32)0xffff);
  446. q->limits.discard_zeroes_data = 1;
  447. break;
  448. }
  449. q->limits.max_discard_sectors = max_blocks * (logical_block_size >> 9);
  450. queue_flag_set_unlocked(QUEUE_FLAG_DISCARD, q);
  451. sdkp->provisioning_mode = mode;
  452. }
  453. /**
  454. * scsi_setup_discard_cmnd - unmap blocks on thinly provisioned device
  455. * @sdp: scsi device to operate one
  456. * @rq: Request to prepare
  457. *
  458. * Will issue either UNMAP or WRITE SAME(16) depending on preference
  459. * indicated by target device.
  460. **/
  461. static int scsi_setup_discard_cmnd(struct scsi_device *sdp, struct request *rq)
  462. {
  463. struct scsi_disk *sdkp = scsi_disk(rq->rq_disk);
  464. struct bio *bio = rq->bio;
  465. sector_t sector = bio->bi_sector;
  466. unsigned int nr_sectors = bio_sectors(bio);
  467. unsigned int len;
  468. int ret;
  469. char *buf;
  470. struct page *page;
  471. if (sdkp->device->sector_size == 4096) {
  472. sector >>= 3;
  473. nr_sectors >>= 3;
  474. }
  475. rq->timeout = SD_TIMEOUT;
  476. memset(rq->cmd, 0, rq->cmd_len);
  477. page = alloc_page(GFP_ATOMIC | __GFP_ZERO);
  478. if (!page)
  479. return BLKPREP_DEFER;
  480. switch (sdkp->provisioning_mode) {
  481. case SD_LBP_UNMAP:
  482. buf = page_address(page);
  483. rq->cmd_len = 10;
  484. rq->cmd[0] = UNMAP;
  485. rq->cmd[8] = 24;
  486. put_unaligned_be16(6 + 16, &buf[0]);
  487. put_unaligned_be16(16, &buf[2]);
  488. put_unaligned_be64(sector, &buf[8]);
  489. put_unaligned_be32(nr_sectors, &buf[16]);
  490. len = 24;
  491. break;
  492. case SD_LBP_WS16:
  493. rq->cmd_len = 16;
  494. rq->cmd[0] = WRITE_SAME_16;
  495. rq->cmd[1] = 0x8; /* UNMAP */
  496. put_unaligned_be64(sector, &rq->cmd[2]);
  497. put_unaligned_be32(nr_sectors, &rq->cmd[10]);
  498. len = sdkp->device->sector_size;
  499. break;
  500. case SD_LBP_WS10:
  501. case SD_LBP_ZERO:
  502. rq->cmd_len = 10;
  503. rq->cmd[0] = WRITE_SAME;
  504. if (sdkp->provisioning_mode == SD_LBP_WS10)
  505. rq->cmd[1] = 0x8; /* UNMAP */
  506. put_unaligned_be32(sector, &rq->cmd[2]);
  507. put_unaligned_be16(nr_sectors, &rq->cmd[7]);
  508. len = sdkp->device->sector_size;
  509. break;
  510. default:
  511. ret = BLKPREP_KILL;
  512. goto out;
  513. }
  514. blk_add_request_payload(rq, page, len);
  515. ret = scsi_setup_blk_pc_cmnd(sdp, rq);
  516. rq->buffer = page_address(page);
  517. out:
  518. if (ret != BLKPREP_OK) {
  519. __free_page(page);
  520. rq->buffer = NULL;
  521. }
  522. return ret;
  523. }
  524. static int scsi_setup_flush_cmnd(struct scsi_device *sdp, struct request *rq)
  525. {
  526. rq->timeout = SD_FLUSH_TIMEOUT;
  527. rq->retries = SD_MAX_RETRIES;
  528. rq->cmd[0] = SYNCHRONIZE_CACHE;
  529. rq->cmd_len = 10;
  530. return scsi_setup_blk_pc_cmnd(sdp, rq);
  531. }
  532. static void sd_unprep_fn(struct request_queue *q, struct request *rq)
  533. {
  534. if (rq->cmd_flags & REQ_DISCARD) {
  535. free_page((unsigned long)rq->buffer);
  536. rq->buffer = NULL;
  537. }
  538. }
  539. /**
  540. * sd_init_command - build a scsi (read or write) command from
  541. * information in the request structure.
  542. * @SCpnt: pointer to mid-level's per scsi command structure that
  543. * contains request and into which the scsi command is written
  544. *
  545. * Returns 1 if successful and 0 if error (or cannot be done now).
  546. **/
  547. static int sd_prep_fn(struct request_queue *q, struct request *rq)
  548. {
  549. struct scsi_cmnd *SCpnt;
  550. struct scsi_device *sdp = q->queuedata;
  551. struct gendisk *disk = rq->rq_disk;
  552. struct scsi_disk *sdkp;
  553. sector_t block = blk_rq_pos(rq);
  554. sector_t threshold;
  555. unsigned int this_count = blk_rq_sectors(rq);
  556. int ret, host_dif;
  557. unsigned char protect;
  558. /*
  559. * Discard request come in as REQ_TYPE_FS but we turn them into
  560. * block PC requests to make life easier.
  561. */
  562. if (rq->cmd_flags & REQ_DISCARD) {
  563. ret = scsi_setup_discard_cmnd(sdp, rq);
  564. goto out;
  565. } else if (rq->cmd_flags & REQ_FLUSH) {
  566. ret = scsi_setup_flush_cmnd(sdp, rq);
  567. goto out;
  568. } else if (rq->cmd_type == REQ_TYPE_BLOCK_PC) {
  569. ret = scsi_setup_blk_pc_cmnd(sdp, rq);
  570. goto out;
  571. } else if (rq->cmd_type != REQ_TYPE_FS) {
  572. ret = BLKPREP_KILL;
  573. goto out;
  574. }
  575. ret = scsi_setup_fs_cmnd(sdp, rq);
  576. if (ret != BLKPREP_OK)
  577. goto out;
  578. SCpnt = rq->special;
  579. sdkp = scsi_disk(disk);
  580. /* from here on until we're complete, any goto out
  581. * is used for a killable error condition */
  582. ret = BLKPREP_KILL;
  583. SCSI_LOG_HLQUEUE(1, scmd_printk(KERN_INFO, SCpnt,
  584. "sd_init_command: block=%llu, "
  585. "count=%d\n",
  586. (unsigned long long)block,
  587. this_count));
  588. if (!sdp || !scsi_device_online(sdp) ||
  589. block + blk_rq_sectors(rq) > get_capacity(disk)) {
  590. SCSI_LOG_HLQUEUE(2, scmd_printk(KERN_INFO, SCpnt,
  591. "Finishing %u sectors\n",
  592. blk_rq_sectors(rq)));
  593. SCSI_LOG_HLQUEUE(2, scmd_printk(KERN_INFO, SCpnt,
  594. "Retry with 0x%p\n", SCpnt));
  595. goto out;
  596. }
  597. if (sdp->changed) {
  598. /*
  599. * quietly refuse to do anything to a changed disc until
  600. * the changed bit has been reset
  601. */
  602. /* printk("SCSI disk has been changed or is not present. Prohibiting further I/O.\n"); */
  603. goto out;
  604. }
  605. /*
  606. * Some SD card readers can't handle multi-sector accesses which touch
  607. * the last one or two hardware sectors. Split accesses as needed.
  608. */
  609. threshold = get_capacity(disk) - SD_LAST_BUGGY_SECTORS *
  610. (sdp->sector_size / 512);
  611. if (unlikely(sdp->last_sector_bug && block + this_count > threshold)) {
  612. if (block < threshold) {
  613. /* Access up to the threshold but not beyond */
  614. this_count = threshold - block;
  615. } else {
  616. /* Access only a single hardware sector */
  617. this_count = sdp->sector_size / 512;
  618. }
  619. }
  620. SCSI_LOG_HLQUEUE(2, scmd_printk(KERN_INFO, SCpnt, "block=%llu\n",
  621. (unsigned long long)block));
  622. /*
  623. * If we have a 1K hardware sectorsize, prevent access to single
  624. * 512 byte sectors. In theory we could handle this - in fact
  625. * the scsi cdrom driver must be able to handle this because
  626. * we typically use 1K blocksizes, and cdroms typically have
  627. * 2K hardware sectorsizes. Of course, things are simpler
  628. * with the cdrom, since it is read-only. For performance
  629. * reasons, the filesystems should be able to handle this
  630. * and not force the scsi disk driver to use bounce buffers
  631. * for this.
  632. */
  633. if (sdp->sector_size == 1024) {
  634. if ((block & 1) || (blk_rq_sectors(rq) & 1)) {
  635. scmd_printk(KERN_ERR, SCpnt,
  636. "Bad block number requested\n");
  637. goto out;
  638. } else {
  639. block = block >> 1;
  640. this_count = this_count >> 1;
  641. }
  642. }
  643. if (sdp->sector_size == 2048) {
  644. if ((block & 3) || (blk_rq_sectors(rq) & 3)) {
  645. scmd_printk(KERN_ERR, SCpnt,
  646. "Bad block number requested\n");
  647. goto out;
  648. } else {
  649. block = block >> 2;
  650. this_count = this_count >> 2;
  651. }
  652. }
  653. if (sdp->sector_size == 4096) {
  654. if ((block & 7) || (blk_rq_sectors(rq) & 7)) {
  655. scmd_printk(KERN_ERR, SCpnt,
  656. "Bad block number requested\n");
  657. goto out;
  658. } else {
  659. block = block >> 3;
  660. this_count = this_count >> 3;
  661. }
  662. }
  663. if (rq_data_dir(rq) == WRITE) {
  664. if (!sdp->writeable) {
  665. goto out;
  666. }
  667. SCpnt->cmnd[0] = WRITE_6;
  668. SCpnt->sc_data_direction = DMA_TO_DEVICE;
  669. if (blk_integrity_rq(rq) &&
  670. sd_dif_prepare(rq, block, sdp->sector_size) == -EIO)
  671. goto out;
  672. } else if (rq_data_dir(rq) == READ) {
  673. SCpnt->cmnd[0] = READ_6;
  674. SCpnt->sc_data_direction = DMA_FROM_DEVICE;
  675. } else {
  676. scmd_printk(KERN_ERR, SCpnt, "Unknown command %x\n", rq->cmd_flags);
  677. goto out;
  678. }
  679. SCSI_LOG_HLQUEUE(2, scmd_printk(KERN_INFO, SCpnt,
  680. "%s %d/%u 512 byte blocks.\n",
  681. (rq_data_dir(rq) == WRITE) ?
  682. "writing" : "reading", this_count,
  683. blk_rq_sectors(rq)));
  684. /* Set RDPROTECT/WRPROTECT if disk is formatted with DIF */
  685. host_dif = scsi_host_dif_capable(sdp->host, sdkp->protection_type);
  686. if (host_dif)
  687. protect = 1 << 5;
  688. else
  689. protect = 0;
  690. if (host_dif == SD_DIF_TYPE2_PROTECTION) {
  691. SCpnt->cmnd = mempool_alloc(sd_cdb_pool, GFP_ATOMIC);
  692. if (unlikely(SCpnt->cmnd == NULL)) {
  693. ret = BLKPREP_DEFER;
  694. goto out;
  695. }
  696. SCpnt->cmd_len = SD_EXT_CDB_SIZE;
  697. memset(SCpnt->cmnd, 0, SCpnt->cmd_len);
  698. SCpnt->cmnd[0] = VARIABLE_LENGTH_CMD;
  699. SCpnt->cmnd[7] = 0x18;
  700. SCpnt->cmnd[9] = (rq_data_dir(rq) == READ) ? READ_32 : WRITE_32;
  701. SCpnt->cmnd[10] = protect | ((rq->cmd_flags & REQ_FUA) ? 0x8 : 0);
  702. /* LBA */
  703. SCpnt->cmnd[12] = sizeof(block) > 4 ? (unsigned char) (block >> 56) & 0xff : 0;
  704. SCpnt->cmnd[13] = sizeof(block) > 4 ? (unsigned char) (block >> 48) & 0xff : 0;
  705. SCpnt->cmnd[14] = sizeof(block) > 4 ? (unsigned char) (block >> 40) & 0xff : 0;
  706. SCpnt->cmnd[15] = sizeof(block) > 4 ? (unsigned char) (block >> 32) & 0xff : 0;
  707. SCpnt->cmnd[16] = (unsigned char) (block >> 24) & 0xff;
  708. SCpnt->cmnd[17] = (unsigned char) (block >> 16) & 0xff;
  709. SCpnt->cmnd[18] = (unsigned char) (block >> 8) & 0xff;
  710. SCpnt->cmnd[19] = (unsigned char) block & 0xff;
  711. /* Expected Indirect LBA */
  712. SCpnt->cmnd[20] = (unsigned char) (block >> 24) & 0xff;
  713. SCpnt->cmnd[21] = (unsigned char) (block >> 16) & 0xff;
  714. SCpnt->cmnd[22] = (unsigned char) (block >> 8) & 0xff;
  715. SCpnt->cmnd[23] = (unsigned char) block & 0xff;
  716. /* Transfer length */
  717. SCpnt->cmnd[28] = (unsigned char) (this_count >> 24) & 0xff;
  718. SCpnt->cmnd[29] = (unsigned char) (this_count >> 16) & 0xff;
  719. SCpnt->cmnd[30] = (unsigned char) (this_count >> 8) & 0xff;
  720. SCpnt->cmnd[31] = (unsigned char) this_count & 0xff;
  721. } else if (block > 0xffffffff) {
  722. SCpnt->cmnd[0] += READ_16 - READ_6;
  723. SCpnt->cmnd[1] = protect | ((rq->cmd_flags & REQ_FUA) ? 0x8 : 0);
  724. SCpnt->cmnd[2] = sizeof(block) > 4 ? (unsigned char) (block >> 56) & 0xff : 0;
  725. SCpnt->cmnd[3] = sizeof(block) > 4 ? (unsigned char) (block >> 48) & 0xff : 0;
  726. SCpnt->cmnd[4] = sizeof(block) > 4 ? (unsigned char) (block >> 40) & 0xff : 0;
  727. SCpnt->cmnd[5] = sizeof(block) > 4 ? (unsigned char) (block >> 32) & 0xff : 0;
  728. SCpnt->cmnd[6] = (unsigned char) (block >> 24) & 0xff;
  729. SCpnt->cmnd[7] = (unsigned char) (block >> 16) & 0xff;
  730. SCpnt->cmnd[8] = (unsigned char) (block >> 8) & 0xff;
  731. SCpnt->cmnd[9] = (unsigned char) block & 0xff;
  732. SCpnt->cmnd[10] = (unsigned char) (this_count >> 24) & 0xff;
  733. SCpnt->cmnd[11] = (unsigned char) (this_count >> 16) & 0xff;
  734. SCpnt->cmnd[12] = (unsigned char) (this_count >> 8) & 0xff;
  735. SCpnt->cmnd[13] = (unsigned char) this_count & 0xff;
  736. SCpnt->cmnd[14] = SCpnt->cmnd[15] = 0;
  737. } else if ((this_count > 0xff) || (block > 0x1fffff) ||
  738. scsi_device_protection(SCpnt->device) ||
  739. SCpnt->device->use_10_for_rw) {
  740. if (this_count > 0xffff)
  741. this_count = 0xffff;
  742. SCpnt->cmnd[0] += READ_10 - READ_6;
  743. SCpnt->cmnd[1] = protect | ((rq->cmd_flags & REQ_FUA) ? 0x8 : 0);
  744. SCpnt->cmnd[2] = (unsigned char) (block >> 24) & 0xff;
  745. SCpnt->cmnd[3] = (unsigned char) (block >> 16) & 0xff;
  746. SCpnt->cmnd[4] = (unsigned char) (block >> 8) & 0xff;
  747. SCpnt->cmnd[5] = (unsigned char) block & 0xff;
  748. SCpnt->cmnd[6] = SCpnt->cmnd[9] = 0;
  749. SCpnt->cmnd[7] = (unsigned char) (this_count >> 8) & 0xff;
  750. SCpnt->cmnd[8] = (unsigned char) this_count & 0xff;
  751. } else {
  752. if (unlikely(rq->cmd_flags & REQ_FUA)) {
  753. /*
  754. * This happens only if this drive failed
  755. * 10byte rw command with ILLEGAL_REQUEST
  756. * during operation and thus turned off
  757. * use_10_for_rw.
  758. */
  759. scmd_printk(KERN_ERR, SCpnt,
  760. "FUA write on READ/WRITE(6) drive\n");
  761. goto out;
  762. }
  763. SCpnt->cmnd[1] |= (unsigned char) ((block >> 16) & 0x1f);
  764. SCpnt->cmnd[2] = (unsigned char) ((block >> 8) & 0xff);
  765. SCpnt->cmnd[3] = (unsigned char) block & 0xff;
  766. SCpnt->cmnd[4] = (unsigned char) this_count;
  767. SCpnt->cmnd[5] = 0;
  768. }
  769. SCpnt->sdb.length = this_count * sdp->sector_size;
  770. /* If DIF or DIX is enabled, tell HBA how to handle request */
  771. if (host_dif || scsi_prot_sg_count(SCpnt))
  772. sd_prot_op(SCpnt, host_dif);
  773. /*
  774. * We shouldn't disconnect in the middle of a sector, so with a dumb
  775. * host adapter, it's safe to assume that we can at least transfer
  776. * this many bytes between each connect / disconnect.
  777. */
  778. SCpnt->transfersize = sdp->sector_size;
  779. SCpnt->underflow = this_count << 9;
  780. SCpnt->allowed = SD_MAX_RETRIES;
  781. /*
  782. * This indicates that the command is ready from our end to be
  783. * queued.
  784. */
  785. ret = BLKPREP_OK;
  786. out:
  787. return scsi_prep_return(q, rq, ret);
  788. }
  789. /**
  790. * sd_open - open a scsi disk device
  791. * @inode: only i_rdev member may be used
  792. * @filp: only f_mode and f_flags may be used
  793. *
  794. * Returns 0 if successful. Returns a negated errno value in case
  795. * of error.
  796. *
  797. * Note: This can be called from a user context (e.g. fsck(1) )
  798. * or from within the kernel (e.g. as a result of a mount(1) ).
  799. * In the latter case @inode and @filp carry an abridged amount
  800. * of information as noted above.
  801. *
  802. * Locking: called with bdev->bd_mutex held.
  803. **/
  804. static int sd_open(struct block_device *bdev, fmode_t mode)
  805. {
  806. struct scsi_disk *sdkp = scsi_disk_get(bdev->bd_disk);
  807. struct scsi_device *sdev;
  808. int retval;
  809. if (!sdkp)
  810. return -ENXIO;
  811. SCSI_LOG_HLQUEUE(3, sd_printk(KERN_INFO, sdkp, "sd_open\n"));
  812. sdev = sdkp->device;
  813. retval = scsi_autopm_get_device(sdev);
  814. if (retval)
  815. goto error_autopm;
  816. /*
  817. * If the device is in error recovery, wait until it is done.
  818. * If the device is offline, then disallow any access to it.
  819. */
  820. retval = -ENXIO;
  821. if (!scsi_block_when_processing_errors(sdev))
  822. goto error_out;
  823. if (sdev->removable || sdkp->write_prot)
  824. check_disk_change(bdev);
  825. /*
  826. * If the drive is empty, just let the open fail.
  827. */
  828. retval = -ENOMEDIUM;
  829. if (sdev->removable && !sdkp->media_present && !(mode & FMODE_NDELAY))
  830. goto error_out;
  831. /*
  832. * If the device has the write protect tab set, have the open fail
  833. * if the user expects to be able to write to the thing.
  834. */
  835. retval = -EROFS;
  836. if (sdkp->write_prot && (mode & FMODE_WRITE))
  837. goto error_out;
  838. /*
  839. * It is possible that the disk changing stuff resulted in
  840. * the device being taken offline. If this is the case,
  841. * report this to the user, and don't pretend that the
  842. * open actually succeeded.
  843. */
  844. retval = -ENXIO;
  845. if (!scsi_device_online(sdev))
  846. goto error_out;
  847. if ((atomic_inc_return(&sdkp->openers) == 1) && sdev->removable) {
  848. if (scsi_block_when_processing_errors(sdev))
  849. scsi_set_medium_removal(sdev, SCSI_REMOVAL_PREVENT);
  850. }
  851. return 0;
  852. error_out:
  853. scsi_autopm_put_device(sdev);
  854. error_autopm:
  855. scsi_disk_put(sdkp);
  856. return retval;
  857. }
  858. /**
  859. * sd_release - invoked when the (last) close(2) is called on this
  860. * scsi disk.
  861. * @inode: only i_rdev member may be used
  862. * @filp: only f_mode and f_flags may be used
  863. *
  864. * Returns 0.
  865. *
  866. * Note: may block (uninterruptible) if error recovery is underway
  867. * on this disk.
  868. *
  869. * Locking: called with bdev->bd_mutex held.
  870. **/
  871. static int sd_release(struct gendisk *disk, fmode_t mode)
  872. {
  873. struct scsi_disk *sdkp = scsi_disk(disk);
  874. struct scsi_device *sdev = sdkp->device;
  875. SCSI_LOG_HLQUEUE(3, sd_printk(KERN_INFO, sdkp, "sd_release\n"));
  876. if (atomic_dec_return(&sdkp->openers) == 0 && sdev->removable) {
  877. if (scsi_block_when_processing_errors(sdev))
  878. scsi_set_medium_removal(sdev, SCSI_REMOVAL_ALLOW);
  879. }
  880. /*
  881. * XXX and what if there are packets in flight and this close()
  882. * XXX is followed by a "rmmod sd_mod"?
  883. */
  884. scsi_autopm_put_device(sdev);
  885. scsi_disk_put(sdkp);
  886. return 0;
  887. }
  888. static int sd_getgeo(struct block_device *bdev, struct hd_geometry *geo)
  889. {
  890. struct scsi_disk *sdkp = scsi_disk(bdev->bd_disk);
  891. struct scsi_device *sdp = sdkp->device;
  892. struct Scsi_Host *host = sdp->host;
  893. int diskinfo[4];
  894. /* default to most commonly used values */
  895. diskinfo[0] = 0x40; /* 1 << 6 */
  896. diskinfo[1] = 0x20; /* 1 << 5 */
  897. diskinfo[2] = sdkp->capacity >> 11;
  898. /* override with calculated, extended default, or driver values */
  899. if (host->hostt->bios_param)
  900. host->hostt->bios_param(sdp, bdev, sdkp->capacity, diskinfo);
  901. else
  902. scsicam_bios_param(bdev, sdkp->capacity, diskinfo);
  903. geo->heads = diskinfo[0];
  904. geo->sectors = diskinfo[1];
  905. geo->cylinders = diskinfo[2];
  906. return 0;
  907. }
  908. /**
  909. * sd_ioctl - process an ioctl
  910. * @inode: only i_rdev/i_bdev members may be used
  911. * @filp: only f_mode and f_flags may be used
  912. * @cmd: ioctl command number
  913. * @arg: this is third argument given to ioctl(2) system call.
  914. * Often contains a pointer.
  915. *
  916. * Returns 0 if successful (some ioctls return positive numbers on
  917. * success as well). Returns a negated errno value in case of error.
  918. *
  919. * Note: most ioctls are forward onto the block subsystem or further
  920. * down in the scsi subsystem.
  921. **/
  922. static int sd_ioctl(struct block_device *bdev, fmode_t mode,
  923. unsigned int cmd, unsigned long arg)
  924. {
  925. struct gendisk *disk = bdev->bd_disk;
  926. struct scsi_disk *sdkp = scsi_disk(disk);
  927. struct scsi_device *sdp = sdkp->device;
  928. void __user *p = (void __user *)arg;
  929. int error;
  930. SCSI_LOG_IOCTL(1, sd_printk(KERN_INFO, sdkp, "sd_ioctl: disk=%s, "
  931. "cmd=0x%x\n", disk->disk_name, cmd));
  932. /*
  933. * If we are in the middle of error recovery, don't let anyone
  934. * else try and use this device. Also, if error recovery fails, it
  935. * may try and take the device offline, in which case all further
  936. * access to the device is prohibited.
  937. */
  938. error = scsi_nonblockable_ioctl(sdp, cmd, p,
  939. (mode & FMODE_NDELAY) != 0);
  940. if (!scsi_block_when_processing_errors(sdp) || !error)
  941. goto out;
  942. /*
  943. * Send SCSI addressing ioctls directly to mid level, send other
  944. * ioctls to block level and then onto mid level if they can't be
  945. * resolved.
  946. */
  947. switch (cmd) {
  948. case SCSI_IOCTL_GET_IDLUN:
  949. case SCSI_IOCTL_GET_BUS_NUMBER:
  950. error = scsi_ioctl(sdp, cmd, p);
  951. break;
  952. default:
  953. error = scsi_cmd_ioctl(disk->queue, disk, mode, cmd, p);
  954. if (error != -ENOTTY)
  955. break;
  956. error = scsi_ioctl(sdp, cmd, p);
  957. break;
  958. }
  959. out:
  960. return error;
  961. }
  962. static void set_media_not_present(struct scsi_disk *sdkp)
  963. {
  964. if (sdkp->media_present)
  965. sdkp->device->changed = 1;
  966. if (sdkp->device->removable) {
  967. sdkp->media_present = 0;
  968. sdkp->capacity = 0;
  969. }
  970. }
  971. static int media_not_present(struct scsi_disk *sdkp,
  972. struct scsi_sense_hdr *sshdr)
  973. {
  974. if (!scsi_sense_valid(sshdr))
  975. return 0;
  976. /* not invoked for commands that could return deferred errors */
  977. switch (sshdr->sense_key) {
  978. case UNIT_ATTENTION:
  979. case NOT_READY:
  980. /* medium not present */
  981. if (sshdr->asc == 0x3A) {
  982. set_media_not_present(sdkp);
  983. return 1;
  984. }
  985. }
  986. return 0;
  987. }
  988. /**
  989. * sd_check_events - check media events
  990. * @disk: kernel device descriptor
  991. * @clearing: disk events currently being cleared
  992. *
  993. * Returns mask of DISK_EVENT_*.
  994. *
  995. * Note: this function is invoked from the block subsystem.
  996. **/
  997. static unsigned int sd_check_events(struct gendisk *disk, unsigned int clearing)
  998. {
  999. struct scsi_disk *sdkp = scsi_disk(disk);
  1000. struct scsi_device *sdp = sdkp->device;
  1001. struct scsi_sense_hdr *sshdr = NULL;
  1002. int retval;
  1003. SCSI_LOG_HLQUEUE(3, sd_printk(KERN_INFO, sdkp, "sd_check_events\n"));
  1004. /*
  1005. * If the device is offline, don't send any commands - just pretend as
  1006. * if the command failed. If the device ever comes back online, we
  1007. * can deal with it then. It is only because of unrecoverable errors
  1008. * that we would ever take a device offline in the first place.
  1009. */
  1010. if (!scsi_device_online(sdp)) {
  1011. set_media_not_present(sdkp);
  1012. goto out;
  1013. }
  1014. /*
  1015. * Using TEST_UNIT_READY enables differentiation between drive with
  1016. * no cartridge loaded - NOT READY, drive with changed cartridge -
  1017. * UNIT ATTENTION, or with same cartridge - GOOD STATUS.
  1018. *
  1019. * Drives that auto spin down. eg iomega jaz 1G, will be started
  1020. * by sd_spinup_disk() from sd_revalidate_disk(), which happens whenever
  1021. * sd_revalidate() is called.
  1022. */
  1023. retval = -ENODEV;
  1024. if (scsi_block_when_processing_errors(sdp)) {
  1025. sshdr = kzalloc(sizeof(*sshdr), GFP_KERNEL);
  1026. retval = scsi_test_unit_ready(sdp, SD_TIMEOUT, SD_MAX_RETRIES,
  1027. sshdr);
  1028. }
  1029. /* failed to execute TUR, assume media not present */
  1030. if (host_byte(retval)) {
  1031. set_media_not_present(sdkp);
  1032. goto out;
  1033. }
  1034. if (media_not_present(sdkp, sshdr))
  1035. goto out;
  1036. /*
  1037. * For removable scsi disk we have to recognise the presence
  1038. * of a disk in the drive.
  1039. */
  1040. if (!sdkp->media_present)
  1041. sdp->changed = 1;
  1042. sdkp->media_present = 1;
  1043. out:
  1044. /*
  1045. * sdp->changed is set under the following conditions:
  1046. *
  1047. * Medium present state has changed in either direction.
  1048. * Device has indicated UNIT_ATTENTION.
  1049. */
  1050. kfree(sshdr);
  1051. retval = sdp->changed ? DISK_EVENT_MEDIA_CHANGE : 0;
  1052. sdp->changed = 0;
  1053. return retval;
  1054. }
  1055. static int sd_sync_cache(struct scsi_disk *sdkp)
  1056. {
  1057. int retries, res;
  1058. struct scsi_device *sdp = sdkp->device;
  1059. struct scsi_sense_hdr sshdr;
  1060. if (!scsi_device_online(sdp))
  1061. return -ENODEV;
  1062. for (retries = 3; retries > 0; --retries) {
  1063. unsigned char cmd[10] = { 0 };
  1064. cmd[0] = SYNCHRONIZE_CACHE;
  1065. /*
  1066. * Leave the rest of the command zero to indicate
  1067. * flush everything.
  1068. */
  1069. res = scsi_execute_req(sdp, cmd, DMA_NONE, NULL, 0, &sshdr,
  1070. SD_FLUSH_TIMEOUT, SD_MAX_RETRIES, NULL);
  1071. if (res == 0)
  1072. break;
  1073. }
  1074. if (res) {
  1075. sd_print_result(sdkp, res);
  1076. if (driver_byte(res) & DRIVER_SENSE)
  1077. sd_print_sense_hdr(sdkp, &sshdr);
  1078. }
  1079. if (res)
  1080. return -EIO;
  1081. return 0;
  1082. }
  1083. static void sd_rescan(struct device *dev)
  1084. {
  1085. struct scsi_disk *sdkp = scsi_disk_get_from_dev(dev);
  1086. if (sdkp) {
  1087. revalidate_disk(sdkp->disk);
  1088. scsi_disk_put(sdkp);
  1089. }
  1090. }
  1091. #ifdef CONFIG_COMPAT
  1092. /*
  1093. * This gets directly called from VFS. When the ioctl
  1094. * is not recognized we go back to the other translation paths.
  1095. */
  1096. static int sd_compat_ioctl(struct block_device *bdev, fmode_t mode,
  1097. unsigned int cmd, unsigned long arg)
  1098. {
  1099. struct scsi_device *sdev = scsi_disk(bdev->bd_disk)->device;
  1100. /*
  1101. * If we are in the middle of error recovery, don't let anyone
  1102. * else try and use this device. Also, if error recovery fails, it
  1103. * may try and take the device offline, in which case all further
  1104. * access to the device is prohibited.
  1105. */
  1106. if (!scsi_block_when_processing_errors(sdev))
  1107. return -ENODEV;
  1108. if (sdev->host->hostt->compat_ioctl) {
  1109. int ret;
  1110. ret = sdev->host->hostt->compat_ioctl(sdev, cmd, (void __user *)arg);
  1111. return ret;
  1112. }
  1113. /*
  1114. * Let the static ioctl translation table take care of it.
  1115. */
  1116. return -ENOIOCTLCMD;
  1117. }
  1118. #endif
  1119. static const struct block_device_operations sd_fops = {
  1120. .owner = THIS_MODULE,
  1121. .open = sd_open,
  1122. .release = sd_release,
  1123. .ioctl = sd_ioctl,
  1124. .getgeo = sd_getgeo,
  1125. #ifdef CONFIG_COMPAT
  1126. .compat_ioctl = sd_compat_ioctl,
  1127. #endif
  1128. .check_events = sd_check_events,
  1129. .revalidate_disk = sd_revalidate_disk,
  1130. .unlock_native_capacity = sd_unlock_native_capacity,
  1131. };
  1132. static unsigned int sd_completed_bytes(struct scsi_cmnd *scmd)
  1133. {
  1134. u64 start_lba = blk_rq_pos(scmd->request);
  1135. u64 end_lba = blk_rq_pos(scmd->request) + (scsi_bufflen(scmd) / 512);
  1136. u64 bad_lba;
  1137. int info_valid;
  1138. /*
  1139. * resid is optional but mostly filled in. When it's unused,
  1140. * its value is zero, so we assume the whole buffer transferred
  1141. */
  1142. unsigned int transferred = scsi_bufflen(scmd) - scsi_get_resid(scmd);
  1143. unsigned int good_bytes;
  1144. if (scmd->request->cmd_type != REQ_TYPE_FS)
  1145. return 0;
  1146. info_valid = scsi_get_sense_info_fld(scmd->sense_buffer,
  1147. SCSI_SENSE_BUFFERSIZE,
  1148. &bad_lba);
  1149. if (!info_valid)
  1150. return 0;
  1151. if (scsi_bufflen(scmd) <= scmd->device->sector_size)
  1152. return 0;
  1153. if (scmd->device->sector_size < 512) {
  1154. /* only legitimate sector_size here is 256 */
  1155. start_lba <<= 1;
  1156. end_lba <<= 1;
  1157. } else {
  1158. /* be careful ... don't want any overflows */
  1159. u64 factor = scmd->device->sector_size / 512;
  1160. do_div(start_lba, factor);
  1161. do_div(end_lba, factor);
  1162. }
  1163. /* The bad lba was reported incorrectly, we have no idea where
  1164. * the error is.
  1165. */
  1166. if (bad_lba < start_lba || bad_lba >= end_lba)
  1167. return 0;
  1168. /* This computation should always be done in terms of
  1169. * the resolution of the device's medium.
  1170. */
  1171. good_bytes = (bad_lba - start_lba) * scmd->device->sector_size;
  1172. return min(good_bytes, transferred);
  1173. }
  1174. /**
  1175. * sd_done - bottom half handler: called when the lower level
  1176. * driver has completed (successfully or otherwise) a scsi command.
  1177. * @SCpnt: mid-level's per command structure.
  1178. *
  1179. * Note: potentially run from within an ISR. Must not block.
  1180. **/
  1181. static int sd_done(struct scsi_cmnd *SCpnt)
  1182. {
  1183. int result = SCpnt->result;
  1184. unsigned int good_bytes = result ? 0 : scsi_bufflen(SCpnt);
  1185. struct scsi_sense_hdr sshdr;
  1186. struct scsi_disk *sdkp = scsi_disk(SCpnt->request->rq_disk);
  1187. int sense_valid = 0;
  1188. int sense_deferred = 0;
  1189. unsigned char op = SCpnt->cmnd[0];
  1190. if ((SCpnt->request->cmd_flags & REQ_DISCARD) && !result)
  1191. scsi_set_resid(SCpnt, 0);
  1192. if (result) {
  1193. sense_valid = scsi_command_normalize_sense(SCpnt, &sshdr);
  1194. if (sense_valid)
  1195. sense_deferred = scsi_sense_is_deferred(&sshdr);
  1196. }
  1197. #ifdef CONFIG_SCSI_LOGGING
  1198. SCSI_LOG_HLCOMPLETE(1, scsi_print_result(SCpnt));
  1199. if (sense_valid) {
  1200. SCSI_LOG_HLCOMPLETE(1, scmd_printk(KERN_INFO, SCpnt,
  1201. "sd_done: sb[respc,sk,asc,"
  1202. "ascq]=%x,%x,%x,%x\n",
  1203. sshdr.response_code,
  1204. sshdr.sense_key, sshdr.asc,
  1205. sshdr.ascq));
  1206. }
  1207. #endif
  1208. if (driver_byte(result) != DRIVER_SENSE &&
  1209. (!sense_valid || sense_deferred))
  1210. goto out;
  1211. switch (sshdr.sense_key) {
  1212. case HARDWARE_ERROR:
  1213. case MEDIUM_ERROR:
  1214. good_bytes = sd_completed_bytes(SCpnt);
  1215. break;
  1216. case RECOVERED_ERROR:
  1217. good_bytes = scsi_bufflen(SCpnt);
  1218. break;
  1219. case NO_SENSE:
  1220. /* This indicates a false check condition, so ignore it. An
  1221. * unknown amount of data was transferred so treat it as an
  1222. * error.
  1223. */
  1224. scsi_print_sense("sd", SCpnt);
  1225. SCpnt->result = 0;
  1226. memset(SCpnt->sense_buffer, 0, SCSI_SENSE_BUFFERSIZE);
  1227. break;
  1228. case ABORTED_COMMAND:
  1229. if (sshdr.asc == 0x10) /* DIF: Target detected corruption */
  1230. good_bytes = sd_completed_bytes(SCpnt);
  1231. break;
  1232. case ILLEGAL_REQUEST:
  1233. if (sshdr.asc == 0x10) /* DIX: Host detected corruption */
  1234. good_bytes = sd_completed_bytes(SCpnt);
  1235. /* INVALID COMMAND OPCODE or INVALID FIELD IN CDB */
  1236. if ((sshdr.asc == 0x20 || sshdr.asc == 0x24) &&
  1237. (op == UNMAP || op == WRITE_SAME_16 || op == WRITE_SAME))
  1238. sd_config_discard(sdkp, SD_LBP_DISABLE);
  1239. break;
  1240. default:
  1241. break;
  1242. }
  1243. out:
  1244. if (rq_data_dir(SCpnt->request) == READ && scsi_prot_sg_count(SCpnt))
  1245. sd_dif_complete(SCpnt, good_bytes);
  1246. if (scsi_host_dif_capable(sdkp->device->host, sdkp->protection_type)
  1247. == SD_DIF_TYPE2_PROTECTION && SCpnt->cmnd != SCpnt->request->cmd) {
  1248. /* We have to print a failed command here as the
  1249. * extended CDB gets freed before scsi_io_completion()
  1250. * is called.
  1251. */
  1252. if (result)
  1253. scsi_print_command(SCpnt);
  1254. mempool_free(SCpnt->cmnd, sd_cdb_pool);
  1255. SCpnt->cmnd = NULL;
  1256. SCpnt->cmd_len = 0;
  1257. }
  1258. return good_bytes;
  1259. }
  1260. /*
  1261. * spinup disk - called only in sd_revalidate_disk()
  1262. */
  1263. static void
  1264. sd_spinup_disk(struct scsi_disk *sdkp)
  1265. {
  1266. unsigned char cmd[10];
  1267. unsigned long spintime_expire = 0;
  1268. int retries, spintime;
  1269. unsigned int the_result;
  1270. struct scsi_sense_hdr sshdr;
  1271. int sense_valid = 0;
  1272. spintime = 0;
  1273. /* Spin up drives, as required. Only do this at boot time */
  1274. /* Spinup needs to be done for module loads too. */
  1275. do {
  1276. retries = 0;
  1277. do {
  1278. cmd[0] = TEST_UNIT_READY;
  1279. memset((void *) &cmd[1], 0, 9);
  1280. the_result = scsi_execute_req(sdkp->device, cmd,
  1281. DMA_NONE, NULL, 0,
  1282. &sshdr, SD_TIMEOUT,
  1283. SD_MAX_RETRIES, NULL);
  1284. /*
  1285. * If the drive has indicated to us that it
  1286. * doesn't have any media in it, don't bother
  1287. * with any more polling.
  1288. */
  1289. if (media_not_present(sdkp, &sshdr))
  1290. return;
  1291. if (the_result)
  1292. sense_valid = scsi_sense_valid(&sshdr);
  1293. retries++;
  1294. } while (retries < 3 &&
  1295. (!scsi_status_is_good(the_result) ||
  1296. ((driver_byte(the_result) & DRIVER_SENSE) &&
  1297. sense_valid && sshdr.sense_key == UNIT_ATTENTION)));
  1298. if ((driver_byte(the_result) & DRIVER_SENSE) == 0) {
  1299. /* no sense, TUR either succeeded or failed
  1300. * with a status error */
  1301. if(!spintime && !scsi_status_is_good(the_result)) {
  1302. sd_printk(KERN_NOTICE, sdkp, "Unit Not Ready\n");
  1303. sd_print_result(sdkp, the_result);
  1304. }
  1305. break;
  1306. }
  1307. /*
  1308. * The device does not want the automatic start to be issued.
  1309. */
  1310. if (sdkp->device->no_start_on_add)
  1311. break;
  1312. if (sense_valid && sshdr.sense_key == NOT_READY) {
  1313. if (sshdr.asc == 4 && sshdr.ascq == 3)
  1314. break; /* manual intervention required */
  1315. if (sshdr.asc == 4 && sshdr.ascq == 0xb)
  1316. break; /* standby */
  1317. if (sshdr.asc == 4 && sshdr.ascq == 0xc)
  1318. break; /* unavailable */
  1319. /*
  1320. * Issue command to spin up drive when not ready
  1321. */
  1322. if (!spintime) {
  1323. sd_printk(KERN_NOTICE, sdkp, "Spinning up disk...");
  1324. cmd[0] = START_STOP;
  1325. cmd[1] = 1; /* Return immediately */
  1326. memset((void *) &cmd[2], 0, 8);
  1327. cmd[4] = 1; /* Start spin cycle */
  1328. if (sdkp->device->start_stop_pwr_cond)
  1329. cmd[4] |= 1 << 4;
  1330. scsi_execute_req(sdkp->device, cmd, DMA_NONE,
  1331. NULL, 0, &sshdr,
  1332. SD_TIMEOUT, SD_MAX_RETRIES,
  1333. NULL);
  1334. spintime_expire = jiffies + 100 * HZ;
  1335. spintime = 1;
  1336. }
  1337. /* Wait 1 second for next try */
  1338. msleep(1000);
  1339. printk(".");
  1340. /*
  1341. * Wait for USB flash devices with slow firmware.
  1342. * Yes, this sense key/ASC combination shouldn't
  1343. * occur here. It's characteristic of these devices.
  1344. */
  1345. } else if (sense_valid &&
  1346. sshdr.sense_key == UNIT_ATTENTION &&
  1347. sshdr.asc == 0x28) {
  1348. if (!spintime) {
  1349. spintime_expire = jiffies + 5 * HZ;
  1350. spintime = 1;
  1351. }
  1352. /* Wait 1 second for next try */
  1353. msleep(1000);
  1354. } else {
  1355. /* we don't understand the sense code, so it's
  1356. * probably pointless to loop */
  1357. if(!spintime) {
  1358. sd_printk(KERN_NOTICE, sdkp, "Unit Not Ready\n");
  1359. sd_print_sense_hdr(sdkp, &sshdr);
  1360. }
  1361. break;
  1362. }
  1363. } while (spintime && time_before_eq(jiffies, spintime_expire));
  1364. if (spintime) {
  1365. if (scsi_status_is_good(the_result))
  1366. printk("ready\n");
  1367. else
  1368. printk("not responding...\n");
  1369. }
  1370. }
  1371. /*
  1372. * Determine whether disk supports Data Integrity Field.
  1373. */
  1374. static void sd_read_protection_type(struct scsi_disk *sdkp, unsigned char *buffer)
  1375. {
  1376. struct scsi_device *sdp = sdkp->device;
  1377. u8 type;
  1378. if (scsi_device_protection(sdp) == 0 || (buffer[12] & 1) == 0)
  1379. return;
  1380. type = ((buffer[12] >> 1) & 7) + 1; /* P_TYPE 0 = Type 1 */
  1381. if (type == sdkp->protection_type || !sdkp->first_scan)
  1382. return;
  1383. sdkp->protection_type = type;
  1384. if (type > SD_DIF_TYPE3_PROTECTION) {
  1385. sd_printk(KERN_ERR, sdkp, "formatted with unsupported " \
  1386. "protection type %u. Disabling disk!\n", type);
  1387. sdkp->capacity = 0;
  1388. return;
  1389. }
  1390. if (scsi_host_dif_capable(sdp->host, type))
  1391. sd_printk(KERN_NOTICE, sdkp,
  1392. "Enabling DIF Type %u protection\n", type);
  1393. else
  1394. sd_printk(KERN_NOTICE, sdkp,
  1395. "Disabling DIF Type %u protection\n", type);
  1396. }
  1397. static void read_capacity_error(struct scsi_disk *sdkp, struct scsi_device *sdp,
  1398. struct scsi_sense_hdr *sshdr, int sense_valid,
  1399. int the_result)
  1400. {
  1401. sd_print_result(sdkp, the_result);
  1402. if (driver_byte(the_result) & DRIVER_SENSE)
  1403. sd_print_sense_hdr(sdkp, sshdr);
  1404. else
  1405. sd_printk(KERN_NOTICE, sdkp, "Sense not available.\n");
  1406. /*
  1407. * Set dirty bit for removable devices if not ready -
  1408. * sometimes drives will not report this properly.
  1409. */
  1410. if (sdp->removable &&
  1411. sense_valid && sshdr->sense_key == NOT_READY)
  1412. set_media_not_present(sdkp);
  1413. /*
  1414. * We used to set media_present to 0 here to indicate no media
  1415. * in the drive, but some drives fail read capacity even with
  1416. * media present, so we can't do that.
  1417. */
  1418. sdkp->capacity = 0; /* unknown mapped to zero - as usual */
  1419. }
  1420. #define RC16_LEN 32
  1421. #if RC16_LEN > SD_BUF_SIZE
  1422. #error RC16_LEN must not be more than SD_BUF_SIZE
  1423. #endif
  1424. #define READ_CAPACITY_RETRIES_ON_RESET 10
  1425. static int read_capacity_16(struct scsi_disk *sdkp, struct scsi_device *sdp,
  1426. unsigned char *buffer)
  1427. {
  1428. unsigned char cmd[16];
  1429. struct scsi_sense_hdr sshdr;
  1430. int sense_valid = 0;
  1431. int the_result;
  1432. int retries = 3, reset_retries = READ_CAPACITY_RETRIES_ON_RESET;
  1433. unsigned int alignment;
  1434. unsigned long long lba;
  1435. unsigned sector_size;
  1436. if (sdp->no_read_capacity_16)
  1437. return -EINVAL;
  1438. do {
  1439. memset(cmd, 0, 16);
  1440. cmd[0] = SERVICE_ACTION_IN;
  1441. cmd[1] = SAI_READ_CAPACITY_16;
  1442. cmd[13] = RC16_LEN;
  1443. memset(buffer, 0, RC16_LEN);
  1444. the_result = scsi_execute_req(sdp, cmd, DMA_FROM_DEVICE,
  1445. buffer, RC16_LEN, &sshdr,
  1446. SD_TIMEOUT, SD_MAX_RETRIES, NULL);
  1447. if (media_not_present(sdkp, &sshdr))
  1448. return -ENODEV;
  1449. if (the_result) {
  1450. sense_valid = scsi_sense_valid(&sshdr);
  1451. if (sense_valid &&
  1452. sshdr.sense_key == ILLEGAL_REQUEST &&
  1453. (sshdr.asc == 0x20 || sshdr.asc == 0x24) &&
  1454. sshdr.ascq == 0x00)
  1455. /* Invalid Command Operation Code or
  1456. * Invalid Field in CDB, just retry
  1457. * silently with RC10 */
  1458. return -EINVAL;
  1459. if (sense_valid &&
  1460. sshdr.sense_key == UNIT_ATTENTION &&
  1461. sshdr.asc == 0x29 && sshdr.ascq == 0x00)
  1462. /* Device reset might occur several times,
  1463. * give it one more chance */
  1464. if (--reset_retries > 0)
  1465. continue;
  1466. }
  1467. retries--;
  1468. } while (the_result && retries);
  1469. if (the_result) {
  1470. sd_printk(KERN_NOTICE, sdkp, "READ CAPACITY(16) failed\n");
  1471. read_capacity_error(sdkp, sdp, &sshdr, sense_valid, the_result);
  1472. return -EINVAL;
  1473. }
  1474. sector_size = get_unaligned_be32(&buffer[8]);
  1475. lba = get_unaligned_be64(&buffer[0]);
  1476. sd_read_protection_type(sdkp, buffer);
  1477. if ((sizeof(sdkp->capacity) == 4) && (lba >= 0xffffffffULL)) {
  1478. sd_printk(KERN_ERR, sdkp, "Too big for this kernel. Use a "
  1479. "kernel compiled with support for large block "
  1480. "devices.\n");
  1481. sdkp->capacity = 0;
  1482. return -EOVERFLOW;
  1483. }
  1484. /* Logical blocks per physical block exponent */
  1485. sdkp->physical_block_size = (1 << (buffer[13] & 0xf)) * sector_size;
  1486. /* Lowest aligned logical block */
  1487. alignment = ((buffer[14] & 0x3f) << 8 | buffer[15]) * sector_size;
  1488. blk_queue_alignment_offset(sdp->request_queue, alignment);
  1489. if (alignment && sdkp->first_scan)
  1490. sd_printk(KERN_NOTICE, sdkp,
  1491. "physical block alignment offset: %u\n", alignment);
  1492. if (buffer[14] & 0x80) { /* LBPME */
  1493. sdkp->lbpme = 1;
  1494. if (buffer[14] & 0x40) /* LBPRZ */
  1495. sdkp->lbprz = 1;
  1496. sd_config_discard(sdkp, SD_LBP_WS16);
  1497. }
  1498. sdkp->capacity = lba + 1;
  1499. return sector_size;
  1500. }
  1501. static int read_capacity_10(struct scsi_disk *sdkp, struct scsi_device *sdp,
  1502. unsigned char *buffer)
  1503. {
  1504. unsigned char cmd[16];
  1505. struct scsi_sense_hdr sshdr;
  1506. int sense_valid = 0;
  1507. int the_result;
  1508. int retries = 3, reset_retries = READ_CAPACITY_RETRIES_ON_RESET;
  1509. sector_t lba;
  1510. unsigned sector_size;
  1511. do {
  1512. cmd[0] = READ_CAPACITY;
  1513. memset(&cmd[1], 0, 9);
  1514. memset(buffer, 0, 8);
  1515. the_result = scsi_execute_req(sdp, cmd, DMA_FROM_DEVICE,
  1516. buffer, 8, &sshdr,
  1517. SD_TIMEOUT, SD_MAX_RETRIES, NULL);
  1518. if (media_not_present(sdkp, &sshdr))
  1519. return -ENODEV;
  1520. if (the_result) {
  1521. sense_valid = scsi_sense_valid(&sshdr);
  1522. if (sense_valid &&
  1523. sshdr.sense_key == UNIT_ATTENTION &&
  1524. sshdr.asc == 0x29 && sshdr.ascq == 0x00)
  1525. /* Device reset might occur several times,
  1526. * give it one more chance */
  1527. if (--reset_retries > 0)
  1528. continue;
  1529. }
  1530. retries--;
  1531. } while (the_result && retries);
  1532. if (the_result) {
  1533. sd_printk(KERN_NOTICE, sdkp, "READ CAPACITY failed\n");
  1534. read_capacity_error(sdkp, sdp, &sshdr, sense_valid, the_result);
  1535. return -EINVAL;
  1536. }
  1537. sector_size = get_unaligned_be32(&buffer[4]);
  1538. lba = get_unaligned_be32(&buffer[0]);
  1539. if (sdp->no_read_capacity_16 && (lba == 0xffffffff)) {
  1540. /* Some buggy (usb cardreader) devices return an lba of
  1541. 0xffffffff when the want to report a size of 0 (with
  1542. which they really mean no media is present) */
  1543. sdkp->capacity = 0;
  1544. sdkp->physical_block_size = sector_size;
  1545. return sector_size;
  1546. }
  1547. if ((sizeof(sdkp->capacity) == 4) && (lba == 0xffffffff)) {
  1548. sd_printk(KERN_ERR, sdkp, "Too big for this kernel. Use a "
  1549. "kernel compiled with support for large block "
  1550. "devices.\n");
  1551. sdkp->capacity = 0;
  1552. return -EOVERFLOW;
  1553. }
  1554. sdkp->capacity = lba + 1;
  1555. sdkp->physical_block_size = sector_size;
  1556. return sector_size;
  1557. }
  1558. static int sd_try_rc16_first(struct scsi_device *sdp)
  1559. {
  1560. if (sdp->host->max_cmd_len < 16)
  1561. return 0;
  1562. if (sdp->scsi_level > SCSI_SPC_2)
  1563. return 1;
  1564. if (scsi_device_protection(sdp))
  1565. return 1;
  1566. return 0;
  1567. }
  1568. /*
  1569. * read disk capacity
  1570. */
  1571. static void
  1572. sd_read_capacity(struct scsi_disk *sdkp, unsigned char *buffer)
  1573. {
  1574. int sector_size;
  1575. struct scsi_device *sdp = sdkp->device;
  1576. sector_t old_capacity = sdkp->capacity;
  1577. if (sd_try_rc16_first(sdp)) {
  1578. sector_size = read_capacity_16(sdkp, sdp, buffer);
  1579. if (sector_size == -EOVERFLOW)
  1580. goto got_data;
  1581. if (sector_size == -ENODEV)
  1582. return;
  1583. if (sector_size < 0)
  1584. sector_size = read_capacity_10(sdkp, sdp, buffer);
  1585. if (sector_size < 0)
  1586. return;
  1587. } else {
  1588. sector_size = read_capacity_10(sdkp, sdp, buffer);
  1589. if (sector_size == -EOVERFLOW)
  1590. goto got_data;
  1591. if (sector_size < 0)
  1592. return;
  1593. if ((sizeof(sdkp->capacity) > 4) &&
  1594. (sdkp->capacity > 0xffffffffULL)) {
  1595. int old_sector_size = sector_size;
  1596. sd_printk(KERN_NOTICE, sdkp, "Very big device. "
  1597. "Trying to use READ CAPACITY(16).\n");
  1598. sector_size = read_capacity_16(sdkp, sdp, buffer);
  1599. if (sector_size < 0) {
  1600. sd_printk(KERN_NOTICE, sdkp,
  1601. "Using 0xffffffff as device size\n");
  1602. sdkp->capacity = 1 + (sector_t) 0xffffffff;
  1603. sector_size = old_sector_size;
  1604. goto got_data;
  1605. }
  1606. }
  1607. }
  1608. /* Some devices are known to return the total number of blocks,
  1609. * not the highest block number. Some devices have versions
  1610. * which do this and others which do not. Some devices we might
  1611. * suspect of doing this but we don't know for certain.
  1612. *
  1613. * If we know the reported capacity is wrong, decrement it. If
  1614. * we can only guess, then assume the number of blocks is even
  1615. * (usually true but not always) and err on the side of lowering
  1616. * the capacity.
  1617. */
  1618. if (sdp->fix_capacity ||
  1619. (sdp->guess_capacity && (sdkp->capacity & 0x01))) {
  1620. sd_printk(KERN_INFO, sdkp, "Adjusting the sector count "
  1621. "from its reported value: %llu\n",
  1622. (unsigned long long) sdkp->capacity);
  1623. --sdkp->capacity;
  1624. }
  1625. got_data:
  1626. if (sector_size == 0) {
  1627. sector_size = 512;
  1628. sd_printk(KERN_NOTICE, sdkp, "Sector size 0 reported, "
  1629. "assuming 512.\n");
  1630. }
  1631. if (sector_size != 512 &&
  1632. sector_size != 1024 &&
  1633. sector_size != 2048 &&
  1634. sector_size != 4096 &&
  1635. sector_size != 256) {
  1636. sd_printk(KERN_NOTICE, sdkp, "Unsupported sector size %d.\n",
  1637. sector_size);
  1638. /*
  1639. * The user might want to re-format the drive with
  1640. * a supported sectorsize. Once this happens, it
  1641. * would be relatively trivial to set the thing up.
  1642. * For this reason, we leave the thing in the table.
  1643. */
  1644. sdkp->capacity = 0;
  1645. /*
  1646. * set a bogus sector size so the normal read/write
  1647. * logic in the block layer will eventually refuse any
  1648. * request on this device without tripping over power
  1649. * of two sector size assumptions
  1650. */
  1651. sector_size = 512;
  1652. }
  1653. blk_queue_logical_block_size(sdp->request_queue, sector_size);
  1654. {
  1655. char cap_str_2[10], cap_str_10[10];
  1656. u64 sz = (u64)sdkp->capacity << ilog2(sector_size);
  1657. string_get_size(sz, STRING_UNITS_2, cap_str_2,
  1658. sizeof(cap_str_2));
  1659. string_get_size(sz, STRING_UNITS_10, cap_str_10,
  1660. sizeof(cap_str_10));
  1661. if (sdkp->first_scan || old_capacity != sdkp->capacity) {
  1662. sd_printk(KERN_NOTICE, sdkp,
  1663. "%llu %d-byte logical blocks: (%s/%s)\n",
  1664. (unsigned long long)sdkp->capacity,
  1665. sector_size, cap_str_10, cap_str_2);
  1666. if (sdkp->physical_block_size != sector_size)
  1667. sd_printk(KERN_NOTICE, sdkp,
  1668. "%u-byte physical blocks\n",
  1669. sdkp->physical_block_size);
  1670. }
  1671. }
  1672. /* Rescale capacity to 512-byte units */
  1673. if (sector_size == 4096)
  1674. sdkp->capacity <<= 3;
  1675. else if (sector_size == 2048)
  1676. sdkp->capacity <<= 2;
  1677. else if (sector_size == 1024)
  1678. sdkp->capacity <<= 1;
  1679. else if (sector_size == 256)
  1680. sdkp->capacity >>= 1;
  1681. blk_queue_physical_block_size(sdp->request_queue,
  1682. sdkp->physical_block_size);
  1683. sdkp->device->sector_size = sector_size;
  1684. }
  1685. /* called with buffer of length 512 */
  1686. static inline int
  1687. sd_do_mode_sense(struct scsi_device *sdp, int dbd, int modepage,
  1688. unsigned char *buffer, int len, struct scsi_mode_data *data,
  1689. struct scsi_sense_hdr *sshdr)
  1690. {
  1691. return scsi_mode_sense(sdp, dbd, modepage, buffer, len,
  1692. SD_TIMEOUT, SD_MAX_RETRIES, data,
  1693. sshdr);
  1694. }
  1695. /*
  1696. * read write protect setting, if possible - called only in sd_revalidate_disk()
  1697. * called with buffer of length SD_BUF_SIZE
  1698. */
  1699. static void
  1700. sd_read_write_protect_flag(struct scsi_disk *sdkp, unsigned char *buffer)
  1701. {
  1702. int res;
  1703. struct scsi_device *sdp = sdkp->device;
  1704. struct scsi_mode_data data;
  1705. int old_wp = sdkp->write_prot;
  1706. set_disk_ro(sdkp->disk, 0);
  1707. if (sdp->skip_ms_page_3f) {
  1708. sd_printk(KERN_NOTICE, sdkp, "Assuming Write Enabled\n");
  1709. return;
  1710. }
  1711. if (sdp->use_192_bytes_for_3f) {
  1712. res = sd_do_mode_sense(sdp, 0, 0x3F, buffer, 192, &data, NULL);
  1713. } else {
  1714. /*
  1715. * First attempt: ask for all pages (0x3F), but only 4 bytes.
  1716. * We have to start carefully: some devices hang if we ask
  1717. * for more than is available.
  1718. */
  1719. res = sd_do_mode_sense(sdp, 0, 0x3F, buffer, 4, &data, NULL);
  1720. /*
  1721. * Second attempt: ask for page 0 When only page 0 is
  1722. * implemented, a request for page 3F may return Sense Key
  1723. * 5: Illegal Request, Sense Code 24: Invalid field in
  1724. * CDB.
  1725. */
  1726. if (!scsi_status_is_good(res))
  1727. res = sd_do_mode_sense(sdp, 0, 0, buffer, 4, &data, NULL);
  1728. /*
  1729. * Third attempt: ask 255 bytes, as we did earlier.
  1730. */
  1731. if (!scsi_status_is_good(res))
  1732. res = sd_do_mode_sense(sdp, 0, 0x3F, buffer, 255,
  1733. &data, NULL);
  1734. }
  1735. if (!scsi_status_is_good(res)) {
  1736. sd_printk(KERN_WARNING, sdkp,
  1737. "Test WP failed, assume Write Enabled\n");
  1738. } else {
  1739. sdkp->write_prot = ((data.device_specific & 0x80) != 0);
  1740. set_disk_ro(sdkp->disk, sdkp->write_prot);
  1741. if (sdkp->first_scan || old_wp != sdkp->write_prot) {
  1742. sd_printk(KERN_NOTICE, sdkp, "Write Protect is %s\n",
  1743. sdkp->write_prot ? "on" : "off");
  1744. sd_printk(KERN_DEBUG, sdkp,
  1745. "Mode Sense: %02x %02x %02x %02x\n",
  1746. buffer[0], buffer[1], buffer[2], buffer[3]);
  1747. }
  1748. }
  1749. }
  1750. /*
  1751. * sd_read_cache_type - called only from sd_revalidate_disk()
  1752. * called with buffer of length SD_BUF_SIZE
  1753. */
  1754. static void
  1755. sd_read_cache_type(struct scsi_disk *sdkp, unsigned char *buffer)
  1756. {
  1757. int len = 0, res;
  1758. struct scsi_device *sdp = sdkp->device;
  1759. int dbd;
  1760. int modepage;
  1761. int first_len;
  1762. struct scsi_mode_data data;
  1763. struct scsi_sense_hdr sshdr;
  1764. int old_wce = sdkp->WCE;
  1765. int old_rcd = sdkp->RCD;
  1766. int old_dpofua = sdkp->DPOFUA;
  1767. first_len = 4;
  1768. if (sdp->skip_ms_page_8) {
  1769. if (sdp->type == TYPE_RBC)
  1770. goto defaults;
  1771. else {
  1772. if (sdp->skip_ms_page_3f)
  1773. goto defaults;
  1774. modepage = 0x3F;
  1775. if (sdp->use_192_bytes_for_3f)
  1776. first_len = 192;
  1777. dbd = 0;
  1778. }
  1779. } else if (sdp->type == TYPE_RBC) {
  1780. modepage = 6;
  1781. dbd = 8;
  1782. } else {
  1783. modepage = 8;
  1784. dbd = 0;
  1785. }
  1786. /* cautiously ask */
  1787. res = sd_do_mode_sense(sdp, dbd, modepage, buffer, first_len,
  1788. &data, &sshdr);
  1789. if (!scsi_status_is_good(res))
  1790. goto bad_sense;
  1791. if (!data.header_length) {
  1792. modepage = 6;
  1793. first_len = 0;
  1794. sd_printk(KERN_ERR, sdkp, "Missing header in MODE_SENSE response\n");
  1795. }
  1796. /* that went OK, now ask for the proper length */
  1797. len = data.length;
  1798. /*
  1799. * We're only interested in the first three bytes, actually.
  1800. * But the data cache page is defined for the first 20.
  1801. */
  1802. if (len < 3)
  1803. goto bad_sense;
  1804. else if (len > SD_BUF_SIZE) {
  1805. sd_printk(KERN_NOTICE, sdkp, "Truncating mode parameter "
  1806. "data from %d to %d bytes\n", len, SD_BUF_SIZE);
  1807. len = SD_BUF_SIZE;
  1808. }
  1809. if (modepage == 0x3F && sdp->use_192_bytes_for_3f)
  1810. len = 192;
  1811. /* Get the data */
  1812. if (len > first_len)
  1813. res = sd_do_mode_sense(sdp, dbd, modepage, buffer, len,
  1814. &data, &sshdr);
  1815. if (scsi_status_is_good(res)) {
  1816. int offset = data.header_length + data.block_descriptor_length;
  1817. while (offset < len) {
  1818. u8 page_code = buffer[offset] & 0x3F;
  1819. u8 spf = buffer[offset] & 0x40;
  1820. if (page_code == 8 || page_code == 6) {
  1821. /* We're interested only in the first 3 bytes.
  1822. */
  1823. if (len - offset <= 2) {
  1824. sd_printk(KERN_ERR, sdkp, "Incomplete "
  1825. "mode parameter data\n");
  1826. goto defaults;
  1827. } else {
  1828. modepage = page_code;
  1829. goto Page_found;
  1830. }
  1831. } else {
  1832. /* Go to the next page */
  1833. if (spf && len - offset > 3)
  1834. offset += 4 + (buffer[offset+2] << 8) +
  1835. buffer[offset+3];
  1836. else if (!spf && len - offset > 1)
  1837. offset += 2 + buffer[offset+1];
  1838. else {
  1839. sd_printk(KERN_ERR, sdkp, "Incomplete "
  1840. "mode parameter data\n");
  1841. goto defaults;
  1842. }
  1843. }
  1844. }
  1845. if (modepage == 0x3F) {
  1846. sd_printk(KERN_ERR, sdkp, "No Caching mode page "
  1847. "present\n");
  1848. goto defaults;
  1849. } else if ((buffer[offset] & 0x3f) != modepage) {
  1850. sd_printk(KERN_ERR, sdkp, "Got wrong page\n");
  1851. goto defaults;
  1852. }
  1853. Page_found:
  1854. if (modepage == 8) {
  1855. sdkp->WCE = ((buffer[offset + 2] & 0x04) != 0);
  1856. sdkp->RCD = ((buffer[offset + 2] & 0x01) != 0);
  1857. } else {
  1858. sdkp->WCE = ((buffer[offset + 2] & 0x01) == 0);
  1859. sdkp->RCD = 0;
  1860. }
  1861. sdkp->DPOFUA = (data.device_specific & 0x10) != 0;
  1862. if (sdkp->DPOFUA && !sdkp->device->use_10_for_rw) {
  1863. sd_printk(KERN_NOTICE, sdkp,
  1864. "Uses READ/WRITE(6), disabling FUA\n");
  1865. sdkp->DPOFUA = 0;
  1866. }
  1867. if (sdkp->first_scan || old_wce != sdkp->WCE ||
  1868. old_rcd != sdkp->RCD || old_dpofua != sdkp->DPOFUA)
  1869. sd_printk(KERN_NOTICE, sdkp,
  1870. "Write cache: %s, read cache: %s, %s\n",
  1871. sdkp->WCE ? "enabled" : "disabled",
  1872. sdkp->RCD ? "disabled" : "enabled",
  1873. sdkp->DPOFUA ? "supports DPO and FUA"
  1874. : "doesn't support DPO or FUA");
  1875. return;
  1876. }
  1877. bad_sense:
  1878. if (scsi_sense_valid(&sshdr) &&
  1879. sshdr.sense_key == ILLEGAL_REQUEST &&
  1880. sshdr.asc == 0x24 && sshdr.ascq == 0x0)
  1881. /* Invalid field in CDB */
  1882. sd_printk(KERN_NOTICE, sdkp, "Cache data unavailable\n");
  1883. else
  1884. sd_printk(KERN_ERR, sdkp, "Asking for cache data failed\n");
  1885. defaults:
  1886. sd_printk(KERN_ERR, sdkp, "Assuming drive cache: write through\n");
  1887. sdkp->WCE = 0;
  1888. sdkp->RCD = 0;
  1889. sdkp->DPOFUA = 0;
  1890. }
  1891. /*
  1892. * The ATO bit indicates whether the DIF application tag is available
  1893. * for use by the operating system.
  1894. */
  1895. static void sd_read_app_tag_own(struct scsi_disk *sdkp, unsigned char *buffer)
  1896. {
  1897. int res, offset;
  1898. struct scsi_device *sdp = sdkp->device;
  1899. struct scsi_mode_data data;
  1900. struct scsi_sense_hdr sshdr;
  1901. if (sdp->type != TYPE_DISK)
  1902. return;
  1903. if (sdkp->protection_type == 0)
  1904. return;
  1905. res = scsi_mode_sense(sdp, 1, 0x0a, buffer, 36, SD_TIMEOUT,
  1906. SD_MAX_RETRIES, &data, &sshdr);
  1907. if (!scsi_status_is_good(res) || !data.header_length ||
  1908. data.length < 6) {
  1909. sd_printk(KERN_WARNING, sdkp,
  1910. "getting Control mode page failed, assume no ATO\n");
  1911. if (scsi_sense_valid(&sshdr))
  1912. sd_print_sense_hdr(sdkp, &sshdr);
  1913. return;
  1914. }
  1915. offset = data.header_length + data.block_descriptor_length;
  1916. if ((buffer[offset] & 0x3f) != 0x0a) {
  1917. sd_printk(KERN_ERR, sdkp, "ATO Got wrong page\n");
  1918. return;
  1919. }
  1920. if ((buffer[offset + 5] & 0x80) == 0)
  1921. return;
  1922. sdkp->ATO = 1;
  1923. return;
  1924. }
  1925. /**
  1926. * sd_read_block_limits - Query disk device for preferred I/O sizes.
  1927. * @disk: disk to query
  1928. */
  1929. static void sd_read_block_limits(struct scsi_disk *sdkp)
  1930. {
  1931. unsigned int sector_sz = sdkp->device->sector_size;
  1932. const int vpd_len = 64;
  1933. unsigned char *buffer = kmalloc(vpd_len, GFP_KERNEL);
  1934. if (!buffer ||
  1935. /* Block Limits VPD */
  1936. scsi_get_vpd_page(sdkp->device, 0xb0, buffer, vpd_len))
  1937. goto out;
  1938. blk_queue_io_min(sdkp->disk->queue,
  1939. get_unaligned_be16(&buffer[6]) * sector_sz);
  1940. blk_queue_io_opt(sdkp->disk->queue,
  1941. get_unaligned_be32(&buffer[12]) * sector_sz);
  1942. if (buffer[3] == 0x3c) {
  1943. unsigned int lba_count, desc_count;
  1944. sdkp->max_ws_blocks =
  1945. (u32) min_not_zero(get_unaligned_be64(&buffer[36]),
  1946. (u64)0xffffffff);
  1947. if (!sdkp->lbpme)
  1948. goto out;
  1949. lba_count = get_unaligned_be32(&buffer[20]);
  1950. desc_count = get_unaligned_be32(&buffer[24]);
  1951. if (lba_count && desc_count)
  1952. sdkp->max_unmap_blocks = lba_count;
  1953. sdkp->unmap_granularity = get_unaligned_be32(&buffer[28]);
  1954. if (buffer[32] & 0x80)
  1955. sdkp->unmap_alignment =
  1956. get_unaligned_be32(&buffer[32]) & ~(1 << 31);
  1957. if (!sdkp->lbpvpd) { /* LBP VPD page not provided */
  1958. if (sdkp->max_unmap_blocks)
  1959. sd_config_discard(sdkp, SD_LBP_UNMAP);
  1960. else
  1961. sd_config_discard(sdkp, SD_LBP_WS16);
  1962. } else { /* LBP VPD page tells us what to use */
  1963. if (sdkp->lbpu && sdkp->max_unmap_blocks)
  1964. sd_config_discard(sdkp, SD_LBP_UNMAP);
  1965. else if (sdkp->lbpws)
  1966. sd_config_discard(sdkp, SD_LBP_WS16);
  1967. else if (sdkp->lbpws10)
  1968. sd_config_discard(sdkp, SD_LBP_WS10);
  1969. else
  1970. sd_config_discard(sdkp, SD_LBP_DISABLE);
  1971. }
  1972. }
  1973. out:
  1974. kfree(buffer);
  1975. }
  1976. /**
  1977. * sd_read_block_characteristics - Query block dev. characteristics
  1978. * @disk: disk to query
  1979. */
  1980. static void sd_read_block_characteristics(struct scsi_disk *sdkp)
  1981. {
  1982. unsigned char *buffer;
  1983. u16 rot;
  1984. const int vpd_len = 64;
  1985. buffer = kmalloc(vpd_len, GFP_KERNEL);
  1986. if (!buffer ||
  1987. /* Block Device Characteristics VPD */
  1988. scsi_get_vpd_page(sdkp->device, 0xb1, buffer, vpd_len))
  1989. goto out;
  1990. rot = get_unaligned_be16(&buffer[4]);
  1991. if (rot == 1)
  1992. queue_flag_set_unlocked(QUEUE_FLAG_NONROT, sdkp->disk->queue);
  1993. out:
  1994. kfree(buffer);
  1995. }
  1996. /**
  1997. * sd_read_block_provisioning - Query provisioning VPD page
  1998. * @disk: disk to query
  1999. */
  2000. static void sd_read_block_provisioning(struct scsi_disk *sdkp)
  2001. {
  2002. unsigned char *buffer;
  2003. const int vpd_len = 8;
  2004. if (sdkp->lbpme == 0)
  2005. return;
  2006. buffer = kmalloc(vpd_len, GFP_KERNEL);
  2007. if (!buffer || scsi_get_vpd_page(sdkp->device, 0xb2, buffer, vpd_len))
  2008. goto out;
  2009. sdkp->lbpvpd = 1;
  2010. sdkp->lbpu = (buffer[5] >> 7) & 1; /* UNMAP */
  2011. sdkp->lbpws = (buffer[5] >> 6) & 1; /* WRITE SAME(16) with UNMAP */
  2012. sdkp->lbpws10 = (buffer[5] >> 5) & 1; /* WRITE SAME(10) with UNMAP */
  2013. out:
  2014. kfree(buffer);
  2015. }
  2016. static int sd_try_extended_inquiry(struct scsi_device *sdp)
  2017. {
  2018. /*
  2019. * Although VPD inquiries can go to SCSI-2 type devices,
  2020. * some USB ones crash on receiving them, and the pages
  2021. * we currently ask for are for SPC-3 and beyond
  2022. */
  2023. if (sdp->scsi_level > SCSI_SPC_2)
  2024. return 1;
  2025. return 0;
  2026. }
  2027. /**
  2028. * sd_revalidate_disk - called the first time a new disk is seen,
  2029. * performs disk spin up, read_capacity, etc.
  2030. * @disk: struct gendisk we care about
  2031. **/
  2032. static int sd_revalidate_disk(struct gendisk *disk)
  2033. {
  2034. struct scsi_disk *sdkp = scsi_disk(disk);
  2035. struct scsi_device *sdp = sdkp->device;
  2036. unsigned char *buffer;
  2037. unsigned flush = 0;
  2038. SCSI_LOG_HLQUEUE(3, sd_printk(KERN_INFO, sdkp,
  2039. "sd_revalidate_disk\n"));
  2040. /*
  2041. * If the device is offline, don't try and read capacity or any
  2042. * of the other niceties.
  2043. */
  2044. if (!scsi_device_online(sdp))
  2045. goto out;
  2046. buffer = kmalloc(SD_BUF_SIZE, GFP_KERNEL);
  2047. if (!buffer) {
  2048. sd_printk(KERN_WARNING, sdkp, "sd_revalidate_disk: Memory "
  2049. "allocation failure.\n");
  2050. goto out;
  2051. }
  2052. sd_spinup_disk(sdkp);
  2053. /*
  2054. * Without media there is no reason to ask; moreover, some devices
  2055. * react badly if we do.
  2056. */
  2057. if (sdkp->media_present) {
  2058. sd_read_capacity(sdkp, buffer);
  2059. if (sd_try_extended_inquiry(sdp)) {
  2060. sd_read_block_provisioning(sdkp);
  2061. sd_read_block_limits(sdkp);
  2062. sd_read_block_characteristics(sdkp);
  2063. }
  2064. sd_read_write_protect_flag(sdkp, buffer);
  2065. sd_read_cache_type(sdkp, buffer);
  2066. sd_read_app_tag_own(sdkp, buffer);
  2067. }
  2068. sdkp->first_scan = 0;
  2069. /*
  2070. * We now have all cache related info, determine how we deal
  2071. * with flush requests.
  2072. */
  2073. if (sdkp->WCE) {
  2074. flush |= REQ_FLUSH;
  2075. if (sdkp->DPOFUA)
  2076. flush |= REQ_FUA;
  2077. }
  2078. blk_queue_flush(sdkp->disk->queue, flush);
  2079. set_capacity(disk, sdkp->capacity);
  2080. kfree(buffer);
  2081. out:
  2082. return 0;
  2083. }
  2084. /**
  2085. * sd_unlock_native_capacity - unlock native capacity
  2086. * @disk: struct gendisk to set capacity for
  2087. *
  2088. * Block layer calls this function if it detects that partitions
  2089. * on @disk reach beyond the end of the device. If the SCSI host
  2090. * implements ->unlock_native_capacity() method, it's invoked to
  2091. * give it a chance to adjust the device capacity.
  2092. *
  2093. * CONTEXT:
  2094. * Defined by block layer. Might sleep.
  2095. */
  2096. static void sd_unlock_native_capacity(struct gendisk *disk)
  2097. {
  2098. struct scsi_device *sdev = scsi_disk(disk)->device;
  2099. if (sdev->host->hostt->unlock_native_capacity)
  2100. sdev->host->hostt->unlock_native_capacity(sdev);
  2101. }
  2102. /**
  2103. * sd_format_disk_name - format disk name
  2104. * @prefix: name prefix - ie. "sd" for SCSI disks
  2105. * @index: index of the disk to format name for
  2106. * @buf: output buffer
  2107. * @buflen: length of the output buffer
  2108. *
  2109. * SCSI disk names starts at sda. The 26th device is sdz and the
  2110. * 27th is sdaa. The last one for two lettered suffix is sdzz
  2111. * which is followed by sdaaa.
  2112. *
  2113. * This is basically 26 base counting with one extra 'nil' entry
  2114. * at the beginning from the second digit on and can be
  2115. * determined using similar method as 26 base conversion with the
  2116. * index shifted -1 after each digit is computed.
  2117. *
  2118. * CONTEXT:
  2119. * Don't care.
  2120. *
  2121. * RETURNS:
  2122. * 0 on success, -errno on failure.
  2123. */
  2124. static int sd_format_disk_name(char *prefix, int index, char *buf, int buflen)
  2125. {
  2126. const int base = 'z' - 'a' + 1;
  2127. char *begin = buf + strlen(prefix);
  2128. char *end = buf + buflen;
  2129. char *p;
  2130. int unit;
  2131. p = end - 1;
  2132. *p = '\0';
  2133. unit = base;
  2134. do {
  2135. if (p == begin)
  2136. return -EINVAL;
  2137. *--p = 'a' + (index % unit);
  2138. index = (index / unit) - 1;
  2139. } while (index >= 0);
  2140. memmove(begin, p, end - p);
  2141. memcpy(buf, prefix, strlen(prefix));
  2142. return 0;
  2143. }
  2144. /*
  2145. * The asynchronous part of sd_probe
  2146. */
  2147. static void sd_probe_async(void *data, async_cookie_t cookie)
  2148. {
  2149. struct scsi_disk *sdkp = data;
  2150. struct scsi_device *sdp;
  2151. struct gendisk *gd;
  2152. u32 index;
  2153. struct device *dev;
  2154. sdp = sdkp->device;
  2155. gd = sdkp->disk;
  2156. index = sdkp->index;
  2157. dev = &sdp->sdev_gendev;
  2158. gd->major = sd_major((index & 0xf0) >> 4);
  2159. gd->first_minor = ((index & 0xf) << 4) | (index & 0xfff00);
  2160. gd->minors = SD_MINORS;
  2161. gd->fops = &sd_fops;
  2162. gd->private_data = &sdkp->driver;
  2163. gd->queue = sdkp->device->request_queue;
  2164. /* defaults, until the device tells us otherwise */
  2165. sdp->sector_size = 512;
  2166. sdkp->capacity = 0;
  2167. sdkp->media_present = 1;
  2168. sdkp->write_prot = 0;
  2169. sdkp->WCE = 0;
  2170. sdkp->RCD = 0;
  2171. sdkp->ATO = 0;
  2172. sdkp->first_scan = 1;
  2173. sd_revalidate_disk(gd);
  2174. blk_queue_prep_rq(sdp->request_queue, sd_prep_fn);
  2175. blk_queue_unprep_rq(sdp->request_queue, sd_unprep_fn);
  2176. gd->driverfs_dev = &sdp->sdev_gendev;
  2177. gd->flags = GENHD_FL_EXT_DEVT;
  2178. if (sdp->removable) {
  2179. gd->flags |= GENHD_FL_REMOVABLE;
  2180. gd->events |= DISK_EVENT_MEDIA_CHANGE;
  2181. }
  2182. add_disk(gd);
  2183. sd_dif_config_host(sdkp);
  2184. sd_revalidate_disk(gd);
  2185. sd_printk(KERN_NOTICE, sdkp, "Attached SCSI %sdisk\n",
  2186. sdp->removable ? "removable " : "");
  2187. scsi_autopm_put_device(sdp);
  2188. put_device(&sdkp->dev);
  2189. }
  2190. /**
  2191. * sd_probe - called during driver initialization and whenever a
  2192. * new scsi device is attached to the system. It is called once
  2193. * for each scsi device (not just disks) present.
  2194. * @dev: pointer to device object
  2195. *
  2196. * Returns 0 if successful (or not interested in this scsi device
  2197. * (e.g. scanner)); 1 when there is an error.
  2198. *
  2199. * Note: this function is invoked from the scsi mid-level.
  2200. * This function sets up the mapping between a given
  2201. * <host,channel,id,lun> (found in sdp) and new device name
  2202. * (e.g. /dev/sda). More precisely it is the block device major
  2203. * and minor number that is chosen here.
  2204. *
  2205. * Assume sd_attach is not re-entrant (for time being)
  2206. * Also think about sd_attach() and sd_remove() running coincidentally.
  2207. **/
  2208. static int sd_probe(struct device *dev)
  2209. {
  2210. struct scsi_device *sdp = to_scsi_device(dev);
  2211. struct scsi_disk *sdkp;
  2212. struct gendisk *gd;
  2213. int index;
  2214. int error;
  2215. error = -ENODEV;
  2216. if (sdp->type != TYPE_DISK && sdp->type != TYPE_MOD && sdp->type != TYPE_RBC)
  2217. goto out;
  2218. SCSI_LOG_HLQUEUE(3, sdev_printk(KERN_INFO, sdp,
  2219. "sd_attach\n"));
  2220. error = -ENOMEM;
  2221. sdkp = kzalloc(sizeof(*sdkp), GFP_KERNEL);
  2222. if (!sdkp)
  2223. goto out;
  2224. gd = alloc_disk(SD_MINORS);
  2225. if (!gd)
  2226. goto out_free;
  2227. do {
  2228. if (!ida_pre_get(&sd_index_ida, GFP_KERNEL))
  2229. goto out_put;
  2230. spin_lock(&sd_index_lock);
  2231. error = ida_get_new(&sd_index_ida, &index);
  2232. spin_unlock(&sd_index_lock);
  2233. } while (error == -EAGAIN);
  2234. if (error) {
  2235. sdev_printk(KERN_WARNING, sdp, "sd_probe: memory exhausted.\n");
  2236. goto out_put;
  2237. }
  2238. error = sd_format_disk_name("sd", index, gd->disk_name, DISK_NAME_LEN);
  2239. if (error) {
  2240. sdev_printk(KERN_WARNING, sdp, "SCSI disk (sd) name length exceeded.\n");
  2241. goto out_free_index;
  2242. }
  2243. sdkp->device = sdp;
  2244. sdkp->driver = &sd_template;
  2245. sdkp->disk = gd;
  2246. sdkp->index = index;
  2247. atomic_set(&sdkp->openers, 0);
  2248. if (!sdp->request_queue->rq_timeout) {
  2249. if (sdp->type != TYPE_MOD)
  2250. blk_queue_rq_timeout(sdp->request_queue, SD_TIMEOUT);
  2251. else
  2252. blk_queue_rq_timeout(sdp->request_queue,
  2253. SD_MOD_TIMEOUT);
  2254. }
  2255. device_initialize(&sdkp->dev);
  2256. sdkp->dev.parent = dev;
  2257. sdkp->dev.class = &sd_disk_class;
  2258. dev_set_name(&sdkp->dev, dev_name(dev));
  2259. if (device_add(&sdkp->dev))
  2260. goto out_free_index;
  2261. get_device(dev);
  2262. dev_set_drvdata(dev, sdkp);
  2263. get_device(&sdkp->dev); /* prevent release before async_schedule */
  2264. async_schedule(sd_probe_async, sdkp);
  2265. return 0;
  2266. out_free_index:
  2267. spin_lock(&sd_index_lock);
  2268. ida_remove(&sd_index_ida, index);
  2269. spin_unlock(&sd_index_lock);
  2270. out_put:
  2271. put_disk(gd);
  2272. out_free:
  2273. kfree(sdkp);
  2274. out:
  2275. return error;
  2276. }
  2277. /**
  2278. * sd_remove - called whenever a scsi disk (previously recognized by
  2279. * sd_probe) is detached from the system. It is called (potentially
  2280. * multiple times) during sd module unload.
  2281. * @sdp: pointer to mid level scsi device object
  2282. *
  2283. * Note: this function is invoked from the scsi mid-level.
  2284. * This function potentially frees up a device name (e.g. /dev/sdc)
  2285. * that could be re-used by a subsequent sd_probe().
  2286. * This function is not called when the built-in sd driver is "exit-ed".
  2287. **/
  2288. static int sd_remove(struct device *dev)
  2289. {
  2290. struct scsi_disk *sdkp;
  2291. sdkp = dev_get_drvdata(dev);
  2292. scsi_autopm_get_device(sdkp->device);
  2293. async_synchronize_full();
  2294. blk_queue_prep_rq(sdkp->device->request_queue, scsi_prep_fn);
  2295. blk_queue_unprep_rq(sdkp->device->request_queue, NULL);
  2296. device_del(&sdkp->dev);
  2297. del_gendisk(sdkp->disk);
  2298. sd_shutdown(dev);
  2299. mutex_lock(&sd_ref_mutex);
  2300. dev_set_drvdata(dev, NULL);
  2301. put_device(&sdkp->dev);
  2302. mutex_unlock(&sd_ref_mutex);
  2303. return 0;
  2304. }
  2305. /**
  2306. * scsi_disk_release - Called to free the scsi_disk structure
  2307. * @dev: pointer to embedded class device
  2308. *
  2309. * sd_ref_mutex must be held entering this routine. Because it is
  2310. * called on last put, you should always use the scsi_disk_get()
  2311. * scsi_disk_put() helpers which manipulate the semaphore directly
  2312. * and never do a direct put_device.
  2313. **/
  2314. static void scsi_disk_release(struct device *dev)
  2315. {
  2316. struct scsi_disk *sdkp = to_scsi_disk(dev);
  2317. struct gendisk *disk = sdkp->disk;
  2318. spin_lock(&sd_index_lock);
  2319. ida_remove(&sd_index_ida, sdkp->index);
  2320. spin_unlock(&sd_index_lock);
  2321. disk->private_data = NULL;
  2322. put_disk(disk);
  2323. put_device(&sdkp->device->sdev_gendev);
  2324. kfree(sdkp);
  2325. }
  2326. static int sd_start_stop_device(struct scsi_disk *sdkp, int start)
  2327. {
  2328. unsigned char cmd[6] = { START_STOP }; /* START_VALID */
  2329. struct scsi_sense_hdr sshdr;
  2330. struct scsi_device *sdp = sdkp->device;
  2331. int res;
  2332. if (start)
  2333. cmd[4] |= 1; /* START */
  2334. if (sdp->start_stop_pwr_cond)
  2335. cmd[4] |= start ? 1 << 4 : 3 << 4; /* Active or Standby */
  2336. if (!scsi_device_online(sdp))
  2337. return -ENODEV;
  2338. res = scsi_execute_req(sdp, cmd, DMA_NONE, NULL, 0, &sshdr,
  2339. SD_TIMEOUT, SD_MAX_RETRIES, NULL);
  2340. if (res) {
  2341. sd_printk(KERN_WARNING, sdkp, "START_STOP FAILED\n");
  2342. sd_print_result(sdkp, res);
  2343. if (driver_byte(res) & DRIVER_SENSE)
  2344. sd_print_sense_hdr(sdkp, &sshdr);
  2345. }
  2346. return res;
  2347. }
  2348. /*
  2349. * Send a SYNCHRONIZE CACHE instruction down to the device through
  2350. * the normal SCSI command structure. Wait for the command to
  2351. * complete.
  2352. */
  2353. static void sd_shutdown(struct device *dev)
  2354. {
  2355. struct scsi_disk *sdkp = scsi_disk_get_from_dev(dev);
  2356. if (!sdkp)
  2357. return; /* this can happen */
  2358. if (sdkp->WCE) {
  2359. sd_printk(KERN_NOTICE, sdkp, "Synchronizing SCSI cache\n");
  2360. sd_sync_cache(sdkp);
  2361. }
  2362. if (system_state != SYSTEM_RESTART && sdkp->device->manage_start_stop) {
  2363. sd_printk(KERN_NOTICE, sdkp, "Stopping disk\n");
  2364. sd_start_stop_device(sdkp, 0);
  2365. }
  2366. scsi_disk_put(sdkp);
  2367. }
  2368. static int sd_suspend(struct device *dev, pm_message_t mesg)
  2369. {
  2370. struct scsi_disk *sdkp = scsi_disk_get_from_dev(dev);
  2371. int ret = 0;
  2372. if (!sdkp)
  2373. return 0; /* this can happen */
  2374. if (sdkp->WCE) {
  2375. sd_printk(KERN_NOTICE, sdkp, "Synchronizing SCSI cache\n");
  2376. ret = sd_sync_cache(sdkp);
  2377. if (ret)
  2378. goto done;
  2379. }
  2380. if ((mesg.event & PM_EVENT_SLEEP) && sdkp->device->manage_start_stop) {
  2381. sd_printk(KERN_NOTICE, sdkp, "Stopping disk\n");
  2382. ret = sd_start_stop_device(sdkp, 0);
  2383. }
  2384. done:
  2385. scsi_disk_put(sdkp);
  2386. return ret;
  2387. }
  2388. static int sd_resume(struct device *dev)
  2389. {
  2390. struct scsi_disk *sdkp = scsi_disk_get_from_dev(dev);
  2391. int ret = 0;
  2392. if (!sdkp->device->manage_start_stop)
  2393. goto done;
  2394. sd_printk(KERN_NOTICE, sdkp, "Starting disk\n");
  2395. ret = sd_start_stop_device(sdkp, 1);
  2396. done:
  2397. scsi_disk_put(sdkp);
  2398. return ret;
  2399. }
  2400. /**
  2401. * init_sd - entry point for this driver (both when built in or when
  2402. * a module).
  2403. *
  2404. * Note: this function registers this driver with the scsi mid-level.
  2405. **/
  2406. static int __init init_sd(void)
  2407. {
  2408. int majors = 0, i, err;
  2409. SCSI_LOG_HLQUEUE(3, printk("init_sd: sd driver entry point\n"));
  2410. for (i = 0; i < SD_MAJORS; i++)
  2411. if (register_blkdev(sd_major(i), "sd") == 0)
  2412. majors++;
  2413. if (!majors)
  2414. return -ENODEV;
  2415. err = class_register(&sd_disk_class);
  2416. if (err)
  2417. goto err_out;
  2418. err = scsi_register_driver(&sd_template.gendrv);
  2419. if (err)
  2420. goto err_out_class;
  2421. sd_cdb_cache = kmem_cache_create("sd_ext_cdb", SD_EXT_CDB_SIZE,
  2422. 0, 0, NULL);
  2423. if (!sd_cdb_cache) {
  2424. printk(KERN_ERR "sd: can't init extended cdb cache\n");
  2425. goto err_out_class;
  2426. }
  2427. sd_cdb_pool = mempool_create_slab_pool(SD_MEMPOOL_SIZE, sd_cdb_cache);
  2428. if (!sd_cdb_pool) {
  2429. printk(KERN_ERR "sd: can't init extended cdb pool\n");
  2430. goto err_out_cache;
  2431. }
  2432. return 0;
  2433. err_out_cache:
  2434. kmem_cache_destroy(sd_cdb_cache);
  2435. err_out_class:
  2436. class_unregister(&sd_disk_class);
  2437. err_out:
  2438. for (i = 0; i < SD_MAJORS; i++)
  2439. unregister_blkdev(sd_major(i), "sd");
  2440. return err;
  2441. }
  2442. /**
  2443. * exit_sd - exit point for this driver (when it is a module).
  2444. *
  2445. * Note: this function unregisters this driver from the scsi mid-level.
  2446. **/
  2447. static void __exit exit_sd(void)
  2448. {
  2449. int i;
  2450. SCSI_LOG_HLQUEUE(3, printk("exit_sd: exiting sd driver\n"));
  2451. mempool_destroy(sd_cdb_pool);
  2452. kmem_cache_destroy(sd_cdb_cache);
  2453. scsi_unregister_driver(&sd_template.gendrv);
  2454. class_unregister(&sd_disk_class);
  2455. for (i = 0; i < SD_MAJORS; i++)
  2456. unregister_blkdev(sd_major(i), "sd");
  2457. }
  2458. module_init(init_sd);
  2459. module_exit(exit_sd);
  2460. static void sd_print_sense_hdr(struct scsi_disk *sdkp,
  2461. struct scsi_sense_hdr *sshdr)
  2462. {
  2463. sd_printk(KERN_INFO, sdkp, " ");
  2464. scsi_show_sense_hdr(sshdr);
  2465. sd_printk(KERN_INFO, sdkp, " ");
  2466. scsi_show_extd_sense(sshdr->asc, sshdr->ascq);
  2467. }
  2468. static void sd_print_result(struct scsi_disk *sdkp, int result)
  2469. {
  2470. sd_printk(KERN_INFO, sdkp, " ");
  2471. scsi_show_result(result);
  2472. }