Documentation/media/uapi/mediactl/media-func-close.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _media-func-close:
   4
   5 *************
   6 media close()
   7 *************
   8
   9 Name
  10 ====
  11
  12 media-close - Close a media device
  13
  14
  15 Synopsis
  16 ========
  17
  18 .. code-block:: c
  19
  20     #include <unistd.h>
  21
  22
  23 .. c:function:: int close( int fd )
  24     :name: mc-close
  25
  26 Arguments
  27 =========
  28
  29 ``fd``
  30     File descriptor returned by :c:func:`open() <mc-open>`.
  31
  32
  33 Description
  34 ===========
  35
  36 Closes the media device. Resources associated with the file descriptor
  37 are freed. The device configuration remain unchanged.
  38
  39
  40 Return Value
  41 ============
  42
  43 :ref:`close() <media-func-close>` returns 0 on success. On error, -1 is returned, and
  44 ``errno`` is set appropriately. Possible error codes are:
  45
  46 EBADF
  47     ``fd`` is not a valid open file descriptor.