0001 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: MC.request
0003
0004 .. _request-func-close:
0005
0006 ***************
0007 request close()
0008 ***************
0009
0010 Name
0011 ====
0012
0013 request-close - Close a request file descriptor
0014
0015 Synopsis
0016 ========
0017
0018 .. code-block:: c
0019
0020 #include <unistd.h>
0021
0022 .. c:function:: int close( int fd )
0023
0024 Arguments
0025 =========
0026
0027 ``fd``
0028 File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
0029
0030 Description
0031 ===========
0032
0033 Closes the request file descriptor. Resources associated with the request
0034 are freed once all file descriptors associated with the request are closed
0035 and the driver has completed the request.
0036 See :ref:`here <media-request-life-time>` for more information.
0037
0038 Return Value
0039 ============
0040
0041 :c:func:`close()` returns 0 on success. On error, -1 is
0042 returned, and ``errno`` is set appropriately. Possible error codes are:
0043
0044 EBADF
0045 ``fd`` is not a valid open file descriptor.
