《Linux那些事儿之我是USB》我是U盘（36）迷雾重重的批量传输（五）

在讲数据传输阶段之前，先解决刚才的历史遗留问题。usb_stor_bulk_transfer_buf()中，406行，有一个很有趣的函数interpret_urb_result()被调用。这个函数同样来自drivers/usb/storage/transport.c中：

265 static int interpret_urb_result(struct us_data*us, unsigned int pipe,

266 unsigned int length, int result, unsigned int partial)

267 {

268 US_DEBUGP("Status code %d; transferred%u/%u\n",

269 result, partial,length);

270 switch (result) {

271

272 /* no error code; did we send all the data? */

273 case 0:

274 if (partial != length) {

275 US_DEBUGP("-- shorttransfer\n");

276 return USB_STOR_XFER_SHORT;

277 }

278

279 US_DEBUGP("-- transfer complete\n");

280 return USB_STOR_XFER_GOOD;

281

282 /* stalled */

283 case -EPIPE:

284 /* for control endpoints, (used by CB[I]) astall indicates

285 * afailed command */

286 if (usb_pipecontrol(pipe)) {

287 US_DEBUGP("-- stall oncontrol pipe\n");

288 return USB_STOR_XFER_STALLED;

289 }

290

291 /* for other sorts of endpoint, clear thestall */

292 US_DEBUGP("clearing endpoint halt forpipe 0x%x\n", pipe);

293 if (usb_stor_clear_halt(us, pipe) < 0)

294 return USB_STOR_XFER_ERROR;

295 return USB_STOR_XFER_STALLED;

296

297 /* babble - the device tried to send morethan we wanted to read */

298 case -EOVERFLOW:

299 US_DEBUGP("-- babble\n");

300 return USB_STOR_XFER_LONG;

301

302 /* the transfer was cancelled by abort, disconnect,or timeout */

303 case -ECONNRESET:

304 US_DEBUGP("-- transfercancelled\n");

305 return USB_STOR_XFER_ERROR;

306

307 /* short scatter-gather read transfer */

308 case -EREMOTEIO:

309 US_DEBUGP("-- short readtransfer\n");

310 return USB_STOR_XFER_SHORT;

311

312 /* abort or disconnect in progress */

313 case -EIO:

314 US_DEBUGP("-- abort or disconnect inprogress\n");

315 return USB_STOR_XFER_ERROR;

316

317 /* the catch-all error case */

318 default:

319 US_DEBUGP("-- unknown error\n");

320 return USB_STOR_XFER_ERROR;

321 }

322 }

应该说这个函数的作用是一目了然，就是根据传进来的参数result进行判断，从而采取相应的行动。partial是实际传输的长度，而length是期望传输的长度，传输结束了当然要比较这两者，因为有所期待，才会失望。result是usb_stor_ msg_common()函数的返回值，其实就是状态代码。如果为0说明一切都很顺利，结果也是成功的。268这行，打印结果，同时打印出partial和length的比，注意两个%u中间那个“/”，就是除号，或者说分割分子和分母的符号。

然后通过一个switch语句判断result，为0，说明至少数据有传输。然后有两种情况，于是返回不同的值，USB_STOR_XFER_SHORT和USB_STOR_XFER_GOOD。至于返回这些值之后会得到什么反应，让我们边走边看。目前只需要知道的是，对于真正传输完全令人满意的情况，返回值只能是USB_STOR_XFER_GOOD。返回其他值都说明有问题。而这里作为传递给switch的result，实际上是USB Core那一层传过来的值。

而我们注意到，interpret_urb_result这个函数整个是被作为一个返回值出现在usb_stor_bulk_transfer_buf()中的。换而言之，前者返回之后，后者也马上就返回了，即再次返回到了usb_stor_Bulk_transport()中。因此，我们把视线拉回usb_stor_Bulk_transport()，981行，如果result不为USB_STOR_XFER_GOOD，就说明有一些问题，于是索性usb_stor_Bulk_transport()也返回，没必要再进行下一阶段的传输了。否则，才可以进行下一阶段。

下一个阶段是所谓的Bulk-only传输，总共就是三个阶段，即命令传输阶段、数据传输阶段、状态传输阶段。很显然，真正最有意义的阶段就是数据传输阶段，而在此之前，我们已经讲了第一阶段，即命令传输阶段。下面我们可以来看一下数据阶段。

