xref: /linux/Documentation/userspace-api/media/v4l/func-close.rst (revision 8fe62e0c0e2efa5437f3ee81b65d69e70a45ecd2)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: V4L
3
4.. _func-close:
5
6************
7V4L2 close()
8************
9
10Name
11====
12
13v4l2-close - Close a V4L2 device
14
15Synopsis
16========
17
18.. code-block:: c
19
20    #include <unistd.h>
21
22.. c:function:: int close( int fd )
23
24Arguments
25=========
26
27``fd``
28    File descriptor returned by :c:func:`open()`.
29
30Description
31===========
32
33Closes the device. Any I/O in progress is terminated and resources
34associated with the file descriptor are freed. However data format
35parameters, current input or output, control values or other properties
36remain unchanged.
37
38Return Value
39============
40
41The function returns 0 on success, -1 on failure and the ``errno`` is
42set appropriately. Possible error codes:
43
44EBADF
45    ``fd`` is not a valid open file descriptor.
46