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