Documentation/userspace-api/media/v4l/func-close.rst

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