libiscsi_tcp.c 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164
  1. /*
  2. * iSCSI over TCP/IP Data-Path lib
  3. *
  4. * Copyright (C) 2004 Dmitry Yusupov
  5. * Copyright (C) 2004 Alex Aizman
  6. * Copyright (C) 2005 - 2006 Mike Christie
  7. * Copyright (C) 2006 Red Hat, Inc. All rights reserved.
  8. * maintained by open-iscsi@googlegroups.com
  9. *
  10. * This program is free software; you can redistribute it and/or modify
  11. * it under the terms of the GNU General Public License as published
  12. * by the Free Software Foundation; either version 2 of the License, or
  13. * (at your option) any later version.
  14. *
  15. * This program is distributed in the hope that it will be useful, but
  16. * WITHOUT ANY WARRANTY; without even the implied warranty of
  17. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18. * General Public License for more details.
  19. *
  20. * See the file COPYING included with this distribution for more details.
  21. *
  22. * Credits:
  23. * Christoph Hellwig
  24. * FUJITA Tomonori
  25. * Arne Redlich
  26. * Zhenyu Wang
  27. */
  28. #include <linux/types.h>
  29. #include <linux/list.h>
  30. #include <linux/inet.h>
  31. #include <linux/file.h>
  32. #include <linux/blkdev.h>
  33. #include <linux/crypto.h>
  34. #include <linux/delay.h>
  35. #include <linux/kfifo.h>
  36. #include <linux/scatterlist.h>
  37. #include <net/tcp.h>
  38. #include <scsi/scsi_cmnd.h>
  39. #include <scsi/scsi_device.h>
  40. #include <scsi/scsi_host.h>
  41. #include <scsi/scsi.h>
  42. #include <scsi/scsi_transport_iscsi.h>
  43. #include "iscsi_tcp.h"
  44. MODULE_AUTHOR("Mike Christie <michaelc@cs.wisc.edu>, "
  45. "Dmitry Yusupov <dmitry_yus@yahoo.com>, "
  46. "Alex Aizman <itn780@yahoo.com>");
  47. MODULE_DESCRIPTION("iSCSI/TCP data-path");
  48. MODULE_LICENSE("GPL");
  49. static int iscsi_dbg_libtcp;
  50. module_param_named(debug_libiscsi_tcp, iscsi_dbg_libtcp, int,
  51. S_IRUGO | S_IWUSR);
  52. MODULE_PARM_DESC(debug_libiscsi_tcp, "Turn on debugging for libiscsi_tcp "
  53. "module. Set to 1 to turn on, and zero to turn off. Default "
  54. "is off.");
  55. #define ISCSI_DBG_TCP(_conn, dbg_fmt, arg...) \
  56. do { \
  57. if (iscsi_dbg_libtcp) \
  58. iscsi_conn_printk(KERN_INFO, _conn, \
  59. "%s " dbg_fmt, \
  60. __func__, ##arg); \
  61. } while (0);
  62. static int iscsi_tcp_hdr_recv_done(struct iscsi_tcp_conn *tcp_conn,
  63. struct iscsi_segment *segment);
  64. /*
  65. * Scatterlist handling: inside the iscsi_segment, we
  66. * remember an index into the scatterlist, and set data/size
  67. * to the current scatterlist entry. For highmem pages, we
  68. * kmap as needed.
  69. *
  70. * Note that the page is unmapped when we return from
  71. * TCP's data_ready handler, so we may end up mapping and
  72. * unmapping the same page repeatedly. The whole reason
  73. * for this is that we shouldn't keep the page mapped
  74. * outside the softirq.
  75. */
  76. /**
  77. * iscsi_tcp_segment_init_sg - init indicated scatterlist entry
  78. * @segment: the buffer object
  79. * @sg: scatterlist
  80. * @offset: byte offset into that sg entry
  81. *
  82. * This function sets up the segment so that subsequent
  83. * data is copied to the indicated sg entry, at the given
  84. * offset.
  85. */
  86. static inline void
  87. iscsi_tcp_segment_init_sg(struct iscsi_segment *segment,
  88. struct scatterlist *sg, unsigned int offset)
  89. {
  90. segment->sg = sg;
  91. segment->sg_offset = offset;
  92. segment->size = min(sg->length - offset,
  93. segment->total_size - segment->total_copied);
  94. segment->data = NULL;
  95. }
  96. /**
  97. * iscsi_tcp_segment_map - map the current S/G page
  98. * @segment: iscsi_segment
  99. * @recv: 1 if called from recv path
  100. *
  101. * We only need to possibly kmap data if scatter lists are being used,
  102. * because the iscsi passthrough and internal IO paths will never use high
  103. * mem pages.
  104. */
  105. static void iscsi_tcp_segment_map(struct iscsi_segment *segment, int recv)
  106. {
  107. struct scatterlist *sg;
  108. if (segment->data != NULL || !segment->sg)
  109. return;
  110. sg = segment->sg;
  111. BUG_ON(segment->sg_mapped);
  112. BUG_ON(sg->length == 0);
  113. /*
  114. * If the page count is greater than one it is ok to send
  115. * to the network layer's zero copy send path. If not we
  116. * have to go the slow sendmsg path. We always map for the
  117. * recv path.
  118. */
  119. if (page_count(sg_page(sg)) >= 1 && !recv)
  120. return;
  121. segment->sg_mapped = kmap_atomic(sg_page(sg), KM_SOFTIRQ0);
  122. segment->data = segment->sg_mapped + sg->offset + segment->sg_offset;
  123. }
  124. void iscsi_tcp_segment_unmap(struct iscsi_segment *segment)
  125. {
  126. if (segment->sg_mapped) {
  127. kunmap_atomic(segment->sg_mapped, KM_SOFTIRQ0);
  128. segment->sg_mapped = NULL;
  129. segment->data = NULL;
  130. }
  131. }
  132. EXPORT_SYMBOL_GPL(iscsi_tcp_segment_unmap);
  133. /*
  134. * Splice the digest buffer into the buffer
  135. */
  136. static inline void
  137. iscsi_tcp_segment_splice_digest(struct iscsi_segment *segment, void *digest)
  138. {
  139. segment->data = digest;
  140. segment->digest_len = ISCSI_DIGEST_SIZE;
  141. segment->total_size += ISCSI_DIGEST_SIZE;
  142. segment->size = ISCSI_DIGEST_SIZE;
  143. segment->copied = 0;
  144. segment->sg = NULL;
  145. segment->hash = NULL;
  146. }
  147. /**
  148. * iscsi_tcp_segment_done - check whether the segment is complete
  149. * @tcp_conn: iscsi tcp connection
  150. * @segment: iscsi segment to check
  151. * @recv: set to one of this is called from the recv path
  152. * @copied: number of bytes copied
  153. *
  154. * Check if we're done receiving this segment. If the receive
  155. * buffer is full but we expect more data, move on to the
  156. * next entry in the scatterlist.
  157. *
  158. * If the amount of data we received isn't a multiple of 4,
  159. * we will transparently receive the pad bytes, too.
  160. *
  161. * This function must be re-entrant.
  162. */
  163. int iscsi_tcp_segment_done(struct iscsi_tcp_conn *tcp_conn,
  164. struct iscsi_segment *segment, int recv,
  165. unsigned copied)
  166. {
  167. struct scatterlist sg;
  168. unsigned int pad;
  169. ISCSI_DBG_TCP(tcp_conn->iscsi_conn, "copied %u %u size %u %s\n",
  170. segment->copied, copied, segment->size,
  171. recv ? "recv" : "xmit");
  172. if (segment->hash && copied) {
  173. /*
  174. * If a segment is kmapd we must unmap it before sending
  175. * to the crypto layer since that will try to kmap it again.
  176. */
  177. iscsi_tcp_segment_unmap(segment);
  178. if (!segment->data) {
  179. sg_init_table(&sg, 1);
  180. sg_set_page(&sg, sg_page(segment->sg), copied,
  181. segment->copied + segment->sg_offset +
  182. segment->sg->offset);
  183. } else
  184. sg_init_one(&sg, segment->data + segment->copied,
  185. copied);
  186. crypto_hash_update(segment->hash, &sg, copied);
  187. }
  188. segment->copied += copied;
  189. if (segment->copied < segment->size) {
  190. iscsi_tcp_segment_map(segment, recv);
  191. return 0;
  192. }
  193. segment->total_copied += segment->copied;
  194. segment->copied = 0;
  195. segment->size = 0;
  196. /* Unmap the current scatterlist page, if there is one. */
  197. iscsi_tcp_segment_unmap(segment);
  198. /* Do we have more scatterlist entries? */
  199. ISCSI_DBG_TCP(tcp_conn->iscsi_conn, "total copied %u total size %u\n",
  200. segment->total_copied, segment->total_size);
  201. if (segment->total_copied < segment->total_size) {
  202. /* Proceed to the next entry in the scatterlist. */
  203. iscsi_tcp_segment_init_sg(segment, sg_next(segment->sg),
  204. 0);
  205. iscsi_tcp_segment_map(segment, recv);
  206. BUG_ON(segment->size == 0);
  207. return 0;
  208. }
  209. /* Do we need to handle padding? */
  210. if (!(tcp_conn->iscsi_conn->session->tt->caps & CAP_PADDING_OFFLOAD)) {
  211. pad = iscsi_padding(segment->total_copied);
  212. if (pad != 0) {
  213. ISCSI_DBG_TCP(tcp_conn->iscsi_conn,
  214. "consume %d pad bytes\n", pad);
  215. segment->total_size += pad;
  216. segment->size = pad;
  217. segment->data = segment->padbuf;
  218. return 0;
  219. }
  220. }
  221. /*
  222. * Set us up for transferring the data digest. hdr digest
  223. * is completely handled in hdr done function.
  224. */
  225. if (segment->hash) {
  226. crypto_hash_final(segment->hash, segment->digest);
  227. iscsi_tcp_segment_splice_digest(segment,
  228. recv ? segment->recv_digest : segment->digest);
  229. return 0;
  230. }
  231. return 1;
  232. }
  233. EXPORT_SYMBOL_GPL(iscsi_tcp_segment_done);
  234. /**
  235. * iscsi_tcp_segment_recv - copy data to segment
  236. * @tcp_conn: the iSCSI TCP connection
  237. * @segment: the buffer to copy to
  238. * @ptr: data pointer
  239. * @len: amount of data available
  240. *
  241. * This function copies up to @len bytes to the
  242. * given buffer, and returns the number of bytes
  243. * consumed, which can actually be less than @len.
  244. *
  245. * If hash digest is enabled, the function will update the
  246. * hash while copying.
  247. * Combining these two operations doesn't buy us a lot (yet),
  248. * but in the future we could implement combined copy+crc,
  249. * just way we do for network layer checksums.
  250. */
  251. static int
  252. iscsi_tcp_segment_recv(struct iscsi_tcp_conn *tcp_conn,
  253. struct iscsi_segment *segment, const void *ptr,
  254. unsigned int len)
  255. {
  256. unsigned int copy = 0, copied = 0;
  257. while (!iscsi_tcp_segment_done(tcp_conn, segment, 1, copy)) {
  258. if (copied == len) {
  259. ISCSI_DBG_TCP(tcp_conn->iscsi_conn,
  260. "copied %d bytes\n", len);
  261. break;
  262. }
  263. copy = min(len - copied, segment->size - segment->copied);
  264. ISCSI_DBG_TCP(tcp_conn->iscsi_conn, "copying %d\n", copy);
  265. memcpy(segment->data + segment->copied, ptr + copied, copy);
  266. copied += copy;
  267. }
  268. return copied;
  269. }
  270. inline void
  271. iscsi_tcp_dgst_header(struct hash_desc *hash, const void *hdr, size_t hdrlen,
  272. unsigned char digest[ISCSI_DIGEST_SIZE])
  273. {
  274. struct scatterlist sg;
  275. sg_init_one(&sg, hdr, hdrlen);
  276. crypto_hash_digest(hash, &sg, hdrlen, digest);
  277. }
  278. EXPORT_SYMBOL_GPL(iscsi_tcp_dgst_header);
  279. static inline int
  280. iscsi_tcp_dgst_verify(struct iscsi_tcp_conn *tcp_conn,
  281. struct iscsi_segment *segment)
  282. {
  283. if (!segment->digest_len)
  284. return 1;
  285. if (memcmp(segment->recv_digest, segment->digest,
  286. segment->digest_len)) {
  287. ISCSI_DBG_TCP(tcp_conn->iscsi_conn, "digest mismatch\n");
  288. return 0;
  289. }
  290. return 1;
  291. }
  292. /*
  293. * Helper function to set up segment buffer
  294. */
  295. static inline void
  296. __iscsi_segment_init(struct iscsi_segment *segment, size_t size,
  297. iscsi_segment_done_fn_t *done, struct hash_desc *hash)
  298. {
  299. memset(segment, 0, sizeof(*segment));
  300. segment->total_size = size;
  301. segment->done = done;
  302. if (hash) {
  303. segment->hash = hash;
  304. crypto_hash_init(hash);
  305. }
  306. }
  307. inline void
  308. iscsi_segment_init_linear(struct iscsi_segment *segment, void *data,
  309. size_t size, iscsi_segment_done_fn_t *done,
  310. struct hash_desc *hash)
  311. {
  312. __iscsi_segment_init(segment, size, done, hash);
  313. segment->data = data;
  314. segment->size = size;
  315. }
  316. EXPORT_SYMBOL_GPL(iscsi_segment_init_linear);
  317. inline int
  318. iscsi_segment_seek_sg(struct iscsi_segment *segment,
  319. struct scatterlist *sg_list, unsigned int sg_count,
  320. unsigned int offset, size_t size,
  321. iscsi_segment_done_fn_t *done, struct hash_desc *hash)
  322. {
  323. struct scatterlist *sg;
  324. unsigned int i;
  325. __iscsi_segment_init(segment, size, done, hash);
  326. for_each_sg(sg_list, sg, sg_count, i) {
  327. if (offset < sg->length) {
  328. iscsi_tcp_segment_init_sg(segment, sg, offset);
  329. return 0;
  330. }
  331. offset -= sg->length;
  332. }
  333. return ISCSI_ERR_DATA_OFFSET;
  334. }
  335. EXPORT_SYMBOL_GPL(iscsi_segment_seek_sg);
  336. /**
  337. * iscsi_tcp_hdr_recv_prep - prep segment for hdr reception
  338. * @tcp_conn: iscsi connection to prep for
  339. *
  340. * This function always passes NULL for the hash argument, because when this
  341. * function is called we do not yet know the final size of the header and want
  342. * to delay the digest processing until we know that.
  343. */
  344. void iscsi_tcp_hdr_recv_prep(struct iscsi_tcp_conn *tcp_conn)
  345. {
  346. ISCSI_DBG_TCP(tcp_conn->iscsi_conn,
  347. "(%s)\n", tcp_conn->iscsi_conn->hdrdgst_en ?
  348. "digest enabled" : "digest disabled");
  349. iscsi_segment_init_linear(&tcp_conn->in.segment,
  350. tcp_conn->in.hdr_buf, sizeof(struct iscsi_hdr),
  351. iscsi_tcp_hdr_recv_done, NULL);
  352. }
  353. EXPORT_SYMBOL_GPL(iscsi_tcp_hdr_recv_prep);
  354. /*
  355. * Handle incoming reply to any other type of command
  356. */
  357. static int
  358. iscsi_tcp_data_recv_done(struct iscsi_tcp_conn *tcp_conn,
  359. struct iscsi_segment *segment)
  360. {
  361. struct iscsi_conn *conn = tcp_conn->iscsi_conn;
  362. int rc = 0;
  363. if (!iscsi_tcp_dgst_verify(tcp_conn, segment))
  364. return ISCSI_ERR_DATA_DGST;
  365. rc = iscsi_complete_pdu(conn, tcp_conn->in.hdr,
  366. conn->data, tcp_conn->in.datalen);
  367. if (rc)
  368. return rc;
  369. iscsi_tcp_hdr_recv_prep(tcp_conn);
  370. return 0;
  371. }
  372. static void
  373. iscsi_tcp_data_recv_prep(struct iscsi_tcp_conn *tcp_conn)
  374. {
  375. struct iscsi_conn *conn = tcp_conn->iscsi_conn;
  376. struct hash_desc *rx_hash = NULL;
  377. if (conn->datadgst_en &
  378. !(conn->session->tt->caps & CAP_DIGEST_OFFLOAD))
  379. rx_hash = tcp_conn->rx_hash;
  380. iscsi_segment_init_linear(&tcp_conn->in.segment,
  381. conn->data, tcp_conn->in.datalen,
  382. iscsi_tcp_data_recv_done, rx_hash);
  383. }
  384. /**
  385. * iscsi_tcp_cleanup_task - free tcp_task resources
  386. * @task: iscsi task
  387. *
  388. * must be called with session lock
  389. */
  390. void iscsi_tcp_cleanup_task(struct iscsi_task *task)
  391. {
  392. struct iscsi_tcp_task *tcp_task = task->dd_data;
  393. struct iscsi_r2t_info *r2t;
  394. /* nothing to do for mgmt or pending tasks */
  395. if (!task->sc || task->state == ISCSI_TASK_PENDING)
  396. return;
  397. /* flush task's r2t queues */
  398. while (__kfifo_get(tcp_task->r2tqueue, (void*)&r2t, sizeof(void*))) {
  399. __kfifo_put(tcp_task->r2tpool.queue, (void*)&r2t,
  400. sizeof(void*));
  401. ISCSI_DBG_TCP(task->conn, "pending r2t dropped\n");
  402. }
  403. r2t = tcp_task->r2t;
  404. if (r2t != NULL) {
  405. __kfifo_put(tcp_task->r2tpool.queue, (void*)&r2t,
  406. sizeof(void*));
  407. tcp_task->r2t = NULL;
  408. }
  409. }
  410. EXPORT_SYMBOL_GPL(iscsi_tcp_cleanup_task);
  411. /**
  412. * iscsi_tcp_data_in - SCSI Data-In Response processing
  413. * @conn: iscsi connection
  414. * @task: scsi command task
  415. */
  416. static int iscsi_tcp_data_in(struct iscsi_conn *conn, struct iscsi_task *task)
  417. {
  418. struct iscsi_tcp_conn *tcp_conn = conn->dd_data;
  419. struct iscsi_tcp_task *tcp_task = task->dd_data;
  420. struct iscsi_data_rsp *rhdr = (struct iscsi_data_rsp *)tcp_conn->in.hdr;
  421. int datasn = be32_to_cpu(rhdr->datasn);
  422. unsigned total_in_length = scsi_in(task->sc)->length;
  423. iscsi_update_cmdsn(conn->session, (struct iscsi_nopin*)rhdr);
  424. if (tcp_conn->in.datalen == 0)
  425. return 0;
  426. if (tcp_task->exp_datasn != datasn) {
  427. ISCSI_DBG_TCP(conn, "task->exp_datasn(%d) != rhdr->datasn(%d)"
  428. "\n", tcp_task->exp_datasn, datasn);
  429. return ISCSI_ERR_DATASN;
  430. }
  431. tcp_task->exp_datasn++;
  432. tcp_task->data_offset = be32_to_cpu(rhdr->offset);
  433. if (tcp_task->data_offset + tcp_conn->in.datalen > total_in_length) {
  434. ISCSI_DBG_TCP(conn, "data_offset(%d) + data_len(%d) > "
  435. "total_length_in(%d)\n", tcp_task->data_offset,
  436. tcp_conn->in.datalen, total_in_length);
  437. return ISCSI_ERR_DATA_OFFSET;
  438. }
  439. conn->datain_pdus_cnt++;
  440. return 0;
  441. }
  442. /**
  443. * iscsi_tcp_r2t_rsp - iSCSI R2T Response processing
  444. * @conn: iscsi connection
  445. * @task: scsi command task
  446. */
  447. static int iscsi_tcp_r2t_rsp(struct iscsi_conn *conn, struct iscsi_task *task)
  448. {
  449. struct iscsi_session *session = conn->session;
  450. struct iscsi_tcp_task *tcp_task = task->dd_data;
  451. struct iscsi_tcp_conn *tcp_conn = conn->dd_data;
  452. struct iscsi_r2t_rsp *rhdr = (struct iscsi_r2t_rsp *)tcp_conn->in.hdr;
  453. struct iscsi_r2t_info *r2t;
  454. int r2tsn = be32_to_cpu(rhdr->r2tsn);
  455. int rc;
  456. if (tcp_conn->in.datalen) {
  457. iscsi_conn_printk(KERN_ERR, conn,
  458. "invalid R2t with datalen %d\n",
  459. tcp_conn->in.datalen);
  460. return ISCSI_ERR_DATALEN;
  461. }
  462. if (tcp_task->exp_datasn != r2tsn){
  463. ISCSI_DBG_TCP(conn, "task->exp_datasn(%d) != rhdr->r2tsn(%d)\n",
  464. tcp_task->exp_datasn, r2tsn);
  465. return ISCSI_ERR_R2TSN;
  466. }
  467. /* fill-in new R2T associated with the task */
  468. iscsi_update_cmdsn(session, (struct iscsi_nopin*)rhdr);
  469. if (!task->sc || session->state != ISCSI_STATE_LOGGED_IN) {
  470. iscsi_conn_printk(KERN_INFO, conn,
  471. "dropping R2T itt %d in recovery.\n",
  472. task->itt);
  473. return 0;
  474. }
  475. rc = __kfifo_get(tcp_task->r2tpool.queue, (void*)&r2t, sizeof(void*));
  476. if (!rc) {
  477. iscsi_conn_printk(KERN_ERR, conn, "Could not allocate R2T. "
  478. "Target has sent more R2Ts than it "
  479. "negotiated for or driver has has leaked.\n");
  480. return ISCSI_ERR_PROTO;
  481. }
  482. r2t->exp_statsn = rhdr->statsn;
  483. r2t->data_length = be32_to_cpu(rhdr->data_length);
  484. if (r2t->data_length == 0) {
  485. iscsi_conn_printk(KERN_ERR, conn,
  486. "invalid R2T with zero data len\n");
  487. __kfifo_put(tcp_task->r2tpool.queue, (void*)&r2t,
  488. sizeof(void*));
  489. return ISCSI_ERR_DATALEN;
  490. }
  491. if (r2t->data_length > session->max_burst)
  492. ISCSI_DBG_TCP(conn, "invalid R2T with data len %u and max "
  493. "burst %u. Attempting to execute request.\n",
  494. r2t->data_length, session->max_burst);
  495. r2t->data_offset = be32_to_cpu(rhdr->data_offset);
  496. if (r2t->data_offset + r2t->data_length > scsi_out(task->sc)->length) {
  497. iscsi_conn_printk(KERN_ERR, conn,
  498. "invalid R2T with data len %u at offset %u "
  499. "and total length %d\n", r2t->data_length,
  500. r2t->data_offset, scsi_out(task->sc)->length);
  501. __kfifo_put(tcp_task->r2tpool.queue, (void*)&r2t,
  502. sizeof(void*));
  503. return ISCSI_ERR_DATALEN;
  504. }
  505. r2t->ttt = rhdr->ttt; /* no flip */
  506. r2t->datasn = 0;
  507. r2t->sent = 0;
  508. tcp_task->exp_datasn = r2tsn + 1;
  509. __kfifo_put(tcp_task->r2tqueue, (void*)&r2t, sizeof(void*));
  510. conn->r2t_pdus_cnt++;
  511. iscsi_requeue_task(task);
  512. return 0;
  513. }
  514. /*
  515. * Handle incoming reply to DataIn command
  516. */
  517. static int
  518. iscsi_tcp_process_data_in(struct iscsi_tcp_conn *tcp_conn,
  519. struct iscsi_segment *segment)
  520. {
  521. struct iscsi_conn *conn = tcp_conn->iscsi_conn;
  522. struct iscsi_hdr *hdr = tcp_conn->in.hdr;
  523. int rc;
  524. if (!iscsi_tcp_dgst_verify(tcp_conn, segment))
  525. return ISCSI_ERR_DATA_DGST;
  526. /* check for non-exceptional status */
  527. if (hdr->flags & ISCSI_FLAG_DATA_STATUS) {
  528. rc = iscsi_complete_pdu(conn, tcp_conn->in.hdr, NULL, 0);
  529. if (rc)
  530. return rc;
  531. }
  532. iscsi_tcp_hdr_recv_prep(tcp_conn);
  533. return 0;
  534. }
  535. /**
  536. * iscsi_tcp_hdr_dissect - process PDU header
  537. * @conn: iSCSI connection
  538. * @hdr: PDU header
  539. *
  540. * This function analyzes the header of the PDU received,
  541. * and performs several sanity checks. If the PDU is accompanied
  542. * by data, the receive buffer is set up to copy the incoming data
  543. * to the correct location.
  544. */
  545. static int
  546. iscsi_tcp_hdr_dissect(struct iscsi_conn *conn, struct iscsi_hdr *hdr)
  547. {
  548. int rc = 0, opcode, ahslen;
  549. struct iscsi_tcp_conn *tcp_conn = conn->dd_data;
  550. struct iscsi_task *task;
  551. /* verify PDU length */
  552. tcp_conn->in.datalen = ntoh24(hdr->dlength);
  553. if (tcp_conn->in.datalen > conn->max_recv_dlength) {
  554. iscsi_conn_printk(KERN_ERR, conn,
  555. "iscsi_tcp: datalen %d > %d\n",
  556. tcp_conn->in.datalen, conn->max_recv_dlength);
  557. return ISCSI_ERR_DATALEN;
  558. }
  559. /* Additional header segments. So far, we don't
  560. * process additional headers.
  561. */
  562. ahslen = hdr->hlength << 2;
  563. opcode = hdr->opcode & ISCSI_OPCODE_MASK;
  564. /* verify itt (itt encoding: age+cid+itt) */
  565. rc = iscsi_verify_itt(conn, hdr->itt);
  566. if (rc)
  567. return rc;
  568. ISCSI_DBG_TCP(conn, "opcode 0x%x ahslen %d datalen %d\n",
  569. opcode, ahslen, tcp_conn->in.datalen);
  570. switch(opcode) {
  571. case ISCSI_OP_SCSI_DATA_IN:
  572. spin_lock(&conn->session->lock);
  573. task = iscsi_itt_to_ctask(conn, hdr->itt);
  574. if (!task)
  575. rc = ISCSI_ERR_BAD_ITT;
  576. else
  577. rc = iscsi_tcp_data_in(conn, task);
  578. if (rc) {
  579. spin_unlock(&conn->session->lock);
  580. break;
  581. }
  582. if (tcp_conn->in.datalen) {
  583. struct iscsi_tcp_task *tcp_task = task->dd_data;
  584. struct hash_desc *rx_hash = NULL;
  585. struct scsi_data_buffer *sdb = scsi_in(task->sc);
  586. /*
  587. * Setup copy of Data-In into the Scsi_Cmnd
  588. * Scatterlist case:
  589. * We set up the iscsi_segment to point to the next
  590. * scatterlist entry to copy to. As we go along,
  591. * we move on to the next scatterlist entry and
  592. * update the digest per-entry.
  593. */
  594. if (conn->datadgst_en &&
  595. !(conn->session->tt->caps & CAP_DIGEST_OFFLOAD))
  596. rx_hash = tcp_conn->rx_hash;
  597. ISCSI_DBG_TCP(conn, "iscsi_tcp_begin_data_in( "
  598. "offset=%d, datalen=%d)\n",
  599. tcp_task->data_offset,
  600. tcp_conn->in.datalen);
  601. rc = iscsi_segment_seek_sg(&tcp_conn->in.segment,
  602. sdb->table.sgl,
  603. sdb->table.nents,
  604. tcp_task->data_offset,
  605. tcp_conn->in.datalen,
  606. iscsi_tcp_process_data_in,
  607. rx_hash);
  608. spin_unlock(&conn->session->lock);
  609. return rc;
  610. }
  611. rc = __iscsi_complete_pdu(conn, hdr, NULL, 0);
  612. spin_unlock(&conn->session->lock);
  613. break;
  614. case ISCSI_OP_SCSI_CMD_RSP:
  615. if (tcp_conn->in.datalen) {
  616. iscsi_tcp_data_recv_prep(tcp_conn);
  617. return 0;
  618. }
  619. rc = iscsi_complete_pdu(conn, hdr, NULL, 0);
  620. break;
  621. case ISCSI_OP_R2T:
  622. spin_lock(&conn->session->lock);
  623. task = iscsi_itt_to_ctask(conn, hdr->itt);
  624. if (!task)
  625. rc = ISCSI_ERR_BAD_ITT;
  626. else if (ahslen)
  627. rc = ISCSI_ERR_AHSLEN;
  628. else if (task->sc->sc_data_direction == DMA_TO_DEVICE)
  629. rc = iscsi_tcp_r2t_rsp(conn, task);
  630. else
  631. rc = ISCSI_ERR_PROTO;
  632. spin_unlock(&conn->session->lock);
  633. break;
  634. case ISCSI_OP_LOGIN_RSP:
  635. case ISCSI_OP_TEXT_RSP:
  636. case ISCSI_OP_REJECT:
  637. case ISCSI_OP_ASYNC_EVENT:
  638. /*
  639. * It is possible that we could get a PDU with a buffer larger
  640. * than 8K, but there are no targets that currently do this.
  641. * For now we fail until we find a vendor that needs it
  642. */
  643. if (ISCSI_DEF_MAX_RECV_SEG_LEN < tcp_conn->in.datalen) {
  644. iscsi_conn_printk(KERN_ERR, conn,
  645. "iscsi_tcp: received buffer of "
  646. "len %u but conn buffer is only %u "
  647. "(opcode %0x)\n",
  648. tcp_conn->in.datalen,
  649. ISCSI_DEF_MAX_RECV_SEG_LEN, opcode);
  650. rc = ISCSI_ERR_PROTO;
  651. break;
  652. }
  653. /* If there's data coming in with the response,
  654. * receive it to the connection's buffer.
  655. */
  656. if (tcp_conn->in.datalen) {
  657. iscsi_tcp_data_recv_prep(tcp_conn);
  658. return 0;
  659. }
  660. /* fall through */
  661. case ISCSI_OP_LOGOUT_RSP:
  662. case ISCSI_OP_NOOP_IN:
  663. case ISCSI_OP_SCSI_TMFUNC_RSP:
  664. rc = iscsi_complete_pdu(conn, hdr, NULL, 0);
  665. break;
  666. default:
  667. rc = ISCSI_ERR_BAD_OPCODE;
  668. break;
  669. }
  670. if (rc == 0) {
  671. /* Anything that comes with data should have
  672. * been handled above. */
  673. if (tcp_conn->in.datalen)
  674. return ISCSI_ERR_PROTO;
  675. iscsi_tcp_hdr_recv_prep(tcp_conn);
  676. }
  677. return rc;
  678. }
  679. /**
  680. * iscsi_tcp_hdr_recv_done - process PDU header
  681. *
  682. * This is the callback invoked when the PDU header has
  683. * been received. If the header is followed by additional
  684. * header segments, we go back for more data.
  685. */
  686. static int
  687. iscsi_tcp_hdr_recv_done(struct iscsi_tcp_conn *tcp_conn,
  688. struct iscsi_segment *segment)
  689. {
  690. struct iscsi_conn *conn = tcp_conn->iscsi_conn;
  691. struct iscsi_hdr *hdr;
  692. /* Check if there are additional header segments
  693. * *prior* to computing the digest, because we
  694. * may need to go back to the caller for more.
  695. */
  696. hdr = (struct iscsi_hdr *) tcp_conn->in.hdr_buf;
  697. if (segment->copied == sizeof(struct iscsi_hdr) && hdr->hlength) {
  698. /* Bump the header length - the caller will
  699. * just loop around and get the AHS for us, and
  700. * call again. */
  701. unsigned int ahslen = hdr->hlength << 2;
  702. /* Make sure we don't overflow */
  703. if (sizeof(*hdr) + ahslen > sizeof(tcp_conn->in.hdr_buf))
  704. return ISCSI_ERR_AHSLEN;
  705. segment->total_size += ahslen;
  706. segment->size += ahslen;
  707. return 0;
  708. }
  709. /* We're done processing the header. See if we're doing
  710. * header digests; if so, set up the recv_digest buffer
  711. * and go back for more. */
  712. if (conn->hdrdgst_en &&
  713. !(conn->session->tt->caps & CAP_DIGEST_OFFLOAD)) {
  714. if (segment->digest_len == 0) {
  715. /*
  716. * Even if we offload the digest processing we
  717. * splice it in so we can increment the skb/segment
  718. * counters in preparation for the data segment.
  719. */
  720. iscsi_tcp_segment_splice_digest(segment,
  721. segment->recv_digest);
  722. return 0;
  723. }
  724. iscsi_tcp_dgst_header(tcp_conn->rx_hash, hdr,
  725. segment->total_copied - ISCSI_DIGEST_SIZE,
  726. segment->digest);
  727. if (!iscsi_tcp_dgst_verify(tcp_conn, segment))
  728. return ISCSI_ERR_HDR_DGST;
  729. }
  730. tcp_conn->in.hdr = hdr;
  731. return iscsi_tcp_hdr_dissect(conn, hdr);
  732. }
  733. /**
  734. * iscsi_tcp_recv_segment_is_hdr - tests if we are reading in a header
  735. * @tcp_conn: iscsi tcp conn
  736. *
  737. * returns non zero if we are currently processing or setup to process
  738. * a header.
  739. */
  740. inline int iscsi_tcp_recv_segment_is_hdr(struct iscsi_tcp_conn *tcp_conn)
  741. {
  742. return tcp_conn->in.segment.done == iscsi_tcp_hdr_recv_done;
  743. }
  744. EXPORT_SYMBOL_GPL(iscsi_tcp_recv_segment_is_hdr);
  745. /**
  746. * iscsi_tcp_recv_skb - Process skb
  747. * @conn: iscsi connection
  748. * @skb: network buffer with header and/or data segment
  749. * @offset: offset in skb
  750. * @offload: bool indicating if transfer was offloaded
  751. *
  752. * Will return status of transfer in status. And will return
  753. * number of bytes copied.
  754. */
  755. int iscsi_tcp_recv_skb(struct iscsi_conn *conn, struct sk_buff *skb,
  756. unsigned int offset, bool offloaded, int *status)
  757. {
  758. struct iscsi_tcp_conn *tcp_conn = conn->dd_data;
  759. struct iscsi_segment *segment = &tcp_conn->in.segment;
  760. struct skb_seq_state seq;
  761. unsigned int consumed = 0;
  762. int rc = 0;
  763. ISCSI_DBG_TCP(conn, "in %d bytes\n", skb->len - offset);
  764. if (unlikely(conn->suspend_rx)) {
  765. ISCSI_DBG_TCP(conn, "Rx suspended!\n");
  766. *status = ISCSI_TCP_SUSPENDED;
  767. return 0;
  768. }
  769. if (offloaded) {
  770. segment->total_copied = segment->total_size;
  771. goto segment_done;
  772. }
  773. skb_prepare_seq_read(skb, offset, skb->len, &seq);
  774. while (1) {
  775. unsigned int avail;
  776. const u8 *ptr;
  777. avail = skb_seq_read(consumed, &ptr, &seq);
  778. if (avail == 0) {
  779. ISCSI_DBG_TCP(conn, "no more data avail. Consumed %d\n",
  780. consumed);
  781. *status = ISCSI_TCP_SKB_DONE;
  782. skb_abort_seq_read(&seq);
  783. goto skb_done;
  784. }
  785. BUG_ON(segment->copied >= segment->size);
  786. ISCSI_DBG_TCP(conn, "skb %p ptr=%p avail=%u\n", skb, ptr,
  787. avail);
  788. rc = iscsi_tcp_segment_recv(tcp_conn, segment, ptr, avail);
  789. BUG_ON(rc == 0);
  790. consumed += rc;
  791. if (segment->total_copied >= segment->total_size) {
  792. skb_abort_seq_read(&seq);
  793. goto segment_done;
  794. }
  795. }
  796. segment_done:
  797. *status = ISCSI_TCP_SEGMENT_DONE;
  798. ISCSI_DBG_TCP(conn, "segment done\n");
  799. rc = segment->done(tcp_conn, segment);
  800. if (rc != 0) {
  801. *status = ISCSI_TCP_CONN_ERR;
  802. ISCSI_DBG_TCP(conn, "Error receiving PDU, errno=%d\n", rc);
  803. iscsi_conn_failure(conn, rc);
  804. return 0;
  805. }
  806. /* The done() functions sets up the next segment. */
  807. skb_done:
  808. conn->rxdata_octets += consumed;
  809. return consumed;
  810. }
  811. EXPORT_SYMBOL_GPL(iscsi_tcp_recv_skb);
  812. /**
  813. * iscsi_tcp_task_init - Initialize iSCSI SCSI_READ or SCSI_WRITE commands
  814. * @conn: iscsi connection
  815. * @task: scsi command task
  816. * @sc: scsi command
  817. */
  818. int iscsi_tcp_task_init(struct iscsi_task *task)
  819. {
  820. struct iscsi_tcp_task *tcp_task = task->dd_data;
  821. struct iscsi_conn *conn = task->conn;
  822. struct scsi_cmnd *sc = task->sc;
  823. int err;
  824. if (!sc) {
  825. /*
  826. * mgmt tasks do not have a scatterlist since they come
  827. * in from the iscsi interface.
  828. */
  829. ISCSI_DBG_TCP(conn, "mtask deq [itt 0x%x]\n", task->itt);
  830. return conn->session->tt->init_pdu(task, 0, task->data_count);
  831. }
  832. BUG_ON(__kfifo_len(tcp_task->r2tqueue));
  833. tcp_task->exp_datasn = 0;
  834. /* Prepare PDU, optionally w/ immediate data */
  835. ISCSI_DBG_TCP(conn, "task deq [itt 0x%x imm %d unsol %d]\n",
  836. task->itt, task->imm_count, task->unsol_r2t.data_length);
  837. err = conn->session->tt->init_pdu(task, 0, task->imm_count);
  838. if (err)
  839. return err;
  840. task->imm_count = 0;
  841. return 0;
  842. }
  843. EXPORT_SYMBOL_GPL(iscsi_tcp_task_init);
  844. static struct iscsi_r2t_info *iscsi_tcp_get_curr_r2t(struct iscsi_task *task)
  845. {
  846. struct iscsi_session *session = task->conn->session;
  847. struct iscsi_tcp_task *tcp_task = task->dd_data;
  848. struct iscsi_r2t_info *r2t = NULL;
  849. if (iscsi_task_has_unsol_data(task))
  850. r2t = &task->unsol_r2t;
  851. else {
  852. spin_lock_bh(&session->lock);
  853. if (tcp_task->r2t) {
  854. r2t = tcp_task->r2t;
  855. /* Continue with this R2T? */
  856. if (r2t->data_length <= r2t->sent) {
  857. ISCSI_DBG_TCP(task->conn,
  858. " done with r2t %p\n", r2t);
  859. __kfifo_put(tcp_task->r2tpool.queue,
  860. (void *)&tcp_task->r2t,
  861. sizeof(void *));
  862. tcp_task->r2t = r2t = NULL;
  863. }
  864. }
  865. if (r2t == NULL) {
  866. __kfifo_get(tcp_task->r2tqueue,
  867. (void *)&tcp_task->r2t, sizeof(void *));
  868. r2t = tcp_task->r2t;
  869. }
  870. spin_unlock_bh(&session->lock);
  871. }
  872. return r2t;
  873. }
  874. /**
  875. * iscsi_tcp_task_xmit - xmit normal PDU task
  876. * @task: iscsi command task
  877. *
  878. * We're expected to return 0 when everything was transmitted succesfully,
  879. * -EAGAIN if there's still data in the queue, or != 0 for any other kind
  880. * of error.
  881. */
  882. int iscsi_tcp_task_xmit(struct iscsi_task *task)
  883. {
  884. struct iscsi_conn *conn = task->conn;
  885. struct iscsi_session *session = conn->session;
  886. struct iscsi_r2t_info *r2t;
  887. int rc = 0;
  888. flush:
  889. /* Flush any pending data first. */
  890. rc = session->tt->xmit_pdu(task);
  891. if (rc < 0)
  892. return rc;
  893. /* mgmt command */
  894. if (!task->sc) {
  895. if (task->hdr->itt == RESERVED_ITT)
  896. iscsi_put_task(task);
  897. return 0;
  898. }
  899. /* Are we done already? */
  900. if (task->sc->sc_data_direction != DMA_TO_DEVICE)
  901. return 0;
  902. r2t = iscsi_tcp_get_curr_r2t(task);
  903. if (r2t == NULL) {
  904. /* Waiting for more R2Ts to arrive. */
  905. ISCSI_DBG_TCP(conn, "no R2Ts yet\n");
  906. return 0;
  907. }
  908. rc = conn->session->tt->alloc_pdu(task, ISCSI_OP_SCSI_DATA_OUT);
  909. if (rc)
  910. return rc;
  911. iscsi_prep_data_out_pdu(task, r2t, (struct iscsi_data *) task->hdr);
  912. ISCSI_DBG_TCP(conn, "sol dout %p [dsn %d itt 0x%x doff %d dlen %d]\n",
  913. r2t, r2t->datasn - 1, task->hdr->itt,
  914. r2t->data_offset + r2t->sent, r2t->data_count);
  915. rc = conn->session->tt->init_pdu(task, r2t->data_offset + r2t->sent,
  916. r2t->data_count);
  917. if (rc)
  918. return rc;
  919. r2t->sent += r2t->data_count;
  920. goto flush;
  921. }
  922. EXPORT_SYMBOL_GPL(iscsi_tcp_task_xmit);
  923. struct iscsi_cls_conn *
  924. iscsi_tcp_conn_setup(struct iscsi_cls_session *cls_session, int dd_data_size,
  925. uint32_t conn_idx)
  926. {
  927. struct iscsi_conn *conn;
  928. struct iscsi_cls_conn *cls_conn;
  929. struct iscsi_tcp_conn *tcp_conn;
  930. cls_conn = iscsi_conn_setup(cls_session, sizeof(*tcp_conn), conn_idx);
  931. if (!cls_conn)
  932. return NULL;
  933. conn = cls_conn->dd_data;
  934. /*
  935. * due to strange issues with iser these are not set
  936. * in iscsi_conn_setup
  937. */
  938. conn->max_recv_dlength = ISCSI_DEF_MAX_RECV_SEG_LEN;
  939. tcp_conn = conn->dd_data;
  940. tcp_conn->iscsi_conn = conn;
  941. tcp_conn->dd_data = kzalloc(dd_data_size, GFP_KERNEL);
  942. if (!tcp_conn->dd_data) {
  943. iscsi_conn_teardown(cls_conn);
  944. return NULL;
  945. }
  946. return cls_conn;
  947. }
  948. EXPORT_SYMBOL_GPL(iscsi_tcp_conn_setup);
  949. void iscsi_tcp_conn_teardown(struct iscsi_cls_conn *cls_conn)
  950. {
  951. struct iscsi_conn *conn = cls_conn->dd_data;
  952. struct iscsi_tcp_conn *tcp_conn = conn->dd_data;
  953. kfree(tcp_conn->dd_data);
  954. iscsi_conn_teardown(cls_conn);
  955. }
  956. EXPORT_SYMBOL_GPL(iscsi_tcp_conn_teardown);
  957. int iscsi_tcp_r2tpool_alloc(struct iscsi_session *session)
  958. {
  959. int i;
  960. int cmd_i;
  961. /*
  962. * initialize per-task: R2T pool and xmit queue
  963. */
  964. for (cmd_i = 0; cmd_i < session->cmds_max; cmd_i++) {
  965. struct iscsi_task *task = session->cmds[cmd_i];
  966. struct iscsi_tcp_task *tcp_task = task->dd_data;
  967. /*
  968. * pre-allocated x2 as much r2ts to handle race when
  969. * target acks DataOut faster than we data_xmit() queues
  970. * could replenish r2tqueue.
  971. */
  972. /* R2T pool */
  973. if (iscsi_pool_init(&tcp_task->r2tpool,
  974. session->max_r2t * 2, NULL,
  975. sizeof(struct iscsi_r2t_info))) {
  976. goto r2t_alloc_fail;
  977. }
  978. /* R2T xmit queue */
  979. tcp_task->r2tqueue = kfifo_alloc(
  980. session->max_r2t * 4 * sizeof(void*), GFP_KERNEL, NULL);
  981. if (tcp_task->r2tqueue == ERR_PTR(-ENOMEM)) {
  982. iscsi_pool_free(&tcp_task->r2tpool);
  983. goto r2t_alloc_fail;
  984. }
  985. }
  986. return 0;
  987. r2t_alloc_fail:
  988. for (i = 0; i < cmd_i; i++) {
  989. struct iscsi_task *task = session->cmds[i];
  990. struct iscsi_tcp_task *tcp_task = task->dd_data;
  991. kfifo_free(tcp_task->r2tqueue);
  992. iscsi_pool_free(&tcp_task->r2tpool);
  993. }
  994. return -ENOMEM;
  995. }
  996. EXPORT_SYMBOL_GPL(iscsi_tcp_r2tpool_alloc);
  997. void iscsi_tcp_r2tpool_free(struct iscsi_session *session)
  998. {
  999. int i;
  1000. for (i = 0; i < session->cmds_max; i++) {
  1001. struct iscsi_task *task = session->cmds[i];
  1002. struct iscsi_tcp_task *tcp_task = task->dd_data;
  1003. kfifo_free(tcp_task->r2tqueue);
  1004. iscsi_pool_free(&tcp_task->r2tpool);
  1005. }
  1006. }
  1007. EXPORT_SYMBOL_GPL(iscsi_tcp_r2tpool_free);
  1008. void iscsi_tcp_conn_get_stats(struct iscsi_cls_conn *cls_conn,
  1009. struct iscsi_stats *stats)
  1010. {
  1011. struct iscsi_conn *conn = cls_conn->dd_data;
  1012. stats->txdata_octets = conn->txdata_octets;
  1013. stats->rxdata_octets = conn->rxdata_octets;
  1014. stats->scsicmd_pdus = conn->scsicmd_pdus_cnt;
  1015. stats->dataout_pdus = conn->dataout_pdus_cnt;
  1016. stats->scsirsp_pdus = conn->scsirsp_pdus_cnt;
  1017. stats->datain_pdus = conn->datain_pdus_cnt;
  1018. stats->r2t_pdus = conn->r2t_pdus_cnt;
  1019. stats->tmfcmd_pdus = conn->tmfcmd_pdus_cnt;
  1020. stats->tmfrsp_pdus = conn->tmfrsp_pdus_cnt;
  1021. }
  1022. EXPORT_SYMBOL_GPL(iscsi_tcp_conn_get_stats);