Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/hid
[cascardo/linux.git] / Documentation / media / uapi / dvb / audio-set-ext-id.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _AUDIO_SET_EXT_ID:
4
5 ================
6 AUDIO_SET_EXT_ID
7 ================
8
9 Name
10 ----
11
12 AUDIO_SET_EXT_ID
13
14 .. attention:: This ioctl is deprecated
15
16 Synopsis
17 --------
18
19 .. c:function:: int  ioctl(fd, AUDIO_SET_EXT_ID, int id)
20     :name: AUDIO_SET_EXT_ID
21
22 Arguments
23 ---------
24
25 .. flat-table::
26     :header-rows:  0
27     :stub-columns: 0
28
29
30     -
31
32        -  int fd
33
34        -  File descriptor returned by a previous call to open().
35
36     -
37
38        -  int id
39
40        -  audio sub_stream_id
41
42
43 Description
44 -----------
45
46 This ioctl can be used to set the extension id for MPEG streams in DVD
47 playback. Only the first 3 bits are recognized.
48
49
50 Return Value
51 ------------
52
53 On success 0 is returned, on error -1 and the ``errno`` variable is set
54 appropriately. The generic error codes are described at the
55 :ref:`Generic Error Codes <gen-errors>` chapter.
56
57 .. flat-table::
58     :header-rows:  0
59     :stub-columns: 0
60
61
62     -  .. row 1
63
64        -  ``EINVAL``
65
66        -  id is not a valid id.