Merge tag 'metag-for-v4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/jhogan...
[sfrench/cifs-2.6.git] / Documentation / media / uapi / mediactl / media-func-close.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _media-func-close:
4
5 *************
6 media close()
7 *************
8
9 Name
10 ====
11
12 media-close - Close a media device
13
14
15 Synopsis
16 ========
17
18 .. code-block:: c
19
20     #include <unistd.h>
21
22
23 .. cpp:function:: int close( int fd )
24
25
26 Arguments
27 =========
28
29 ``fd``
30     File descriptor returned by :ref:`open() <func-open>`.
31
32
33 Description
34 ===========
35
36 Closes the media device. Resources associated with the file descriptor
37 are freed. The device configuration remain unchanged.
38
39
40 Return Value
41 ============
42
43 :ref:`close() <media-func-close>` returns 0 on success. On error, -1 is returned, and
44 ``errno`` is set appropriately. Possible error codes are:
45
46 EBADF
47     ``fd`` is not a valid open file descriptor.