1 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1. 1 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: MC 2 .. c:namespace:: MC
3 3
4 .. _media_request_ioc_reinit: 4 .. _media_request_ioc_reinit:
5 5
6 ****************************** 6 ******************************
7 ioctl MEDIA_REQUEST_IOC_REINIT 7 ioctl MEDIA_REQUEST_IOC_REINIT
8 ****************************** 8 ******************************
9 9
10 Name 10 Name
11 ==== 11 ====
12 12
13 MEDIA_REQUEST_IOC_REINIT - Re-initialize a req 13 MEDIA_REQUEST_IOC_REINIT - Re-initialize a request
14 14
15 Synopsis 15 Synopsis
16 ======== 16 ========
17 17
18 .. c:macro:: MEDIA_REQUEST_IOC_REINIT 18 .. c:macro:: MEDIA_REQUEST_IOC_REINIT
19 19
20 ``int ioctl(int request_fd, MEDIA_REQUEST_IOC_ 20 ``int ioctl(int request_fd, MEDIA_REQUEST_IOC_REINIT)``
21 21
22 Arguments 22 Arguments
23 ========= 23 =========
24 24
25 ``request_fd`` 25 ``request_fd``
26 File descriptor returned by :ref:`MEDIA_IO 26 File descriptor returned by :ref:`MEDIA_IOC_REQUEST_ALLOC`.
27 27
28 Description 28 Description
29 =========== 29 ===========
30 30
31 If the media device supports :ref:`requests <m 31 If the media device supports :ref:`requests <media-request-api>`, then
32 this request ioctl can be used to re-initializ 32 this request ioctl can be used to re-initialize a previously allocated
33 request. 33 request.
34 34
35 Re-initializing a request will clear any exist 35 Re-initializing a request will clear any existing data from the request.
36 This avoids having to :c:func:`close()` a comp 36 This avoids having to :c:func:`close()` a completed
37 request and allocate a new request. Instead th 37 request and allocate a new request. Instead the completed request can just
38 be re-initialized and it is ready to be used a 38 be re-initialized and it is ready to be used again.
39 39
40 A request can only be re-initialized if it eit 40 A request can only be re-initialized if it either has not been queued
41 yet, or if it was queued and completed. Otherw 41 yet, or if it was queued and completed. Otherwise it will set ``errno``
42 to ``EBUSY``. No other error codes can be retu 42 to ``EBUSY``. No other error codes can be returned.
43 43
44 Return Value 44 Return Value
45 ============ 45 ============
46 46
47 On success 0 is returned, on error -1 and the 47 On success 0 is returned, on error -1 and the ``errno`` variable is set
48 appropriately. 48 appropriately.
49 49
50 EBUSY 50 EBUSY
51 The request is queued but not yet complete 51 The request is queued but not yet completed.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.