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