[deliverable/linux.git] / Documentation / media / uapi / dvb / frontend_f_close.rst

.. -*- coding: utf-8; mode: rst -*-

.. _frontend_f_close:

********************
DVB frontend close()
********************

Name
====

fe-close - Close a frontend device


Synopsis
========

.. code-block:: c

    #include <unistd.h>


.. cpp:function:: int close( int fd )


Arguments
=========

``fd``
    File descriptor returned by :ref:`open() <func-open>`.


Description
===========

This system call closes a previously opened front-end device. After
closing a front-end device, its corresponding hardware might be powered
down automatically.


Return Value
============

The function returns 0 on success, -1 on failure and the ``errno`` is
set appropriately. Possible error codes:

EBADF
    ``fd`` is not a valid open file descriptor.
Commit	Line	Data
5377d91f MH	1	.. -- coding: utf-8; mode: rst --
	2
	3	.. _frontend_f_close:
	4
	5	********************
	6	DVB frontend close()
	7	********************
	8
15e7d615	9	Name
586027ce	10	====
5377d91f	11
586027ce	12	fe-close - Close a frontend device
5377d91f	13
15e7d615 MCC	14
15e7d615 MCC	15	Synopsis
5377d91f MH	16	========
	17
	18	.. code-block:: c
	19
	20	#include <unistd.h>
	21
	22
b7e67f6c	23	.. cpp:function:: int close( int fd )
5377d91f	24
586027ce	25
15e7d615	26	Arguments
5377d91f MH	27	=========
	28
	29	``fd``
	30	File descriptor returned by :ref:`open() <func-open>`.
	31
	32
15e7d615	33	Description
5377d91f MH	34	===========
	35
	36	This system call closes a previously opened front-end device. After
	37	closing a front-end device, its corresponding hardware might be powered
	38	down automatically.
	39
	40
15e7d615	41	Return Value
5377d91f MH	42	============
	43
	44	The function returns 0 on success, -1 on failure and the ``errno`` is
	45	set appropriately. Possible error codes:
	46
	47	EBADF
	48	``fd`` is not a valid open file descriptor.