.. -*- coding: utf-8; mode: rst -*-
|
|
.. _media-func-close:
|
|
*************
|
media close()
|
*************
|
|
Name
|
====
|
|
media-close - Close a media device
|
|
|
Synopsis
|
========
|
|
.. code-block:: c
|
|
#include <unistd.h>
|
|
|
.. c:function:: int close( int fd )
|
:name: mc-close
|
|
Arguments
|
=========
|
|
``fd``
|
File descriptor returned by :c:func:`open() <mc-open>`.
|
|
|
Description
|
===========
|
|
Closes the media device. Resources associated with the file descriptor
|
are freed. The device configuration remain unchanged.
|
|
|
Return Value
|
============
|
|
:ref:`close() <media-func-close>` returns 0 on success. On error, -1 is returned, and
|
``errno`` is set appropriately. Possible error codes are:
|
|
EBADF
|
``fd`` is not a valid open file descriptor.
|
