dvb_ringbuffer.c 9.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370
  1. /*
  2. *
  3. * dvb_ringbuffer.c: ring buffer implementation for the dvb driver
  4. *
  5. * Copyright (C) 2003 Oliver Endriss
  6. * Copyright (C) 2004 Andrew de Quincey
  7. *
  8. * based on code originally found in av7110.c & dvb_ci.c:
  9. * Copyright (C) 1999-2003 Ralph Metzler
  10. * & Marcus Metzler for convergence integrated media GmbH
  11. *
  12. * This program is free software; you can redistribute it and/or
  13. * modify it under the terms of the GNU Lesser General Public License
  14. * as published by the Free Software Foundation; either version 2.1
  15. * of the License, or (at your option) any later version.
  16. *
  17. * This program is distributed in the hope that it will be useful,
  18. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  20. * GNU Lesser General Public License for more details.
  21. */
  22. #include <linux/errno.h>
  23. #include <linux/kernel.h>
  24. #include <linux/module.h>
  25. #include <linux/sched.h>
  26. #include <linux/string.h>
  27. #include <linux/uaccess.h>
  28. #include <media/dvb_ringbuffer.h>
  29. #define PKT_READY 0
  30. #define PKT_DISPOSED 1
  31. void dvb_ringbuffer_init(struct dvb_ringbuffer *rbuf, void *data, size_t len)
  32. {
  33. rbuf->pread=rbuf->pwrite=0;
  34. rbuf->data=data;
  35. rbuf->size=len;
  36. rbuf->error=0;
  37. init_waitqueue_head(&rbuf->queue);
  38. spin_lock_init(&(rbuf->lock));
  39. }
  40. int dvb_ringbuffer_empty(struct dvb_ringbuffer *rbuf)
  41. {
  42. /* smp_load_acquire() to load write pointer on reader side
  43. * this pairs with smp_store_release() in dvb_ringbuffer_write(),
  44. * dvb_ringbuffer_write_user(), or dvb_ringbuffer_reset()
  45. *
  46. * for memory barriers also see Documentation/core-api/circular-buffers.rst
  47. */
  48. return (rbuf->pread == smp_load_acquire(&rbuf->pwrite));
  49. }
  50. ssize_t dvb_ringbuffer_free(struct dvb_ringbuffer *rbuf)
  51. {
  52. ssize_t free;
  53. /* READ_ONCE() to load read pointer on writer side
  54. * this pairs with smp_store_release() in dvb_ringbuffer_read(),
  55. * dvb_ringbuffer_read_user(), dvb_ringbuffer_flush(),
  56. * or dvb_ringbuffer_reset()
  57. */
  58. free = READ_ONCE(rbuf->pread) - rbuf->pwrite;
  59. if (free <= 0)
  60. free += rbuf->size;
  61. return free-1;
  62. }
  63. ssize_t dvb_ringbuffer_avail(struct dvb_ringbuffer *rbuf)
  64. {
  65. ssize_t avail;
  66. /* smp_load_acquire() to load write pointer on reader side
  67. * this pairs with smp_store_release() in dvb_ringbuffer_write(),
  68. * dvb_ringbuffer_write_user(), or dvb_ringbuffer_reset()
  69. */
  70. avail = smp_load_acquire(&rbuf->pwrite) - rbuf->pread;
  71. if (avail < 0)
  72. avail += rbuf->size;
  73. return avail;
  74. }
  75. void dvb_ringbuffer_flush(struct dvb_ringbuffer *rbuf)
  76. {
  77. /* dvb_ringbuffer_flush() counts as read operation
  78. * smp_load_acquire() to load write pointer
  79. * smp_store_release() to update read pointer, this ensures that the
  80. * correct pointer is visible for subsequent dvb_ringbuffer_free()
  81. * calls on other cpu cores
  82. */
  83. smp_store_release(&rbuf->pread, smp_load_acquire(&rbuf->pwrite));
  84. rbuf->error = 0;
  85. }
  86. EXPORT_SYMBOL(dvb_ringbuffer_flush);
  87. void dvb_ringbuffer_reset(struct dvb_ringbuffer *rbuf)
  88. {
  89. /* dvb_ringbuffer_reset() counts as read and write operation
  90. * smp_store_release() to update read pointer
  91. */
  92. smp_store_release(&rbuf->pread, 0);
  93. /* smp_store_release() to update write pointer */
  94. smp_store_release(&rbuf->pwrite, 0);
  95. rbuf->error = 0;
  96. }
  97. void dvb_ringbuffer_flush_spinlock_wakeup(struct dvb_ringbuffer *rbuf)
  98. {
  99. unsigned long flags;
  100. spin_lock_irqsave(&rbuf->lock, flags);
  101. dvb_ringbuffer_flush(rbuf);
  102. spin_unlock_irqrestore(&rbuf->lock, flags);
  103. wake_up(&rbuf->queue);
  104. }
  105. ssize_t dvb_ringbuffer_read_user(struct dvb_ringbuffer *rbuf, u8 __user *buf, size_t len)
  106. {
  107. size_t todo = len;
  108. size_t split;
  109. split = (rbuf->pread + len > rbuf->size) ? rbuf->size - rbuf->pread : 0;
  110. if (split > 0) {
  111. if (copy_to_user(buf, rbuf->data+rbuf->pread, split))
  112. return -EFAULT;
  113. buf += split;
  114. todo -= split;
  115. /* smp_store_release() for read pointer update to ensure
  116. * that buf is not overwritten until read is complete,
  117. * this pairs with READ_ONCE() in dvb_ringbuffer_free()
  118. */
  119. smp_store_release(&rbuf->pread, 0);
  120. }
  121. if (copy_to_user(buf, rbuf->data+rbuf->pread, todo))
  122. return -EFAULT;
  123. /* smp_store_release() to update read pointer, see above */
  124. smp_store_release(&rbuf->pread, (rbuf->pread + todo) % rbuf->size);
  125. return len;
  126. }
  127. void dvb_ringbuffer_read(struct dvb_ringbuffer *rbuf, u8 *buf, size_t len)
  128. {
  129. size_t todo = len;
  130. size_t split;
  131. split = (rbuf->pread + len > rbuf->size) ? rbuf->size - rbuf->pread : 0;
  132. if (split > 0) {
  133. memcpy(buf, rbuf->data+rbuf->pread, split);
  134. buf += split;
  135. todo -= split;
  136. /* smp_store_release() for read pointer update to ensure
  137. * that buf is not overwritten until read is complete,
  138. * this pairs with READ_ONCE() in dvb_ringbuffer_free()
  139. */
  140. smp_store_release(&rbuf->pread, 0);
  141. }
  142. memcpy(buf, rbuf->data+rbuf->pread, todo);
  143. /* smp_store_release() to update read pointer, see above */
  144. smp_store_release(&rbuf->pread, (rbuf->pread + todo) % rbuf->size);
  145. }
  146. ssize_t dvb_ringbuffer_write(struct dvb_ringbuffer *rbuf, const u8 *buf, size_t len)
  147. {
  148. size_t todo = len;
  149. size_t split;
  150. split = (rbuf->pwrite + len > rbuf->size) ? rbuf->size - rbuf->pwrite : 0;
  151. if (split > 0) {
  152. memcpy(rbuf->data+rbuf->pwrite, buf, split);
  153. buf += split;
  154. todo -= split;
  155. /* smp_store_release() for write pointer update to ensure that
  156. * written data is visible on other cpu cores before the pointer
  157. * update, this pairs with smp_load_acquire() in
  158. * dvb_ringbuffer_empty() or dvb_ringbuffer_avail()
  159. */
  160. smp_store_release(&rbuf->pwrite, 0);
  161. }
  162. memcpy(rbuf->data+rbuf->pwrite, buf, todo);
  163. /* smp_store_release() for write pointer update, see above */
  164. smp_store_release(&rbuf->pwrite, (rbuf->pwrite + todo) % rbuf->size);
  165. return len;
  166. }
  167. ssize_t dvb_ringbuffer_write_user(struct dvb_ringbuffer *rbuf,
  168. const u8 __user *buf, size_t len)
  169. {
  170. int status;
  171. size_t todo = len;
  172. size_t split;
  173. split = (rbuf->pwrite + len > rbuf->size) ? rbuf->size - rbuf->pwrite : 0;
  174. if (split > 0) {
  175. status = copy_from_user(rbuf->data+rbuf->pwrite, buf, split);
  176. if (status)
  177. return len - todo;
  178. buf += split;
  179. todo -= split;
  180. /* smp_store_release() for write pointer update to ensure that
  181. * written data is visible on other cpu cores before the pointer
  182. * update, this pairs with smp_load_acquire() in
  183. * dvb_ringbuffer_empty() or dvb_ringbuffer_avail()
  184. */
  185. smp_store_release(&rbuf->pwrite, 0);
  186. }
  187. status = copy_from_user(rbuf->data+rbuf->pwrite, buf, todo);
  188. if (status)
  189. return len - todo;
  190. /* smp_store_release() for write pointer update, see above */
  191. smp_store_release(&rbuf->pwrite, (rbuf->pwrite + todo) % rbuf->size);
  192. return len;
  193. }
  194. ssize_t dvb_ringbuffer_pkt_write(struct dvb_ringbuffer *rbuf, u8* buf, size_t len)
  195. {
  196. int status;
  197. ssize_t oldpwrite = rbuf->pwrite;
  198. DVB_RINGBUFFER_WRITE_BYTE(rbuf, len >> 8);
  199. DVB_RINGBUFFER_WRITE_BYTE(rbuf, len & 0xff);
  200. DVB_RINGBUFFER_WRITE_BYTE(rbuf, PKT_READY);
  201. status = dvb_ringbuffer_write(rbuf, buf, len);
  202. if (status < 0) rbuf->pwrite = oldpwrite;
  203. return status;
  204. }
  205. ssize_t dvb_ringbuffer_pkt_read_user(struct dvb_ringbuffer *rbuf, size_t idx,
  206. int offset, u8 __user *buf, size_t len)
  207. {
  208. size_t todo;
  209. size_t split;
  210. size_t pktlen;
  211. pktlen = rbuf->data[idx] << 8;
  212. pktlen |= rbuf->data[(idx + 1) % rbuf->size];
  213. if (offset > pktlen) return -EINVAL;
  214. if ((offset + len) > pktlen) len = pktlen - offset;
  215. idx = (idx + DVB_RINGBUFFER_PKTHDRSIZE + offset) % rbuf->size;
  216. todo = len;
  217. split = ((idx + len) > rbuf->size) ? rbuf->size - idx : 0;
  218. if (split > 0) {
  219. if (copy_to_user(buf, rbuf->data+idx, split))
  220. return -EFAULT;
  221. buf += split;
  222. todo -= split;
  223. idx = 0;
  224. }
  225. if (copy_to_user(buf, rbuf->data+idx, todo))
  226. return -EFAULT;
  227. return len;
  228. }
  229. ssize_t dvb_ringbuffer_pkt_read(struct dvb_ringbuffer *rbuf, size_t idx,
  230. int offset, u8* buf, size_t len)
  231. {
  232. size_t todo;
  233. size_t split;
  234. size_t pktlen;
  235. pktlen = rbuf->data[idx] << 8;
  236. pktlen |= rbuf->data[(idx + 1) % rbuf->size];
  237. if (offset > pktlen) return -EINVAL;
  238. if ((offset + len) > pktlen) len = pktlen - offset;
  239. idx = (idx + DVB_RINGBUFFER_PKTHDRSIZE + offset) % rbuf->size;
  240. todo = len;
  241. split = ((idx + len) > rbuf->size) ? rbuf->size - idx : 0;
  242. if (split > 0) {
  243. memcpy(buf, rbuf->data+idx, split);
  244. buf += split;
  245. todo -= split;
  246. idx = 0;
  247. }
  248. memcpy(buf, rbuf->data+idx, todo);
  249. return len;
  250. }
  251. void dvb_ringbuffer_pkt_dispose(struct dvb_ringbuffer *rbuf, size_t idx)
  252. {
  253. size_t pktlen;
  254. rbuf->data[(idx + 2) % rbuf->size] = PKT_DISPOSED;
  255. // clean up disposed packets
  256. while(dvb_ringbuffer_avail(rbuf) > DVB_RINGBUFFER_PKTHDRSIZE) {
  257. if (DVB_RINGBUFFER_PEEK(rbuf, 2) == PKT_DISPOSED) {
  258. pktlen = DVB_RINGBUFFER_PEEK(rbuf, 0) << 8;
  259. pktlen |= DVB_RINGBUFFER_PEEK(rbuf, 1);
  260. DVB_RINGBUFFER_SKIP(rbuf, pktlen + DVB_RINGBUFFER_PKTHDRSIZE);
  261. } else {
  262. // first packet is not disposed, so we stop cleaning now
  263. break;
  264. }
  265. }
  266. }
  267. ssize_t dvb_ringbuffer_pkt_next(struct dvb_ringbuffer *rbuf, size_t idx, size_t* pktlen)
  268. {
  269. int consumed;
  270. int curpktlen;
  271. int curpktstatus;
  272. if (idx == -1) {
  273. idx = rbuf->pread;
  274. } else {
  275. curpktlen = rbuf->data[idx] << 8;
  276. curpktlen |= rbuf->data[(idx + 1) % rbuf->size];
  277. idx = (idx + curpktlen + DVB_RINGBUFFER_PKTHDRSIZE) % rbuf->size;
  278. }
  279. consumed = (idx - rbuf->pread) % rbuf->size;
  280. while((dvb_ringbuffer_avail(rbuf) - consumed) > DVB_RINGBUFFER_PKTHDRSIZE) {
  281. curpktlen = rbuf->data[idx] << 8;
  282. curpktlen |= rbuf->data[(idx + 1) % rbuf->size];
  283. curpktstatus = rbuf->data[(idx + 2) % rbuf->size];
  284. if (curpktstatus == PKT_READY) {
  285. *pktlen = curpktlen;
  286. return idx;
  287. }
  288. consumed += curpktlen + DVB_RINGBUFFER_PKTHDRSIZE;
  289. idx = (idx + curpktlen + DVB_RINGBUFFER_PKTHDRSIZE) % rbuf->size;
  290. }
  291. // no packets available
  292. return -1;
  293. }
  294. EXPORT_SYMBOL(dvb_ringbuffer_init);
  295. EXPORT_SYMBOL(dvb_ringbuffer_empty);
  296. EXPORT_SYMBOL(dvb_ringbuffer_free);
  297. EXPORT_SYMBOL(dvb_ringbuffer_avail);
  298. EXPORT_SYMBOL(dvb_ringbuffer_flush_spinlock_wakeup);
  299. EXPORT_SYMBOL(dvb_ringbuffer_read_user);
  300. EXPORT_SYMBOL(dvb_ringbuffer_read);
  301. EXPORT_SYMBOL(dvb_ringbuffer_write);
  302. EXPORT_SYMBOL(dvb_ringbuffer_write_user);