request-func-close.rst 918 B

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
  2. .. c:namespace:: MC.request
  3. .. _request-func-close:
  4. ***************
  5. request close()
  6. ***************
  7. Name
  8. ====
  9. request-close - Close a request file descriptor
  10. Synopsis
  11. ========
  12. .. code-block:: c
  13. #include <unistd.h>
  14. .. c:function:: int close( int fd )
  15. Arguments
  16. =========
  17. ``fd``
  18. File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
  19. Description
  20. ===========
  21. Closes the request file descriptor. Resources associated with the request
  22. are freed once all file descriptors associated with the request are closed
  23. and the driver has completed the request.
  24. See :ref:`here <media-request-life-time>` for more information.
  25. Return Value
  26. ============
  27. :c:func:`close()` returns 0 on success. On error, -1 is
  28. returned, and ``errno`` is set appropriately. Possible error codes are:
  29. EBADF
  30. ``fd`` is not a valid open file descriptor.