18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci.. c:namespace:: MC
38c2ecf20Sopenharmony_ci
48c2ecf20Sopenharmony_ci.. _media-func-close:
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ci*************
78c2ecf20Sopenharmony_cimedia close()
88c2ecf20Sopenharmony_ci*************
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciName
118c2ecf20Sopenharmony_ci====
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_cimedia-close - Close a media device
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 :c:func:`open()`.
298c2ecf20Sopenharmony_ci
308c2ecf20Sopenharmony_ciDescription
318c2ecf20Sopenharmony_ci===========
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ciCloses the media device. Resources associated with the file descriptor
348c2ecf20Sopenharmony_ciare freed. The device configuration remain unchanged.
358c2ecf20Sopenharmony_ci
368c2ecf20Sopenharmony_ciReturn Value
378c2ecf20Sopenharmony_ci============
388c2ecf20Sopenharmony_ci
398c2ecf20Sopenharmony_ci:c:func:`close()` returns 0 on success. On error, -1 is returned, and
408c2ecf20Sopenharmony_ci``errno`` is set appropriately. Possible error codes are:
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ciEBADF
438c2ecf20Sopenharmony_ci    ``fd`` is not a valid open file descriptor.
44