The syscall pages are written to be used also as man-pages. However, they don't match the format used by kernel-doc generated pages from DocBook. Rewrite them to match it. One side effect is that now all such pages at the book will have the same format, reducing the format differences between DVB and the other parts of the book. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
82 lines
1.2 KiB
ReStructuredText
82 lines
1.2 KiB
ReStructuredText
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
.. _audio_fwrite:
|
|
|
|
=================
|
|
DVB audio write()
|
|
=================
|
|
|
|
NAME
|
|
----
|
|
|
|
DVB audio write()
|
|
|
|
SYNOPSIS
|
|
--------
|
|
|
|
.. c:function:: size_t write(int fd, const void *buf, size_t count)
|
|
|
|
|
|
ARGUMENTS
|
|
---------
|
|
|
|
.. flat-table::
|
|
:header-rows: 0
|
|
:stub-columns: 0
|
|
|
|
|
|
- .. row 1
|
|
|
|
- int fd
|
|
|
|
- File descriptor returned by a previous call to open().
|
|
|
|
- .. row 2
|
|
|
|
- void \*buf
|
|
|
|
- Pointer to the buffer containing the PES data.
|
|
|
|
- .. row 3
|
|
|
|
- size_t count
|
|
|
|
- Size of buf.
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
This system call can only be used if AUDIO_SOURCE_MEMORY is selected
|
|
in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in
|
|
PES format. If O_NONBLOCK is not specified the function will block
|
|
until buffer space is available. The amount of data to be transferred is
|
|
implied by count.
|
|
|
|
|
|
RETURN VALUE
|
|
------------
|
|
|
|
.. flat-table::
|
|
:header-rows: 0
|
|
:stub-columns: 0
|
|
|
|
|
|
- .. row 1
|
|
|
|
- ``EPERM``
|
|
|
|
- Mode AUDIO_SOURCE_MEMORY not selected.
|
|
|
|
- .. row 2
|
|
|
|
- ``ENOMEM``
|
|
|
|
- Attempted to write more data than the internal buffer can hold.
|
|
|
|
- .. row 3
|
|
|
|
- ``EBADF``
|
|
|
|
- fd is not a valid open file descriptor.
|