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