Fsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget5/translations/zh_CN/userspace-api/media/dvb/dmx-freadmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/zh_TW/userspace-api/media/dvb/dmx-freadmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/it_IT/userspace-api/media/dvb/dmx-freadmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/ja_JP/userspace-api/media/dvb/dmx-freadmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/ko_KR/userspace-api/media/dvb/dmx-freadmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/sp_SP/userspace-api/media/dvb/dmx-freadmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhO/var/lib/git/docbuild/linux/Documentation/userspace-api/media/dvb/dmx-fread.rsthKubhtarget)}(h.. _dmx_fread:h]h}(h]h ]h"]h$]h&]refid dmx-freaduh1hhKhhhhhhubhsection)}(hhh](htitle)}(hDigital TV demux read()h]hDigital TV demux read()}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hNameh]hName}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh paragraph)}(hDigital TV demux read()h]hDigital TV demux read()}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubeh}(h]nameah ]h"]nameah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hSynopsish]hSynopsis}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singleDTV.dmx.read (C function)c.DTV.dmx.readhNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h,size_t read(int fd, void *buf, size_t count)h]hdesc_signature_line)}(h,size_t read(int fd, void *buf, size_t count)h](h)}(hhh]h desc_sig_name)}(hsize_th]hsize_t}(hj8hhhNhNubah}(h]h ]nah"]h$]h&]uh1j6hj3ubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetj:modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data](jU ASTIdentifier)}jPDTVsbNj])}jPdmxsbNj])}jPreadsbc.DTV.dmx.readesbuh1hhj/hhhhhKubhdesc_sig_space)}(h h]h }(hjmhhhNhNubah}(h]h ]wah"]h$]h&]uh1jkhj/hhhhhKubh desc_name)}(hreadh]j7)}(hjhh]hread}(hjhhhNhNubah}(h]h ]jCah"]h$]h&]uh1j6hj~ubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1j|hj/hhhhhKubhdesc_parameterlist)}(h!(int fd, void *buf, size_t count)h](hdesc_parameter)}(hint fdh](hdesc_sig_keyword_type)}(hinth]hint}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjubjl)}(h h]h }(hjhhhNhNubah}(h]h ]jxah"]h$]h&]uh1jkhjubj7)}(hfdh]hfd}(hjhhhNhNubah}(h]h ]jCah"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *bufh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjl)}(h h]h }(hjhhhNhNubah}(h]h ]jxah"]h$]h&]uh1jkhjubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjubj7)}(hbufh]hbuf}(hjhhhNhNubah}(h]h ]jCah"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h size_t counth](h)}(hhh]j7)}(hsize_th]hsize_t}(hj$hhhNhNubah}(h]h ]jCah"]h$]h&]uh1j6hj!ubah}(h]h ]h"]h$]h&] refdomainjNreftypejP reftargetj&modnameN classnameNjTjW)}jZ](j^NjbNjfc.DTV.dmx.readesbuh1hhjubjl)}(h h]h }(hjDhhhNhNubah}(h]h ]jxah"]h$]h&]uh1jkhjubj7)}(hcounth]hcount}(hjRhhhNhNubah}(h]h ]jCah"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhj/hhhhhKubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1j-sphinx_line_type declaratorhj)hhhhhKubah}(h]j ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1j'hhhKhj$hhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj$hhhhhKubeh}(h]h ](jNfunctioneh"]h$]h&]domainjNobjtypejdesctypejnoindex noindexentrynocontentsentryuh1j"hhhjhNhNubeh}(h]synopsisah ]h"]synopsisah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Argumentsh]h Arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(hh``fd`` File descriptor returned by a previous call to :c:func:`open()`. ``buf`` Buffer to be filled h](hterm)}(h``fd``h]hliteral)}(hjh]hfd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubh definition)}(hhh](h block_quote)}(hAFile descriptor returned by a previous call to :c:func:`open()`. h]h)}(h@File descriptor returned by a previous call to :c:func:`open()`.h](h/File descriptor returned by a previous call to }(hjhhhNhNubh)}(h:c:func:`open()`h]j)}(hjh]hopen()}(hjhhhNhNubah}(h]h ](xrefjNc-funceh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdoc!userspace-api/media/dvb/dmx-fread refdomainjNreftypefunc refexplicitrefwarnjTjW)}jZ](j^NjbNesb reftargetopenuh1hhhhKhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]j)}(h``buf`` Buffer to be filled h](j)}(h``buf``h]j)}(hj+h]hbuf}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jhhhKhj%ubj)}(hhh]h)}(hBuffer to be filledh]hBuffer to be filled}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj@ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(h&``count`` Max number of bytes to read h](j)}(h ``count``h]j)}(hjuh]hcount}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhhhKhjoubj)}(hhh]h)}(hMax number of bytes to readh]hMax number of bytes to read}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhNhNubeh}(h] argumentsah ]h"] argumentsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Descriptionh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK!ubh)}(hXThis system call returns filtered data, which might be section or Packetized Elementary Stream (PES) data. The filtered data is transferred from the driver's internal circular buffer to ``buf``. The maximum amount of data to be transferred is implied by count.h](hThis system call returns filtered data, which might be section or Packetized Elementary Stream (PES) data. The filtered data is transferred from the driver’s internal circular buffer to }(hjhhhNhNubj)}(h``buf``h]hbuf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhC. The maximum amount of data to be transferred is implied by count.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK#hjhhubhnote)}(hif a section filter created with :c:type:`DMX_CHECK_CRC ` flag set, data that fails on CRC check will be silently ignored.h]h)}(hif a section filter created with :c:type:`DMX_CHECK_CRC ` flag set, data that fails on CRC check will be silently ignored.h](h!if a section filter created with }(hjhhhNhNubh)}(h/:c:type:`DMX_CHECK_CRC `h]j)}(hjh]h DMX_CHECK_CRC}(hjhhhNhNubah}(h]h ](jjNc-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjNreftypetype refexplicitrefwarnjTj jdmx_sct_filter_paramsuh1hhhhK*hjubhA flag set, data that fails on CRC check will be silently ignored.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK*hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h] descriptionah ]h"] descriptionah$]h&]uh1hhhhhhhhK!ubh)}(hhh](h)}(h Return Valueh]h Return Value}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hhhhhK/ubh)}(hOn success 0 is returned.h]hOn success 0 is returned.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hj+hhubh)}(hIOn error -1 is returned, and the ``errno`` variable is set appropriately.h](h!On error -1 is returned, and the }(hjJhhhNhNubj)}(h ``errno``h]herrno}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubh variable is set appropriately.}(hjJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK3hj+hhubhtabular_col_spec)}(hhh]h}(h]h ]h"]h$]h&]spec|p{2.5cm}|p{15.0cm}|uh1jjhhhK6hj+hhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj~ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj~ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h``EWOULDBLOCK``h]j)}(hjh]h EWOULDBLOCK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK=hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h3No data to return and ``O_NONBLOCK`` was specified.h](hNo data to return and }(hjhhhNhNubj)}(h``O_NONBLOCK``h]h O_NONBLOCK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was specified.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK>hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h ``EOVERFLOW``h]j)}(hjh]h EOVERFLOW}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK@hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hyThe filtered data was not read from the buffer in due time, resulting in non-read data being lost. The buffer is flushed.h]hyThe filtered data was not read from the buffer in due time, resulting in non-read data being lost. The buffer is flushed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h ``ETIMEDOUT``h]j)}(hj:h]h ETIMEDOUT}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hhhhKDhj5ubah}(h]h ]h"]h$]h&]uh1jhj2ubj)}(hhh]h)}(hvThe section was not loaded within the stated timeout period. See ioctl :ref:`DMX_SET_FILTER` for how to set a timeout.h](hGThe section was not loaded within the stated timeout period. See ioctl }(hjXhhhNhNubh)}(h:ref:`DMX_SET_FILTER`h]hinline)}(hjbh]hDMX_SET_FILTER}(hjfhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jdhj`ubah}(h]h ]h"]h$]h&]refdocj refdomainjpreftyperef refexplicitrefwarnjdmx_set_filteruh1hhhhKEhjXubh for how to set a timeout.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKEhjUubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h ``EFAULT``h]j)}(hjh]hEFAULT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hQThe driver failed to write to the callers buffer due to an invalid \*buf pointer.h]hQThe driver failed to write to the callers buffer due to an invalid *buf pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]colsKuh1j|hjyubah}(h]h ]h"]h$]h&]uh1jwhj+hhhNhNubh)}(h]The generic error codes are described at the :ref:`Generic Error Codes ` chapter.h](h-The generic error codes are described at the }(hjhhhNhNubh)}(h':ref:`Generic Error Codes `h]je)}(hjh]hGeneric Error Codes}(hjhhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jdhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarnj gen-errorsuh1hhhhKLhjubh chapter.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKLhj+hhubeh}(h] return-valueah ]h"] return valueah$]h&]uh1hhhhhhhhK/ubeh}(h](digital-tv-demux-readheh ]h"](digital tv demux read() dmx_freadeh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}j+hsexpect_referenced_by_id}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjTerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}h]hasnameids}(j+hj*j'hhjjjjj(j%j"ju nametypes}(j+j*hjjj(j"uh}(hhj'hhhjjj j)jjj%jjj+u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h/Hyperlink target "dmx-fread" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1juba transformerN include_log] decorationNhhub.