18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci.. c:namespace:: MC.request
38c2ecf20Sopenharmony_ci
48c2ecf20Sopenharmony_ci.. _request-func-close:
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ci***************
78c2ecf20Sopenharmony_cirequest close()
88c2ecf20Sopenharmony_ci***************
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciName
118c2ecf20Sopenharmony_ci====
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_cirequest-close - Close a request file descriptor
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ciSynopsis
168c2ecf20Sopenharmony_ci========
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci.. code-block:: c
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci    #include <unistd.h>
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ci.. c:function:: int close( int fd )
238c2ecf20Sopenharmony_ci
248c2ecf20Sopenharmony_ciArguments
258c2ecf20Sopenharmony_ci=========
268c2ecf20Sopenharmony_ci
278c2ecf20Sopenharmony_ci``fd``
288c2ecf20Sopenharmony_ci    File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
298c2ecf20Sopenharmony_ci
308c2ecf20Sopenharmony_ciDescription
318c2ecf20Sopenharmony_ci===========
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ciCloses the request file descriptor. Resources associated with the request
348c2ecf20Sopenharmony_ciare freed once all file descriptors associated with the request are closed
358c2ecf20Sopenharmony_ciand the driver has completed the request.
368c2ecf20Sopenharmony_ciSee :ref:`here <media-request-life-time>` for more information.
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ciReturn Value
398c2ecf20Sopenharmony_ci============
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ci:c:func:`close()` returns 0 on success. On error, -1 is
428c2ecf20Sopenharmony_cireturned, and ``errno`` is set appropriately. Possible error codes are:
438c2ecf20Sopenharmony_ci
448c2ecf20Sopenharmony_ciEBADF
458c2ecf20Sopenharmony_ci    ``fd`` is not a valid open file descriptor.
46