xref: /linux/Documentation/userspace-api/media/v4l/func-close.rst (revision 3f276cece4dd9e8bf199d9bf3901eef8ca904c2d)
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