€•ž<Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œtranslations”Œ LanguagesNode”“”)”}”(hhh]”(hŒpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ4/translations/zh_CN/userspace-api/media/dvb/ca-fopen”Œmodname”NŒ classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ4/translations/zh_TW/userspace-api/media/dvb/ca-fopen”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ4/translations/it_IT/userspace-api/media/dvb/ca-fopen”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ4/translations/ja_JP/userspace-api/media/dvb/ca-fopen”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ4/translations/ko_KR/userspace-api/media/dvb/ca-fopen”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ4/translations/sp_SP/userspace-api/media/dvb/ca-fopen”Œmodname”NŒ classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later”h]”hŒ8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h¡hhhžhhŸŒN/var/lib/git/docbuild/linux/Documentation/userspace-api/media/dvb/ca-fopen.rst”h KubhŒtarget”“”)”}”(hŒ .. _ca_fopen:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œca-fopen”uh1h´h KhhhžhhŸh³ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒDigital TV CA open()”h]”hŒDigital TV CA open()”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒName”h]”hŒName”…””}”(hhÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhh×hžhhŸh³h KubhŒ paragraph”“”)”}”(hŒDigital TV CA open()”h]”hŒDigital TV CA open()”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K hh×hžhubeh}”(h]”Œname”ah ]”h"]”Œname”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒSynopsis”h]”hŒSynopsis”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjhžhhŸh³h KubhŒindex”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(Œsingle”ŒDTV.ca.open (C function)”Œ c.DTV.ca.open”hNt”auh1jhjhžhhŸNh NubhŒdesc”“”)”}”(hhh]”(hŒdesc_signature”“”)”}”(hŒ%int open(const char *name, int flags)”h]”hŒdesc_signature_line”“”)”}”(hŒ%int open(const char *name, int flags)”h]”(hŒdesc_sig_keyword_type”“”)”}”(hŒint”h]”hŒint”…””}”(hj5hžhhŸNh Nubah}”(h]”h ]”Œkt”ah"]”h$]”h&]”uh1j3hj/hžhhŸh³h KubhŒdesc_sig_space”“”)”}”(hŒ ”h]”hŒ ”…””}”(hjFhžhhŸNh Nubah}”(h]”h ]”Œw”ah"]”h$]”h&]”uh1jDhj/hžhhŸh³h KubhŒ desc_name”“”)”}”(hŒopen”h]”hŒ desc_sig_name”“”)”}”(hŒopen”h]”hŒopen”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”Œn”ah"]”h$]”h&]”uh1j[hjWubah}”(h]”h ]”(Œsig-name”Œdescname”eh"]”h$]”h&]”h±h²uh1jUhj/hžhhŸh³h KubhŒdesc_parameterlist”“”)”}”(hŒ(const char *name, int flags)”h]”(hŒdesc_parameter”“”)”}”(hŒconst char *name”h]”(hŒdesc_sig_keyword”“”)”}”(hŒconst”h]”hŒconst”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”Œk”ah"]”h$]”h&]”uh1j€hj|ubjE)”}”(hŒ ”h]”hŒ ”…””}”(hj‘hžhhŸNh Nubah}”(h]”h ]”jQah"]”h$]”h&]”uh1jDhj|ubj4)”}”(hŒchar”h]”hŒchar”…””}”(hjŸhžhhŸNh Nubah}”(h]”h ]”j@ah"]”h$]”h&]”uh1j3hj|ubjE)”}”(hŒ ”h]”hŒ ”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jQah"]”h$]”h&]”uh1jDhj|ubhŒdesc_sig_punctuation”“”)”}”(hŒ*”h]”hŒ*”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”Œp”ah"]”h$]”h&]”uh1j»hj|ubj\)”}”(hŒname”h]”hŒname”…””}”(hjÌhžhhŸNh Nubah}”(h]”h ]”jhah"]”h$]”h&]”uh1j[hj|ubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jzhjvubj{)”}”(hŒ int flags”h]”(j4)”}”(hŒint”h]”hŒint”…””}”(hjåhžhhŸNh Nubah}”(h]”h ]”j@ah"]”h$]”h&]”uh1j3hjáubjE)”}”(hŒ ”h]”hŒ ”…””}”(hjóhžhhŸNh Nubah}”(h]”h ]”jQah"]”h$]”h&]”uh1jDhjáubj\)”}”(hŒflags”h]”hŒflags”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”jhah"]”h$]”h&]”uh1j[hjáubeh}”(h]”h ]”h"]”h$]”h&]”Œnoemph”ˆh±h²uh1jzhjvubeh}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jthj/hžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”h±h²Œ add_permalink”ˆuh1j-Œsphinx_line_type”Œ declarator”hj)hžhhŸh³h Kubah}”(h]”j ah ]”(Œsig”Œ sig-object”eh"]”h$]”h&]”Œis_multiline”ˆŒ _toc_parts”)Œ _toc_name”huh1j'hŸh³h Khj$hžhubhŒdesc_content”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”uh1j0hj$hžhhŸh³h Kubeh}”(h]”h ]”(Œc”Œfunction”eh"]”h$]”h&]”Œdomain”j>Œobjtype”j?Œdesctype”j?Œnoindex”‰Œnoindexentry”‰Œnocontentsentry”‰uh1j"hžhhjhŸNh Nubeh}”(h]”Œsynopsis”ah ]”h"]”Œsynopsis”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Arguments”h]”hŒ Arguments”…””}”(hjThžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjQhžhhŸh³h KubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ0``name`` Name of specific Digital TV CA device. ”h]”(hŒterm”“”)”}”(hŒ``name``”h]”hŒliteral”“”)”}”(hjqh]”hŒname”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshjoubah}”(h]”h ]”h"]”h$]”h&]”uh1jmhŸh³h KhjiubhŒ definition”“”)”}”(hhh]”hé)”}”(hŒ&Name of specific Digital TV CA device.”h]”hŒ&Name of specific Digital TV CA device.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KhjŠubah}”(h]”h ]”h"]”h$]”h&]”uh1jˆhjiubeh}”(h]”h ]”h"]”h$]”h&]”uh1jghŸh³h Khjdubjh)”}”(hŒ0``flags`` A bit-wise OR of the following flags: ”h]”(jn)”}”(hŒ ``flags``”h]”jt)”}”(hjh]”hŒflags”…””}”(hj¯hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj«ubah}”(h]”h ]”h"]”h$]”h&]”uh1jmhŸh³h Khj§ubj‰)”}”(hhh]”hé)”}”(hŒ%A bit-wise OR of the following flags:”h]”hŒ%A bit-wise OR of the following flags:”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KhjÂubah}”(h]”h ]”h"]”h$]”h&]”uh1jˆhj§ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jghŸh³h Khjdhžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1jbhjQhžhhŸh³h NubhŒtabular_col_spec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œspec”Œ|p{2.5cm}|p{15.0cm}|”uh1jåhŸh³h KhjQhžhubhŒtable”“”)”}”(hhh]”hŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1jühjùubjý)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1jühjùubhŒtbody”“”)”}”(hhh]”(hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”hé)”}”(hŒ``O_RDONLY``”h]”jt)”}”(hj#h]”hŒO_RDONLY”…””}”(hj%hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj!ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K$hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubj)”}”(hhh]”hé)”}”(hŒread-only access”h]”hŒread-only access”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K%hj>ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjubj)”}”(hhh]”(j)”}”(hhh]”hé)”}”(hŒ ``O_RDWR``”h]”jt)”}”(hjch]”hŒO_RDWR”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshjaubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K'hj^ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj[ubj)”}”(hhh]”hé)”}”(hŒread/write access”h]”hŒread/write access”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K(hj~ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj[ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjubj)”}”(hhh]”(j)”}”(hhh]”hé)”}”(hŒ``O_NONBLOCK``”h]”jt)”}”(hj£h]”hŒ O_NONBLOCK”…””}”(hj¥hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj¡ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K*hjžubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj›ubj)”}”(hhh]”hé)”}”(hŒ8open in non-blocking mode (blocking mode is the default)”h]”hŒ8open in non-blocking mode (blocking mode is the default)”…””}”(hjÁhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K+hj¾ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj›ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhjùubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1j÷hjôubah}”(h]”h ]”h"]”h$]”h&]”uh1jòhjQhžhhŸNh Nubeh}”(h]”Œ arguments”ah ]”h"]”Œ arguments”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒDescription”h]”hŒDescription”…””}”(hjùhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjöhžhhŸh³h K/ubhé)”}”(hŒ]This system call opens a named ca device (e.g. ``/dev/dvb/adapter?/ca?``) for subsequent use.”h]”(hŒ/This system call opens a named ca device (e.g. ”…””}”(hjhžhhŸNh Nubjt)”}”(hŒ``/dev/dvb/adapter?/ca?``”h]”hŒ/dev/dvb/adapter?/ca?”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshjubhŒ) for subsequent use.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K1hjöhžhubhé)”}”(hX‡When an ``open()`` call has succeeded, the device will be ready for use. The significance of blocking or non-blocking mode is described in the documentation for functions where there is a difference. It does not affect the semantics of the ``open()`` call itself. A device opened in blocking mode can later be put into non-blocking mode (and vice versa) using the ``F_SETFL`` command of the ``fcntl`` system call. This is a standard system call, documented in the Linux manual page for fcntl. Only one user can open the CA Device in ``O_RDWR`` mode. All other attempts to open the device in this mode will fail, and an error code will be returned.”h]”(hŒWhen an ”…””}”(hj'hžhhŸNh Nubjt)”}”(hŒ ``open()``”h]”hŒopen()”…””}”(hj/hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj'ubhŒÞ call has succeeded, the device will be ready for use. The significance of blocking or non-blocking mode is described in the documentation for functions where there is a difference. It does not affect the semantics of the ”…””}”(hj'hžhhŸNh Nubjt)”}”(hŒ ``open()``”h]”hŒopen()”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj'ubhŒr call itself. A device opened in blocking mode can later be put into non-blocking mode (and vice versa) using the ”…””}”(hj'hžhhŸNh Nubjt)”}”(hŒ``F_SETFL``”h]”hŒF_SETFL”…””}”(hjShžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj'ubhŒ command of the ”…””}”(hj'hžhhŸNh Nubjt)”}”(hŒ ``fcntl``”h]”hŒfcntl”…””}”(hjehžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj'ubhŒ… system call. This is a standard system call, documented in the Linux manual page for fcntl. Only one user can open the CA Device in ”…””}”(hj'hžhhŸNh Nubjt)”}”(hŒ ``O_RDWR``”h]”hŒO_RDWR”…””}”(hjwhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj'ubhŒh mode. All other attempts to open the device in this mode will fail, and an error code will be returned.”…””}”(hj'hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K4hjöhžhubeh}”(h]”Œdescription”ah ]”h"]”Œdescription”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K/ubhÃ)”}”(hhh]”(hÈ)”}”(hŒReturn Value”h]”hŒReturn Value”…””}”(hjšhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj—hžhhŸh³h K@ubhé)”}”(hŒOn success 0 is returned.”h]”hŒOn success 0 is returned.”…””}”(hj¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KBhj—hžhubhé)”}”(hŒIOn error -1 is returned, and the ``errno`` variable is set appropriately.”h]”(hŒ!On error -1 is returned, and the ”…””}”(hj¶hžhhŸNh Nubjt)”}”(hŒ ``errno``”h]”hŒerrno”…””}”(hj¾hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jshj¶ubhŒ variable is set appropriately.”…””}”(hj¶hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KDhj—hžhubhé)”}”(hŒYGeneric error codes are described at the :ref:`Generic Error Codes ` chapter.”h]”(hŒ)Generic error codes are described at the ”…””}”(hjÖhžhhŸNh Nubh)”}”(hŒ':ref:`Generic Error Codes `”h]”hŒinline”“”)”}”(hjàh]”hŒGeneric Error Codes”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1jâhjÞubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ userspace-api/media/dvb/ca-fopen”Œ refdomain”jïŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ reftarget”Œ gen-errors”uh1hhŸh³h KGhjÖubhŒ chapter.”…””}”(hjÖhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KGhj—hžhubeh}”(h]”Œreturn-value”ah ]”h"]”Œreturn value”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K@ubeh}”(h]”(Œdigital-tv-ca-open”hÁeh ]”h"]”(Œdigital tv ca open()”Œca_fopen”eh$]”h&]”uh1hÂhhhžhhŸh³h KŒexpect_referenced_by_name”}”jh¶sŒexpect_referenced_by_id”}”hÁh¶subeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÇNŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”jŒfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jDŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”hÁ]”h¶asŒnameids”}”(jhÁjjhýhújNjKjójðj”j‘jjuŒ nametypes”}”(jˆj‰hý‰jN‰jó‰j”‰j‰uh}”(hÁhÄjhÄhúh×jKjj j)jðjQj‘jöjj—uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”hŒsystem_message”“”)”}”(hhh]”hé)”}”(hhh]”hŒ.Hyperlink target "ca-fopen" is not referenced.”…””}”hj®sbah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj«ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1j©ubaŒtransformer”NŒinclude_log”]”Œ decoration”Nhžhub.