989行，990行，实在没话可说，某些公司的产品在命令阶段和数据阶段居然还得延时100μs，最早时只发现了Genesys Logic公司的产品有这个问题，后来又发现更多的产品也有同样的问题。所以使用了US_FL_GO_SLOW这个flag，如果你有兴趣看一下早期的Linux Kernel，你会发现那时候其实没有这个flag，那时候定义了一个USB_VENDOR_ID_GENESYS，直接比较这个产品是不是Genesys Logic公司的，如果是的，那就考虑这个延时，否则就不用。

993行，transfer_length可能为0，因为有的命令并不需要您传输数据，所以它没有数据阶段。而对于那些有数据阶段的情况，我们进入if这一段。

994行，没什么可说的，就是根据数据传输方向确定用接收管道还是发送管道。

然后，996行，usb_stor_bulk_transfer_sg()函数真正地执行批量数据传输。这个函数来自drivers/usb/storage/transport.c中:

470 int usb_stor_bulk_transfer_sg(struct us_data*us, unsigned int pipe,

471 void *buf, unsigned int length_left, int use_sg, int *residual)

472 {

473 int result;

474 unsigned int partial;

475

476 /* are we scatter-gathering? */

477 if (use_sg) {

478 /* use the usb core scatter-gather primitives*/

479 result = usb_stor_bulk_transfer_sglist(us,pipe,

480 (structscatterlist *) buf, use_sg,

481 length_left,&partial);

482 length_left -= partial;

483 } else {

484 /* no scatter-gather, just make the request */

485 result = usb_stor_bulk_transfer_buf(us, pipe,buf,

486 length_left,&partial);

487 length_left -= partial;

488 }

489

490 /* store the residual and return the error code*/

491 if (residual)

492 *residual = length_left;

493 return result;

494 }

注释说得很清楚，这个函数是一个壳，真正干活的是它所调用或者说利用的那两个函数：usb_stor_bulk_transfer_sglist()和usb_stor_bulk_transfer_buf()。后者刚才已经遇到过了，而前者是专门为scatter-gather传输准备的函数，它也来自drivers/usb/storage/transport.c中:

416 static int usb_stor_bulk_transfer_sglist(structus_data *us, unsigned int pipe,

417 struct scatterlist *sg, int num_sg, unsigned int length,

418 unsigned int *act_len)

419 {

420 int result;

421

422 /*don't submit s-g requests during abort/disconnect processing */

423 if (us->flags &ABORTING_OR_DISCONNECTING)

424 return USB_STOR_XFER_ERROR;

425

426 /* initialize the scatter-gather request block*/

427 US_DEBUGP("%s: xfer %u Bytes, %dentries\n", __FUNCTION__,

428 length, num_sg);

429 result = usb_sg_init(&us->current_sg,us->pusb_dev, pipe, 0,

430 sg, num_sg, length,GFP_NOIO);

431 if (result) {

432 US_DEBUGP("usb_sg_init returned%d\n", result);

433 return USB_STOR_XFER_ERROR;

434 }

435

436 /* since the block has been initializedsuccessfully, it's now

437 * okayto cancel it */

438 set_bit(US_FLIDX_SG_ACTIVE,&us->flags);

439

440 /* did an abort/disconnect occur during thesubmission? */

441 if (us->flags &ABORTING_OR_DISCONNECTING) {

442

443 /* cancel the request, if it hasn't beencancelled already */

444 if (test_and_clear_bit(US_FLIDX_SG_ACTIVE,&us->flags)) {

445 US_DEBUGP("--cancelling sg request\n");

446 usb_sg_cancel(&us->current_sg);

447 }

448 }

449

450 /* wait for the completion of the transfer */

451 usb_sg_wait(&us->current_sg);

452 clear_bit(US_FLIDX_SG_ACTIVE, &us->flags);

453

454 result = us->current_sg.status;

455 if (act_len)

456 *act_len = us->current_sg.Bytes;

457 return interpret_urb_result(us, pipe, length,result,

458 us->current_sg.Bytes);

459 }

在usb_stor_bulk_transfer_sg()函数中，判断use_sg是否为0，从而确定是否用scatter-gather。对于use_sg等于0的情况，表示不用scatter-gather，那么调用usb_stor_bulk_transfer_buf()发送scsi命令。实际传递的数据长度用partial记录，然后length_left就记录还剩下多少没传递，初值当然就是期望传递的那个长度。每次减去实际传递的长度即可。对于use_sg不等于0的情况，usb_stor_bulk_transfer_sglist()函数被调用。我们来看这个函数。