\Rsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget;/translations/zh_CN/userspace-api/media/dvb/frontend_f_openmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/zh_TW/userspace-api/media/dvb/frontend_f_openmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/it_IT/userspace-api/media/dvb/frontend_f_openmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/ja_JP/userspace-api/media/dvb/frontend_f_openmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/ko_KR/userspace-api/media/dvb/frontend_f_openmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/sp_SP/userspace-api/media/dvb/frontend_f_openmodnameN 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:spacepreserveuh1hhhhhhU/var/lib/git/docbuild/linux/Documentation/userspace-api/media/dvb/frontend_f_open.rsthKubhtarget)}(h.. _frontend_f_open:h]h}(h]h ]h"]h$]h&]refidfrontend-f-openuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hDigital TV frontend open()h]hDigital TV frontend open()}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hNameh]hName}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh paragraph)}(h fe-open - Open a frontend deviceh]h fe-open - Open a frontend device}(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&]uh1hhjhhhhhKubh literal_block)}(h#include h]h#include }hjsbah}(h]h ]h"]h$]h&]hhforcelanguagechighlight_args}uh1jhhhKhjhhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singleDTV.fe.open (C function) c.DTV.fe.openhNtauh1j&hjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h.int open( const char *device_name, int flags )h]hdesc_signature_line)}(h,int open(const char *device_name, int flags)h](hdesc_sig_keyword_type)}(hinth]hint}(hjJhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jHhjDhhhhhKubhdesc_sig_space)}(h h]h }(hj[hhhNhNubah}(h]h ]wah"]h$]h&]uh1jYhjDhhhhhKubh desc_name)}(hopenh]h desc_sig_name)}(hopenh]hopen}(hjrhhhNhNubah}(h]h ]nah"]h$]h&]uh1jphjlubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jjhjDhhhhhKubhdesc_parameterlist)}(h$(const char *device_name, int flags)h](hdesc_parameter)}(hconst char *device_nameh](hdesc_sig_keyword)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubjZ)}(h h]h }(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubjI)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubjZ)}(h h]h }(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjubjq)}(h device_nameh]h device_name}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jphjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h int flagsh](jI)}(hinth]hint}(hjhhhNhNubah}(h]h ]jUah"]h$]h&]uh1jHhjubjZ)}(h h]h }(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubjq)}(hflagsh]hflags}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jphjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjDhhhhhKubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1jBsphinx_line_type declaratorhj>hhhhhKubah}(h]j5ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1j<hhhKhj9hhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1jEhj9hhhhhKubeh}(h]h ](j#functioneh"]h$]h&]domainj#objtypejSdesctypejSnoindex noindexentrynocontentsentryuh1j7hhhjhNhNubeh}(h]synopsisah ]h"]synopsisah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Argumentsh]h Arguments}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(h%``device_name`` Device to be opened. h](hterm)}(h``device_name``h]hliteral)}(hjh]h device_name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhj}ubh definition)}(hhh]h)}(hDevice to be opened.h]hDevice to be opened.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1j{hhhKhjxubj|)}(hX``flags`` Open flags. Access can either be ``O_RDWR`` or ``O_RDONLY``. Multiple opens are allowed with ``O_RDONLY``. In this mode, only query and read ioctls are allowed. Only one open is allowed in ``O_RDWR``. In this mode, all ioctls are allowed. When the ``O_NONBLOCK`` flag is given, the system calls may return ``EAGAIN`` error code when no data is available or when the device driver is temporarily busy. Other flags have no effect. h](j)}(h ``flags``h]j)}(hjh]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK+hjubj)}(hhh](h)}(hh]hopen()}(hj@hhhNhNubah}(h]h ](jj#c-funceh"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]refdocj refdomainj#reftypefunc refexplicitrefwarn c:parent_keysphinx.domains.c LookupKey)}data](j[ ASTIdentifier)} identifierDTVsbNjc)}jffesbNesbjopenuh1hhhhKIhj4ubhD returns the new file descriptor. On error, -1 is returned, and the }(hj4hhhNhNubj)}(h ``errno``h]herrno}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh variable is set appropriately.}(hj4hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKIhj#hhubh)}(hPossible error codes are:h]hPossible error codes are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhj#hhubh)}(h?On success 0 is returned, and :c:type:`ca_slot_info` is filled.h](hOn success 0 is returned, and }(hjhhhNhNubh)}(h:c:type:`ca_slot_info`h]j)}(hjh]h ca_slot_info}(hjhhhNhNubah}(h]h ](jj#c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainj#reftypetype refexplicitrefwarnjZj^j ca_slot_infouh1hhhhKNhjubh is filled.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKNhj#hhubh)}(hIOn error -1 is returned, and the ``errno`` variable is set appropriately.h](h!On error -1 is returned, and the }(hjhhhNhNubj)}(h ``errno``h]herrno}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh variable is set appropriately.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKPhj#hhubhtabular_col_spec)}(hhh]h}(h]h ]h"]h$]h&]spec|p{2.5cm}|p{15.0cm}|uh1jhhhKShj#hhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h ``EPERM``h]j)}(hj'h]hEPERM}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhhhKZhj"ubah}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh]h)}(h2The caller has no permission to access the device.h]h2The caller has no permission to access the device.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjBubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j!)}(hhh]h)}(h ``EBUSY``h]j)}(hjgh]hEBUSY}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1hhhhK]hjbubah}(h]h ]h"]h$]h&]uh1j hj_ubj!)}(hhh]h)}(h$The device driver is already in use.h]h$The device driver is already in use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjubah}(h]h ]h"]h$]h&]uh1j hj_ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j!)}(hhh]h)}(h ``EMFILE``h]j)}(hjh]hEMFILE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK`hjubah}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh]h)}(h9The process already has the maximum number of files open.h]h9The process already has the maximum number of files open.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j!)}(hhh]h)}(h ``ENFILE``h]j)}(hjh]hENFILE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKchjubah}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh]h)}(hKThe limit on the total number of files open on the system has been reached.h]hKThe limit on the total number of files open on the system has been reached.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhj#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 }(hj2hhhNhNubh)}(h':ref:`Generic Error Codes `h]j)}(hj<h]hGeneric Error Codes}(hj>hhhNhNubah}(h]h ](jstdstd-refeh"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]refdocj refdomainjHreftyperef refexplicitrefwarnj gen-errorsuh1hhhhKghj2ubh chapter.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKghj#hhubeh}(h] return-valueah ]h"] return valueah$]h&]uh1hhhhhhhhKGubeh}(h](digital-tv-frontend-openheh ]h"](digital tv frontend open()frontend_f_openeh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}jrhsexpect_referenced_by_id}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj footnote_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_handlerjerror_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}(jrhjqjnhhjbj_jjj jjijfu nametypes}(jrjqhjbjj jiuh}(hhjnhhhj_jj5j>jjejjjfj#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]h5Hyperlink target "frontend-f-open" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1juba transformerN include_log] decorationNhhub.