Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/dtor/input
[cascardo/linux.git] / Documentation / media / uapi / dvb / fe-diseqc-recv-slave-reply.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _FE_DISEQC_RECV_SLAVE_REPLY:
4
5 ********************************
6 ioctl FE_DISEQC_RECV_SLAVE_REPLY
7 ********************************
8
9 Name
10 ====
11
12 FE_DISEQC_RECV_SLAVE_REPLY - Receives reply from a DiSEqC 2.0 command
13
14
15 Synopsis
16 ========
17
18 .. cpp:function:: int ioctl( int fd, int request, struct dvb_diseqc_slave_reply *argp )
19
20
21 Arguments
22 =========
23
24 ``fd``
25     File descriptor returned by :ref:`open() <frontend_f_open>`.
26
27 ``request``
28     FE_DISEQC_RECV_SLAVE_REPLY
29
30 ``argp``
31     pointer to struct
32     :ref:`dvb_diseqc_slave_reply <dvb-diseqc-slave-reply>`
33
34
35 Description
36 ===========
37
38 Receives reply from a DiSEqC 2.0 command.
39
40 .. _dvb-diseqc-slave-reply:
41
42 struct dvb_diseqc_slave_reply
43 -----------------------------
44
45 .. flat-table:: struct dvb_diseqc_slave_reply
46     :header-rows:  0
47     :stub-columns: 0
48     :widths:       1 1 2
49
50
51     -  .. row 1
52
53        -  uint8_t
54
55        -  msg[4]
56
57        -  DiSEqC message (framing, data[3])
58
59     -  .. row 2
60
61        -  uint8_t
62
63        -  msg_len
64
65        -  Length of the DiSEqC message. Valid values are 0 to 4, where 0
66           means no msg
67
68     -  .. row 3
69
70        -  int
71
72        -  timeout
73
74        -  Return from ioctl after timeout ms with errorcode when no message
75           was received
76
77
78 Return Value
79 ============
80
81 On success 0 is returned, on error -1 and the ``errno`` variable is set
82 appropriately. The generic error codes are described at the
83 :ref:`Generic Error Codes <gen-errors>` chapter.