| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 1 | .. -*- coding: utf-8; mode: rst -*- |
| 2 | |
| 3 | .. _FE_GET_FRONTEND: |
| 4 | |
| 5 | *************** |
| 6 | FE_GET_FRONTEND |
| 7 | *************** |
| 8 | |
| Mauro Carvalho Chehab | 15e7d61 | 2016-07-05 15:14:35 -0300 | [diff] [blame] | 9 | Name |
| Mauro Carvalho Chehab | 586027c | 2016-07-05 07:58:48 -0300 | [diff] [blame] | 10 | ==== |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 11 | |
| Mauro Carvalho Chehab | 586027c | 2016-07-05 07:58:48 -0300 | [diff] [blame] | 12 | FE_GET_FRONTEND |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 13 | |
| Mauro Carvalho Chehab | 15e7d61 | 2016-07-05 15:14:35 -0300 | [diff] [blame] | 14 | |
| 15 | Synopsis |
| Mauro Carvalho Chehab | 586027c | 2016-07-05 07:58:48 -0300 | [diff] [blame] | 16 | ======== |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 17 | |
| Mauro Carvalho Chehab | 5929cb1 | 2016-07-05 15:22:59 -0300 | [diff] [blame] | 18 | .. cpp:function:: int ioctl(int fd, int request = FE_GET_FRONTEND, struct dvb_frontend_parameters *p) |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 19 | |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 20 | |
| Mauro Carvalho Chehab | 15e7d61 | 2016-07-05 15:14:35 -0300 | [diff] [blame] | 21 | Arguments |
| Mauro Carvalho Chehab | 586027c | 2016-07-05 07:58:48 -0300 | [diff] [blame] | 22 | ========= |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 23 | |
| 24 | .. flat-table:: |
| 25 | :header-rows: 0 |
| 26 | :stub-columns: 0 |
| 27 | |
| 28 | |
| 29 | - .. row 1 |
| 30 | |
| 31 | - int fd |
| 32 | |
| 33 | - File descriptor returned by a previous call to open(). |
| 34 | |
| 35 | - .. row 2 |
| 36 | |
| 37 | - int request |
| 38 | |
| Mauro Carvalho Chehab | 7347081 | 2016-07-01 13:58:44 -0300 | [diff] [blame] | 39 | - Equals :ref:`FE_SET_FRONTEND` for this |
| Mauro Carvalho Chehab | 0579e6e | 2016-07-04 16:25:48 -0300 | [diff] [blame] | 40 | command. |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 41 | |
| 42 | - .. row 3 |
| 43 | |
| Mauro Carvalho Chehab | d090484 | 2016-07-04 12:37:18 -0300 | [diff] [blame] | 44 | - struct dvb_frontend_parameters \*p |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 45 | |
| 46 | - Points to parameters for tuning operation. |
| 47 | |
| 48 | |
| Mauro Carvalho Chehab | 15e7d61 | 2016-07-05 15:14:35 -0300 | [diff] [blame] | 49 | Description |
| Mauro Carvalho Chehab | 586027c | 2016-07-05 07:58:48 -0300 | [diff] [blame] | 50 | =========== |
| 51 | |
| 52 | This ioctl call queries the currently effective frontend parameters. For |
| 53 | this command, read-only access to the device is sufficient. |
| 54 | |
| 55 | |
| Mauro Carvalho Chehab | 15e7d61 | 2016-07-05 15:14:35 -0300 | [diff] [blame] | 56 | Return Value |
| Mauro Carvalho Chehab | 586027c | 2016-07-05 07:58:48 -0300 | [diff] [blame] | 57 | ============ |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 58 | |
| 59 | On success 0 is returned, on error -1 and the ``errno`` variable is set |
| 60 | appropriately. The generic error codes are described at the |
| 61 | :ref:`Generic Error Codes <gen-errors>` chapter. |
| 62 | |
| 63 | |
| 64 | |
| 65 | .. flat-table:: |
| 66 | :header-rows: 0 |
| 67 | :stub-columns: 0 |
| 68 | |
| 69 | |
| 70 | - .. row 1 |
| 71 | |
| Mauro Carvalho Chehab | cdb4af0 | 2016-07-03 11:53:09 -0300 | [diff] [blame] | 72 | - ``EINVAL`` |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 73 | |
| 74 | - Maximum supported symbol rate reached. |