| .. -*- coding: utf-8; mode: rst -*- |
| .. c:function:: size_t read(int fd, void *buf, size_t count) |
| - File descriptor returned by a previous call to open(). |
| - Pointer to the buffer to be used for returned filtered data. |
| This system call returns filtered data, which might be section or PES |
| data. The filtered data is transferred from the driver’s internal |
| circular buffer to buf. The maximum amount of data to be transferred is |
| - No data to return and O_NONBLOCK was specified. |
| - fd is not a valid open file descriptor. |
| - Last section had a CRC error - no data returned. The buffer is |
| - The filtered data was not read from the buffer in due time, |
| resulting in non-read data being lost. The buffer is flushed. |
| - The section was not loaded within the stated timeout period. See |
| ioctl DMX_SET_FILTER for how to set a timeout. |
| - The driver failed to write to the callers buffer due to an invalid |