1 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1. !! 1 .. This file is dual-licensed: you can use it either under the terms
2 .. c:namespace:: MC.request !! 2 .. of the GPL 2.0 or the GFDL 1.1+ license, at your option. Note that this
>> 3 .. dual licensing only applies to this file, and not this project as a
>> 4 .. whole.
>> 5 ..
>> 6 .. a) This file is free software; you can redistribute it and/or
>> 7 .. modify it under the terms of the GNU General Public License as
>> 8 .. published by the Free Software Foundation version 2 of
>> 9 .. the License.
>> 10 ..
>> 11 .. This file is distributed in the hope that it will be useful,
>> 12 .. but WITHOUT ANY WARRANTY; without even the implied warranty of
>> 13 .. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
>> 14 .. GNU General Public License for more details.
>> 15 ..
>> 16 .. Or, alternatively,
>> 17 ..
>> 18 .. b) Permission is granted to copy, distribute and/or modify this
>> 19 .. document under the terms of the GNU Free Documentation License,
>> 20 .. Version 1.1 or any later version published by the Free Software
>> 21 .. Foundation, with no Invariant Sections, no Front-Cover Texts
>> 22 .. and no Back-Cover Texts. A copy of the license is included at
>> 23 .. Documentation/userspace-api/media/fdl-appendix.rst.
>> 24 ..
>> 25 .. TODO: replace it to GPL-2.0 OR GFDL-1.1-or-later WITH no-invariant-sections
3 26
4 .. _request-func-close: 27 .. _request-func-close:
5 28
6 *************** 29 ***************
7 request close() 30 request close()
8 *************** 31 ***************
9 32
10 Name 33 Name
11 ==== 34 ====
12 35
13 request-close - Close a request file descripto 36 request-close - Close a request file descriptor
14 37
>> 38
15 Synopsis 39 Synopsis
16 ======== 40 ========
17 41
18 .. code-block:: c 42 .. code-block:: c
19 43
20 #include <unistd.h> 44 #include <unistd.h>
21 45
>> 46
22 .. c:function:: int close( int fd ) 47 .. c:function:: int close( int fd )
>> 48 :name: req-close
23 49
24 Arguments 50 Arguments
25 ========= 51 =========
26 52
27 ``fd`` 53 ``fd``
28 File descriptor returned by :ref:`MEDIA_IO 54 File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
29 55
>> 56
30 Description 57 Description
31 =========== 58 ===========
32 59
33 Closes the request file descriptor. Resources 60 Closes the request file descriptor. Resources associated with the request
34 are freed once all file descriptors associated 61 are freed once all file descriptors associated with the request are closed
35 and the driver has completed the request. 62 and the driver has completed the request.
36 See :ref:`here <media-request-life-time>` for 63 See :ref:`here <media-request-life-time>` for more information.
37 64
>> 65
38 Return Value 66 Return Value
39 ============ 67 ============
40 68
41 :c:func:`close()` returns 0 on success. On err !! 69 :ref:`close() <request-func-close>` returns 0 on success. On error, -1 is
42 returned, and ``errno`` is set appropriately. 70 returned, and ``errno`` is set appropriately. Possible error codes are:
43 71
44 EBADF 72 EBADF
45 ``fd`` is not a valid open file descriptor 73 ``fd`` is not a valid open file descriptor.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.